Win32Exception Classe

Referência

Definição

Namespace:: System.ComponentModel

Assemblies:: Microsoft.Win32.Primitives.dll, System.dll

Assembly:: Microsoft.Win32.Primitives.dll

Assembly:: System.dll

Assembly:: netstandard.dll

Origem:: Win32Exception.cs

Origem:: Win32Exception.cs

Origem:: Win32Exception.cs

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

public class Win32Exception : System.Runtime.InteropServices.ExternalException

[System.Serializable]
public class Win32Exception : System.Runtime.InteropServices.ExternalException

type Win32Exception = class
    inherit Exception

type Win32Exception = class
    inherit ExternalException
    interface ISerializable

type Win32Exception = class
    inherit ExternalException

[<System.Serializable>]
type Win32Exception = class
    inherit ExternalException
    interface ISerializable

Public Class Win32Exception
Inherits Exception

Public Class Win32Exception
Inherits ExternalException

Herança: Object

Exception
Win32Exception

Herança: Object

Exception

SystemException

ExternalException
Win32Exception

Derivado: System.Net.HttpListenerException

System.Net.NetworkInformation.NetworkInformationException

System.Net.Sockets.SocketException

System.Net.WebSockets.WebSocketException

Atributos: SerializableAttribute

Implementações: ISerializable

Exemplos

O exemplo de código a seguir mostra como capturar uma exceção 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

Win32Exception()	Inicializa uma nova instância da classe Win32Exception com o último erro Win32 que ocorreu.
Win32Exception(Int32)	Inicializa uma nova instância da classe Win32Exception com o erro especificado.
Win32Exception(Int32, String)	Inicializa uma nova instância da classe Win32Exception com o erro especificado e a descrição detalhada especificada.
Win32Exception(SerializationInfo, StreamingContext)	Obsoleto. Inicializa uma nova instância da classe Win32Exception com o contexto e as informações de serialização especificados.
Win32Exception(String)	Inicializa uma nova instância da classe Win32Exception com a descrição detalhada especificada.
Win32Exception(String, Exception)	Inicializa uma nova instância da classe Win32Exception com a descrição detalhada e a exceção especificadas.

Propriedades

Data	Obtém uma coleção de pares de chave/valor que fornecem informações definidas pelo usuário adicionais sobre a exceção. (Herdado de Exception)
ErrorCode	Obtém o `HRESULT` do erro. (Herdado de ExternalException)
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 que é atribuído a uma exceção específica. (Herdado de Exception)
InnerException	Obtém a instância Exception 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 objeto que causa o erro. (Herdado de Exception)
StackTrace	Obtém uma representação de cadeia de caracteres de quadros imediatos na pilha de chamadas. (Herdado de Exception)
TargetSite	Obtém o método que gerou a exceção atual. (Herdado de Exception)

Métodos

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 que é a causa raiz de uma ou mais exceções subsequentes. (Herdado de Exception)
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetObjectData(SerializationInfo, StreamingContext)	Obsoleto. Define o objeto SerializationInfo com o nome do arquivo e número de linha em que essa Win32Exception ocorreu.
GetObjectData(SerializationInfo, StreamingContext)	Obsoleto. Quando substituído em uma classe derivada, define o SerializationInfo com informações sobre a exceção. (Herdado de Exception)
GetType()	Obtém o tipo de runtime da instância atual. (Herdado de Exception)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
ToString()	Retorna uma cadeia de caracteres que contém 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

SerializeObjectState

Obsoleto.

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)

Aplica-se a

Compartilhar via