Win32Exception Klasse

Definition

Namespace:

System.ComponentModel

Assembly:

System.dll

Löst eine Ausnahme für einen Win32-Fehlercode aus.

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

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

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

Public Class Win32Exception
Inherits ExternalException

Vererbung

Object

Exception

SystemException

ExternalException

Win32Exception

Abgeleitet

System.Net.HttpListenerException

System.Net.NetworkInformation.NetworkInformationException

System.Net.Sockets.SocketException

System.Net.WebSockets.WebSocketException

Attribute

SerializableAttribute

Implementiert

ISerializable

Beispiele

Das folgende Codebeispiel zeigt, wie eine Win32-Ausnahme erfasst und deren Inhalt interpretiert wird. Im Beispiel wird versucht, eine nicht vorhandene ausführbare Datei zu starten, was zu einer Win32-Ausnahme führt. Beim Abfangen der Ausnahme ruft das Beispiel die entsprechende Fehlermeldung, den Code und den Ursprung der Ausnahme ab.

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

Hinweise

Win32-Fehlercodes werden aus ihren numerischen Darstellungen in eine Systemmeldung übersetzt, wenn sie angezeigt werden. Wird verwendet NativeErrorCode , um auf die numerische Darstellung des Fehlercodes zuzugreifen, der dieser Ausnahme zugeordnet ist. Weitere Informationen zu den Fehlercodes finden Sie unter Win32-Fehlercodes.

Konstruktoren

Name	Beschreibung
Win32Exception()	Initialisiert eine neue Instanz der Win32Exception Klasse mit dem letzten Win32-Fehler, der aufgetreten ist.
Win32Exception(Int32, String)	Initialisiert eine neue Instanz der Win32Exception Klasse mit dem angegebenen Fehler und der angegebenen detaillierten Beschreibung.
Win32Exception(Int32)	Initialisiert eine neue Instanz der Win32Exception Klasse mit dem angegebenen Fehler.
Win32Exception(SerializationInfo, StreamingContext)	Initialisiert eine neue Instanz der Win32Exception Klasse mit dem angegebenen Kontext und den Serialisierungsinformationen.
Win32Exception(String, Exception)	Initialisiert eine neue Instanz der Win32Exception Klasse mit der angegebenen detaillierten Beschreibung und der angegebenen Ausnahme.
Win32Exception(String)	Initialisiert eine neue Instanz der Win32Exception Klasse mit der angegebenen detaillierten Beschreibung.

Eigenschaften

Name	Beschreibung
Data	Ruft eine Auflistung von Schlüssel-Wert-Paaren ab, die zusätzliche benutzerdefinierte Informationen zur Ausnahme bereitstellen. (Geerbt von Exception)
ErrorCode	Ruft den HRESULT Fehler ab. (Geerbt von ExternalException)
HelpLink	Dient zum Abrufen oder Festlegen eines Links zur Hilfedatei, die dieser Ausnahme zugeordnet ist. (Geerbt von Exception)
HResult	Dient zum Abrufen oder Festlegen von HRESULT, einem codierten numerischen Wert, der einer bestimmten Ausnahme zugewiesen ist. (Geerbt von Exception)
InnerException	Ruft die Exception Instanz ab, die die aktuelle Ausnahme verursacht hat. (Geerbt von Exception)
Message	Ruft eine Nachricht ab, die die aktuelle Ausnahme beschreibt. (Geerbt von Exception)
NativeErrorCode	Ruft den Win32-Fehlercode ab, der dieser Ausnahme zugeordnet ist.
Source	Dient zum Abrufen oder Festlegen des Namens der Anwendung oder des Objekts, das den Fehler verursacht. (Geerbt von Exception)
StackTrace	Ruft eine Zeichenfolgendarstellung der unmittelbaren Frames im Aufrufstapel ab. (Geerbt von Exception)
TargetSite	Ruft die Methode ab, die die aktuelle Ausnahme auslöst. (Geerbt von Exception)

Methoden

Name	Beschreibung
Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
GetBaseException()	Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird die Exception Ursache einer oder mehrerer nachfolgenden Ausnahmen zurückgegeben. (Geerbt von Exception)
GetHashCode()	Dient als Standardhashfunktion. (Geerbt von Object)
GetObjectData(SerializationInfo, StreamingContext)	Legt das SerializationInfo Objekt mit dem Dateinamen und der Zeilennummer fest, an dem dies Win32Exception aufgetreten ist.
GetType()	Ruft den Laufzeittyp der aktuellen Instanz ab. (Geerbt von Exception)
MemberwiseClone()	Erstellt eine flache Kopie der aktuellen Object. (Geerbt von Object)
ToString()	Gibt eine Zeichenfolge zurück, die das HRESULT des Fehlers enthält. (Geerbt von ExternalException)

Ereignisse

Name	Beschreibung
SerializeObjectState	Tritt auf, wenn eine Ausnahme serialisiert wird, um ein Ausnahmestatusobjekt zu erstellen, das serialisierte Daten zu der Ausnahme enthält. (Geerbt von Exception)