Win32Exception Třída

Definice

Obor názvů:

System.ComponentModel

Sestavení:

Microsoft.Win32.Primitives.dll, netstandard.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 jeho 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 odpovídající 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 číselných reprezentací do systémové zprávy. Používá NativeErrorCode se pro přístup k číselné reprezentaci kódu chyby přidruženého k této výjimce. Další informace o kódech chyb naleznete v tématu Kódy chyb Win32.

Konstruktory

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

Vlastnosti

Name	Description
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á chybu. (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ódovanou číselnou hodnotu, 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ězcové znázornění 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

Name	Description
Equals(Object)	Určuje, zda je zadaný objekt roven aktuálnímu objektu. (Zděděno od Object)
GetBaseException()	Při přepsání v odvozené třídě vrátí Exception to, že je původní příčinou jedné nebo více následných výjimek. (Zděděno od Exception)
GetHashCode()	Slouží jako výchozí funkce hash. (Zděděno od Object)
GetObjectData(SerializationInfo, StreamingContext)	Zastaralé. SerializationInfo Nastaví objekt s názvem souboru a číslem řádku, ke kterému došloWin32Exception.
GetType()	Získá typ modulu runtime aktuální instance. (Zděděno od Exception)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Object. (Zděděno od Object)
ToString()	Vrátí řetězec, který obsahuje NativeErrorCodeřetězec , nebo HResultobojí.

Událost

Name	Description
SerializeObjectState	Zastaralé. Nastane, když je výjimka serializována vytvořit objekt stavu výjimky, který obsahuje serializovaná data o výjimce. (Zděděno od Exception)