Win32Exception Třída

Definice

Obor názvů:

System.ComponentModel

Sestavení:

Microsoft.Win32.Primitives.dll

Zdroj:

Win32Exception.cs

Vyvolá výjimku pro kód chyby 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

Dědičnost

Object

Exception

SystemException

ExternalException

Win32Exception

Odvozené

System.Net.HttpListenerException

System.Net.NetworkInformation.NetworkInformationException

System.Net.Sockets.SocketException

System.Net.WebSockets.WebSocketException

Příklady

Následující příklad kódu ukazuje, jak zachytit výjimku Win32 a interpretovat její obsah. Příklad se pokusí spustit neexistující spustitelný soubor, což vede k výjimce Win32. Při zachycení výjimky načte příklad příslušnou chybovou zprávu, kód a původ výjimky.

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

Poznámky

Kódy chyb Win32 se při zobrazení překládají z jejich číselných reprezentací do systémové zprávy. Slouží NativeErrorCode k získání přístupu k číselné reprezentaci kódu chyby přidruženého k této výjimce. Další informace o kódech chyb najdete v tématu Kódy chyb Win32.

Konstruktory

Win32Exception()	Inicializuje novou instanci Win32Exception třídy s poslední chybou Win32, ke které došlo.
Win32Exception(Int32)	Inicializuje novou instanci Win32Exception třídy se zadanou chybou.
Win32Exception(Int32, String)	Inicializuje novou instanci Win32Exception třídy se zadanou chybou a zadaným podrobným popisem.
Win32Exception(SerializationInfo, StreamingContext)	Zastaralé. Inicializuje novou instanci Win32Exception třídy se zadaným kontextem a serializace informace.
Win32Exception(String)	Inicializuje novou instanci Win32Exception třídy se zadaným podrobným popisem.
Win32Exception(String, Exception)	Inicializuje novou instanci Win32Exception třídy se zadaným podrobným popisem a zadanou výjimkou.

Vlastnosti

Data	Získá kolekci párů klíč/hodnota, které poskytují další uživatelem definované informace o výjimce. (Zděděno od Exception)
ErrorCode	HRESULT Získá z chyby. (Zděděno od ExternalException)
HelpLink	Získá nebo nastaví odkaz na soubor nápovědy přidružený k této výjimce. (Zděděno od Exception)
HResult	Získá nebo nastaví HRESULT, kódovaná číselná hodnota, která je přiřazena ke konkrétní výjimce. (Zděděno od Exception)
InnerException	Exception Získá instanci, která způsobila aktuální výjimku. (Zděděno od Exception)
Message	Získá zprávu, která popisuje aktuální výjimku. (Zděděno od Exception)
NativeErrorCode	Získá kód chyby Win32 přidružené k této výjimce.
Source	Získá nebo nastaví název aplikace nebo objektu, který způsobuje chybu. (Zděděno od Exception)
StackTrace	Získá řetězcovou reprezentaci okamžitých rámců v zásobníku volání. (Zděděno od Exception)
TargetSite	Získá metodu, která vyvolá aktuální výjimku. (Zděděno od Exception)

Metody

Equals(Object)	Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object)
GetBaseException()	Při přepsání v odvozené třídě vrátí hodnotu Exception , která je původní příčinou jedné nebo více následných výjimek. (Zděděno od Exception)
GetHashCode()	Slouží jako výchozí hashovací funkce. (Zděděno od Object)
GetObjectData(SerializationInfo, StreamingContext)	Zastaralé. Nastaví objekt s SerializationInfo názvem souboru a číslem řádku, na kterém k tomu Win32Exception došlo.
GetType()	Získá typ modulu runtime aktuální instance. (Zděděno od Exception)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object)
ToString()	Vrátí řetězec, který obsahuje NativeErrorCode, nebo HResult, nebo obojí.

Událost

SerializeObjectState

Zastaralé. Nastane, když je výjimka serializována k vytvoření objektu stavu výjimky, který obsahuje serializovaná data o výjimce. (Zděděno od Exception)