Win32Exception Klasa

Definicja

Przestrzeń nazw:

System.ComponentModel

Zestaw:

Microsoft.Win32.Primitives.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. Służy NativeErrorCode do uzyskiwania dostępu 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

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

Właściwości

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

Equals(Object)	Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object)
GetBaseException()	Po przesłonięciu 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 Objectelementu . (Odziedziczone po Object)
ToString()	Zwraca ciąg, który zawiera NativeErrorCodewartość , lub HResultoba .

Zdarzenia

SerializeObjectState

Przestarzałe. Występuje, gdy wyjątek jest serializowany w celu utworzenia obiektu stanu wyjątku, który zawiera serializowane dane dotyczące wyjątku. (Odziedziczone po Exception)