Win32Exception Klasse

Referenz

Definition

Namespace:: System.ComponentModel

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

Assembly:: Microsoft.Win32.Primitives.dll

Assembly:: System.dll

Assembly:: netstandard.dll

Quelle:: Win32Exception.cs

Quelle:: Win32Exception.cs

Quelle:: Win32Exception.cs

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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

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

Vererbung: Object

Exception
Win32Exception

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 Sie eine Win32-Ausnahme abfangen und deren Inhalt interpretieren. 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. Verwenden Sie 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

Win32Exception()	Initialisiert eine neue Instanz der Win32Exception-Klasse mit dem zuletzt aufgetretenen Win32-Fehler.
Win32Exception(Int32)	Initialisiert eine neue Instanz der Win32Exception-Klasse mit dem angegebenen Fehler.
Win32Exception(Int32, String)	Initialisiert eine neue Instanz der Win32Exception-Klasse mit dem angegebenen Fehler und der angegebenen detaillierten Beschreibung.
Win32Exception(SerializationInfo, StreamingContext)	Veraltet. Initialisiert eine neue Instanz der Win32Exception-Klasse mit dem angegebenen Kontext und den Serialisierungsinformationen.
Win32Exception(String)	Initialisiert eine neue Instanz der Win32Exception-Klasse unter Verwendung der angegebenen detaillierten Beschreibung.
Win32Exception(String, Exception)	Initialisiert eine neue Instanz der Win32Exception-Klasse mit der angegebenen ausführlichen Beschreibung und der angegebenen Ausnahme.

Eigenschaften

Data	Ruft eine Auflistung von Schlüssel-Wert-Paaren ab, die zusätzliche benutzerdefinierte Informationen zur Ausnahme bereitstellen. (Geerbt von Exception)
ErrorCode	Ruft das `HRESULT` des Fehlers ab. (Geerbt von ExternalException)
HelpLink	Ruft einen Link zur Hilfedatei ab, die dieser Ausnahme zugeordnet ist, oder legt einen Link fest. (Geerbt von Exception)
HResult	Ruft HRESULT ab oder legt HRESULT fest. Dies ist ein codierter Wert, der einer bestimmten Ausnahme zugeordnet ist. (Geerbt von Exception)
InnerException	Ruft die Exception-Instanz ab, die die aktuelle Ausnahme verursacht hat. (Geerbt von Exception)
Message	Ruft eine Meldung ab, mit der die aktuelle Ausnahme beschrieben wird. (Geerbt von Exception)
NativeErrorCode	Ruft den dieser Ausnahme zugeordneten Win32-Fehlercode ab.
Source	Gibt den Namen der Anwendung oder des Objekts zurück, die bzw. das den Fehler verursacht hat, oder legt diesen fest. (Geerbt von Exception)
StackTrace	Ruft eine Zeichenfolgendarstellung der unmittelbaren Frames in der Aufrufliste ab. (Geerbt von Exception)
TargetSite	Ruft die Methode ab, die die aktuelle Ausnahme auslöst. (Geerbt von Exception)

Methoden

Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
GetBaseException()	Gibt beim Überschreiben in einer abgeleiteten Klasse eine Exception zurück, die die Grundursache für eine oder mehrere nachfolgende Ausnahmen ist. (Geerbt von Exception)
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetObjectData(SerializationInfo, StreamingContext)	Veraltet. Legt das SerializationInfo-Objekt mit Dateiname und Zeilennummer fest, bei dem diese Win32Exception-Ausnahme auftrat.
GetObjectData(SerializationInfo, StreamingContext)	Veraltet. Legt beim Überschreiben in einer abgeleiteten Klasse die SerializationInfo mit Informationen über die Ausnahme fest. (Geerbt von Exception)
GetType()	Ruft den Laufzeittyp der aktuellen Instanz ab. (Geerbt von Exception)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
ToString()	Gibt eine Zeichenfolge zurück, die NativeErrorCode oder HResult oder beides enthält.
ToString()	Erstellt eine Zeichenfolgendarstellung der aktuellen Ausnahme und gibt diese zurück. (Geerbt von Exception)
ToString()	Gibt eine Zeichenfolge zurück, die das HRESULT des Fehlers enthält. (Geerbt von ExternalException)

Ereignisse

SerializeObjectState

Veraltet.

Tritt auf, wenn eine Ausnahme serialisiert wird, um ein Ausnahmezustandsobjekt mit serialisierten Daten über die Ausnahme zu erstellen.

(Geerbt von Exception)

Gilt für:

Freigeben über