Win32Exception Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Gera 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 exemplo de código a seguir mostra como capturar uma exceção do Win32 e interpretar seu conteúdo. O exemplo tenta iniciar um executável inexistente, o que resulta em uma exceção win32. Ao capturar a exceção, o exemplo busca a respectiva mensagem de erro, o código e a 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
Comentários
Os códigos de erro win32 são convertidos de suas representações numéricas em uma mensagem do sistema quando são exibidos. Use NativeErrorCode para acessar a representação numérica do código de erro associado a essa exceção. Para obter mais informações sobre os códigos de erro, consulte Códigos de Erro do Win32.
Construtores
| Nome | 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 as informações 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
| Nome | Description |
|---|---|
| Data |
Obtém uma coleção de pares chave/valor que fornecem informações adicionais definidas pelo usuário sobre a exceção. (Herdado de Exception) |
| ErrorCode |
Obtém o |
| HelpLink |
Obtém ou define um link para o arquivo de ajuda associado a essa exceção. (Herdado de Exception) |
| HResult |
Obtém 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 |
Obtém uma mensagem que descreve a exceção atual. (Herdado de Exception) |
| NativeErrorCode |
Obtém o código de erro Win32 associado a essa exceção. |
| Source |
Obtém ou define o nome do aplicativo ou do objeto que causa o erro. (Herdado de Exception) |
| StackTrace |
Obtém uma representação de cadeia de caracteres dos quadros imediatos na pilha de chamadas. (Herdado de Exception) |
| TargetSite |
Obtém o método que gera a exceção atual. (Herdado de Exception) |
Métodos
| Nome | Description |
|---|---|
| Equals(Object) |
Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object) |
| GetBaseException() |
Quando substituído em uma classe derivada, retorna a Exception causa raiz de uma ou mais exceções subsequentes. (Herdado de Exception) |
| GetHashCode() |
Serve como a função hash predefinida. (Herdado de Object) |
| GetObjectData(SerializationInfo, StreamingContext) |
Define o SerializationInfo objeto com o nome do arquivo e o número de linha no qual isso Win32Exception ocorreu. |
| GetType() |
Obtém o tipo de runtime da instância atual. (Herdado de Exception) |
| MemberwiseClone() |
Cria uma cópia superficial do Objectatual. (Herdado de Object) |
| ToString() |
Retorna uma cadeia de caracteres que contém o NativeErrorCode, ou HResult, ou ambos. |
| ToString() |
Cria e retorna uma representação de cadeia de caracteres da exceção atual. (Herdado de Exception) |
| ToString() |
Retorna uma cadeia de caracteres que contém o HRESULT do erro. (Herdado de ExternalException) |
Eventos
| Nome | 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) |