Win32Exception Classe
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Lança uma exceção para um código de erro Win32.
public ref class Win32Exception : Exception
public ref class Win32Exception : System::Runtime::InteropServices::ExternalException
public class Win32Exception : Exception
[System.Serializable]
public class Win32Exception : System.Runtime.InteropServices.ExternalException
public class Win32Exception : System.Runtime.InteropServices.ExternalException
type Win32Exception = class
inherit Exception
[<System.Serializable>]
type Win32Exception = class
inherit ExternalException
interface ISerializable
type Win32Exception = class
inherit ExternalException
interface ISerializable
Public Class Win32Exception
Inherits Exception
Public Class Win32Exception
Inherits ExternalException
- Herança
- Herança
- Derivado
- Atributos
- Implementações
Exemplos
O seguinte exemplo de código mostra como detetar uma exceção Win32 e interpretar o seu conteúdo. O exemplo tenta iniciar um executável inexistente, o que resulta numa exceção Win32. Ao detetar a exceção, o exemplo obtém a respetiva mensagem de erro, código e origem da exceção.
try
{
System::Diagnostics::Process^ myProc = gcnew System::Diagnostics::Process;
//Attempting to start a non-existing executable
myProc->StartInfo->FileName = "c:\nonexist.exe";
//Start the application and assign it to the process component.
myProc->Start();
}
catch ( Win32Exception^ w )
{
Console::WriteLine( w->Message );
Console::WriteLine( w->ErrorCode );
Console::WriteLine( w->NativeErrorCode );
Console::WriteLine( w->StackTrace );
Console::WriteLine( w->Source );
Exception^ e = w->GetBaseException();
Console::WriteLine( e->Message );
}
try
{
System.Diagnostics.Process myProc = new();
myProc.StartInfo.FileName = @"c:\nonexist.exe"; // Attempt to start a non-existent executable
_ = myProc.Start();
}
catch (Win32Exception w)
{
Console.WriteLine(w.Message);
Console.WriteLine(w.ErrorCode.ToString());
Console.WriteLine(w.NativeErrorCode.ToString());
Console.WriteLine(w.StackTrace);
Console.WriteLine(w.Source);
Exception e = w.GetBaseException();
Console.WriteLine(e.Message);
}
Try
Dim myProc As New System.Diagnostics.Process()
myProc.StartInfo.FileName = "c:\nonexist.exe" 'Attempting to start a non-existing executable
myProc.Start() 'Start the application and assign it to the process component.
Catch w As System.ComponentModel.Win32Exception
Console.WriteLine(w.Message)
Console.WriteLine(w.ErrorCode.ToString())
Console.WriteLine(w.NativeErrorCode.ToString())
Console.WriteLine(w.StackTrace)
Console.WriteLine(w.Source)
Dim e As New Exception()
e = w.GetBaseException()
Console.WriteLine(e.Message)
End Try
Observações
Os códigos de erro Win32 são traduzidos das suas representações numéricas para uma mensagem de sistema quando são exibidos. Use NativeErrorCode para aceder à representação numérica do código de erro associado a esta exceção. Para mais informações sobre os códigos de erro, consulte Códigos de Erro Win32.
Construtores
| Name | Description |
|---|---|
| Win32Exception() |
Inicializa uma nova instância da Win32Exception classe com o último erro Win32 que ocorreu. |
| Win32Exception(Int32, String) |
Inicializa uma nova instância da Win32Exception classe com o erro especificado e a descrição detalhada especificada. |
| Win32Exception(Int32) |
Inicializa uma nova instância da Win32Exception classe com o erro especificado. |
| Win32Exception(SerializationInfo, StreamingContext) |
Inicializa uma nova instância da Win32Exception classe com o contexto especificado e a informação de serialização. |
| Win32Exception(String, Exception) |
Inicializa uma nova instância da Win32Exception classe com a descrição detalhada especificada e a exceção especificada. |
| Win32Exception(String) |
Inicializa uma nova instância da Win32Exception classe com a descrição detalhada especificada. |
Propriedades
| Name | Description |
|---|---|
| Data |
Obtém uma coleção de pares chave/valor que fornecem informação adicional definida pelo utilizador sobre a exceção. (Herdado de Exception) |
| ErrorCode |
Obtém o |
| HelpLink |
Obtém ou define um link para o ficheiro de ajuda associado a esta exceção. (Herdado de Exception) |
| HResult |
Recebe ou define HRESULT, um valor numérico codificado atribuído a uma exceção específica. (Herdado de Exception) |
| InnerException |
Obtém a Exception instância que causou a exceção atual. (Herdado de Exception) |
| Message |
Recebe uma mensagem que descreve a exceção atual. (Herdado de Exception) |
| NativeErrorCode |
Recebe o código de erro Win32 associado a esta exceção. |
| Source |
Obtém ou define o nome do aplicativo ou o objeto que causa o erro. (Herdado de Exception) |
| StackTrace |
Obtém uma representação string dos frames imediatos na stack de chamadas. (Herdado de Exception) |
| TargetSite |
Obtém o método que lança a exceção atual. (Herdado de Exception) |
Métodos
| Name | Description |
|---|---|
| Equals(Object) |
Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object) |
| GetBaseException() |
Quando sobrescrito numa classe derivada, devolve o Exception que é a causa raiz de uma ou mais exceções subsequentes. (Herdado de Exception) |
| GetHashCode() |
Serve como função de hash predefinida. (Herdado de Object) |
| GetObjectData(SerializationInfo, StreamingContext) |
Define o SerializationInfo objeto com o nome do ficheiro e o número de linha onde isto Win32Exception ocorreu. |
| GetType() |
Obtém o tipo de execução da instância atual. (Herdado de Exception) |
| MemberwiseClone() |
Cria uma cópia superficial do atual Object. (Herdado de Object) |
| ToString() |
Devolve uma cadeia que contém o NativeErrorCode, ou HResult, ou ambos. |
| ToString() |
Cria e devolve uma representação string da exceção atual. (Herdado de Exception) |
| ToString() |
Devolve uma string que contém o HRESULT do erro. (Herdado de ExternalException) |
evento
| Name | Description |
|---|---|
| SerializeObjectState |
Ocorre quando uma exceção é serializada para criar um objeto de estado de exceção que contém dados serializados sobre a exceção. (Herdado de Exception) |