Win32Exception Klasa

Definicja

Przestrzeń nazw:

System.ComponentModel

Zestawy:

Microsoft.Win32.Primitives.dll, netstandard.dll

Źródło:

Win32Exception.cs

Zgłasza wyjątek dla kodu błędu 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

Dziedziczenie

Object

Exception

SystemException

ExternalException

Win32Exception

Pochodne

System.Net.HttpListenerException

System.Net.NetworkInformation.NetworkInformationException

System.Net.Sockets.SocketException

System.Net.WebSockets.WebSocketException

Przykłady

Poniższy przykład kodu pokazuje, jak przechwycić wyjątek Win32 i interpretować jego zawartość. Przykład próbuje uruchomić nieistniejący plik wykonywalny, co powoduje wyjątek Win32. Po przechwyceniu wyjątku przykład pobiera odpowiedni komunikat o błędzie, kod i źródło wyjątku.

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

Uwagi

Kody błędów Win32 są tłumaczone z ich reprezentacji liczbowych na komunikat systemowy po ich wyświetleniu. Użyj polecenia NativeErrorCode , aby uzyskać dostęp do liczbowej reprezentacji kodu błędu skojarzonego z tym wyjątkiem. Aby uzyskać więcej informacji na temat kodów błędów, zobacz Kody błędów Win32.

Konstruktory

Nazwa	Opis
Win32Exception()	Inicjuje nowe wystąpienie Win32Exception klasy z ostatnim błędem Win32, który wystąpił.
Win32Exception(Int32, String)	Inicjuje nowe wystąpienie Win32Exception klasy z określonym błędem i określonym szczegółowym opisem.
Win32Exception(Int32)	Inicjuje nowe wystąpienie Win32Exception klasy z określonym błędem.
Win32Exception(SerializationInfo, StreamingContext)	Przestarzałe. Inicjuje nowe wystąpienie Win32Exception klasy z określonym kontekstem i informacjami o serializacji.
Win32Exception(String, Exception)	Inicjuje nowe wystąpienie Win32Exception klasy z określonym szczegółowym opisem i określonym wyjątkiem.
Win32Exception(String)	Inicjuje nowe wystąpienie Win32Exception klasy z określonym szczegółowym opisem.

Właściwości

Nazwa	Opis
Data	Pobiera kolekcję par klucz/wartość, które zapewniają dodatkowe informacje zdefiniowane przez użytkownika dotyczące wyjątku. (Odziedziczone po Exception)
ErrorCode	HRESULT Pobiera błąd. (Odziedziczone po ExternalException)
HelpLink	Pobiera lub ustawia link do pliku pomocy skojarzonego z tym wyjątkiem. (Odziedziczone po Exception)
HResult	Pobiera lub ustawia HRESULT, zakodowaną wartość liczbową przypisaną do określonego wyjątku. (Odziedziczone po Exception)
InnerException	Exception Pobiera wystąpienie, które spowodowało bieżący wyjątek. (Odziedziczone po Exception)
Message	Pobiera komunikat opisujący bieżący wyjątek. (Odziedziczone po Exception)
NativeErrorCode	Pobiera kod błędu Win32 skojarzony z tym wyjątkiem.
Source	Pobiera lub ustawia nazwę aplikacji lub obiektu, który powoduje błąd. (Odziedziczone po Exception)
StackTrace	Pobiera reprezentację ciągu natychmiastowych ramek na stosie wywołań. (Odziedziczone po Exception)
TargetSite	Pobiera metodę, która zgłasza bieżący wyjątek. (Odziedziczone po Exception)

Metody

Nazwa	Opis
Equals(Object)	Określa, czy określony obiekt jest równy bieżącemu obiektowi. (Odziedziczone po Object)
GetBaseException()	Po zastąpieniu w klasie pochodnej funkcja zwraca Exception główną przyczynę co najmniej jednego kolejnego wyjątku. (Odziedziczone po Exception)
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetObjectData(SerializationInfo, StreamingContext)	Przestarzałe. SerializationInfo Ustawia obiekt z nazwą pliku i numerem wiersza, w którym to Win32Exception miało miejsce.
GetType()	Pobiera typ środowiska uruchomieniowego bieżącego wystąpienia. (Odziedziczone po Exception)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Object. (Odziedziczone po Object)
ToString()	Zwraca ciąg zawierający NativeErrorCodeciąg , lub HResult, lub oba.

Zdarzenia

Nazwa	Opis
SerializeObjectState	Przestarzałe. Występuje, gdy wyjątek jest serializowany w celu utworzenia obiektu stanu wyjątku zawierającego serializowane dane dotyczące wyjątku. (Odziedziczone po Exception)