Win32Exception Classe

Definizione

Spazio dei nomi:

System.ComponentModel

Assembly:

Microsoft.Win32.Primitives.dll

Origine:

Win32Exception.cs

Genera un'eccezione per un codice di errore Win32.

public ref class Win32Exception : System::Runtime::InteropServices::ExternalException

public class Win32Exception : System.Runtime.InteropServices.ExternalException

type Win32Exception = class
    inherit ExternalException

Public Class Win32Exception
Inherits ExternalException

Ereditarietà

Object

Exception

SystemException

ExternalException

Win32Exception

Derivato

System.Net.HttpListenerException

System.Net.NetworkInformation.NetworkInformationException

System.Net.Sockets.SocketException

System.Net.WebSockets.WebSocketException

Esempio

L'esempio di codice seguente illustra come intercettare un'eccezione Win32 e interpretarne il contenuto. L'esempio tenta di avviare un eseguibile inesistente, che genera un'eccezione Win32. Dopo aver intercettato l'eccezione, nell'esempio viene recuperato il rispettivo messaggio di errore, il codice e l'origine dell'eccezione.

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

Commenti

Quando vengono visualizzati, i codici di errore Win32 vengono convertiti dalle relative rappresentazioni numeriche in un messaggio di sistema. Utilizzare NativeErrorCode per accedere alla rappresentazione numerica del codice di errore associato a questa eccezione. Per altre informazioni sui codici di errore, vedere Codici errore Win32.

Costruttori

Win32Exception()	Inizializza una nuova istanza della classe Win32Exception con l'ultimo errore Win32 che si è verificato.
Win32Exception(Int32)	Inizializza una nuova istanza della classe Win32Exception con l'errore specificato.
Win32Exception(Int32, String)	Inizializza una nuova istanza della classe Win32Exception con il codice di errore e la descrizione specificati.
Win32Exception(SerializationInfo, StreamingContext)	Obsoleti. Inizializza una nuova istanza della classe Win32Exception con le informazioni di serializzazione e con il contesto specificato.
Win32Exception(String)	Inizializza una nuova istanza della classe Win32Exception con la descrizione dettagliata specificata.
Win32Exception(String, Exception)	Inizializza una nuova istanza della classe Win32Exception con la descrizione dettagliata e l'eccezione specificate.

Proprietà

Data	Ottiene una raccolta di coppie chiave/valore che forniscono informazioni definite dall'utente aggiuntive sull'eccezione. (Ereditato da Exception)
ErrorCode	Ottiene l'oggetto HRESULT dell'errore. (Ereditato da ExternalException)
HelpLink	Ottiene o imposta un collegamento al file della Guida associato all'eccezione. (Ereditato da Exception)
HResult	Ottiene o imposta HRESULT, un valore numerico codificato che viene assegnato a un'eccezione specifica. (Ereditato da Exception)
InnerException	Ottiene l'istanza di Exception che ha causato l'eccezione corrente. (Ereditato da Exception)
Message	Ottiene un messaggio che descrive l'eccezione corrente. (Ereditato da Exception)
NativeErrorCode	Ottiene il codice di errore Win32 associato a questa eccezione.
Source	Ottiene o imposta il nome dell'oggetto o dell'applicazione che ha generato l'errore. (Ereditato da Exception)
StackTrace	Ottiene una rappresentazione di stringa dei frame immediati nello stack di chiamate. (Ereditato da Exception)
TargetSite	Ottiene il metodo che genera l'eccezione corrente. (Ereditato da Exception)

Metodi

Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
GetBaseException()	Quando ne viene eseguito l'override in una classe derivata, restituisce l'Exception che è la causa radice di una o più eccezioni successive. (Ereditato da Exception)
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetObjectData(SerializationInfo, StreamingContext)	Obsoleti. Imposta l'oggetto SerializationInfo con il nome file e il numero di riga in cui si è verificata questa eccezione Win32Exception.
GetType()	Ottiene il tipo di runtime dell'istanza corrente. (Ereditato da Exception)
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
ToString()	Restituisce una stringa che contiene NativeErrorCode, HResult o entrambi gli oggetti.

Eventi

SerializeObjectState

Obsoleti. Si verifica quando un'eccezione viene serializzata per creare un oggetto di stato eccezione contenente i dati serializzati relativi all'eccezione. (Ereditato da Exception)