Win32Exception Klasa

Odwołanie

Definicja

Przestrzeń nazw:: System.ComponentModel

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

Zestaw:: Microsoft.Win32.Primitives.dll

Zestaw:: System.dll

Zestaw:: netstandard.dll

Źródło:: Win32Exception.cs

Źródło:: Win32Exception.cs

Źródło:: Win32Exception.cs

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Zgłasza wyjątek dla kodu błędu Win32.

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

Dziedziczenie: Object

Exception
Win32Exception

Dziedziczenie: Object

Exception

SystemException

ExternalException
Win32Exception

Pochodne: System.Net.HttpListenerException

System.Net.NetworkInformation.NetworkInformationException

System.Net.Sockets.SocketException

System.Net.WebSockets.WebSocketException

Atrybuty: SerializableAttribute

Implementuje: ISerializable

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.
GetObjectData(SerializationInfo, StreamingContext)	Przestarzałe. Po zastąpieniu w klasie pochodnej ustawia SerializationInfo element z informacjami o wyjątku. (Odziedziczone po Exception)
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 .
ToString()	Tworzy i zwraca reprezentację ciągu bieżącego wyjątku. (Odziedziczone po Exception)
ToString()	Zwraca ciąg zawierający wartość HRESULT błędu. (Odziedziczone po ExternalException)

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)

Dotyczy

Produkt	Wersje
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.3, 1.4, 1.6, 2.0, 2.1
UWP	10.0

Udostępnij za pośrednictwem