Win32Exception Osztály

Definíció

Névtér:

System.ComponentModel

Szerelvények:

Microsoft.Win32.Primitives.dll, netstandard.dll

Forrás:

Win32Exception.cs

Kivételt jelez egy Win32-hibakód esetében.

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

Öröklődés

Object

Exception

SystemException

ExternalException

Win32Exception

Származtatott

System.Net.HttpListenerException

System.Net.NetworkInformation.NetworkInformationException

System.Net.Sockets.SocketException

System.Net.WebSockets.WebSocketException

Példák

Az alábbi példakód bemutatja, hogyan lehet elkapni egy Win32-kivételt, és értelmezni annak tartalmát. A példa megpróbál elindítani egy nem létező végrehajtható fájlt, amely Win32-kivételt eredményez. A kivétel észlelésekor a példa beolvassa a megfelelő hibaüzenetet, kódot és a kivétel forrását.

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

Megjegyzések

A Win32-hibakódok a numerikus ábrázolásukból rendszerüzenetté lesznek lefordítva, amikor megjelennek. A kivételhez társított hibakód numerikus ábrázolásának eléréséhez használható NativeErrorCode . A hibakódokkal kapcsolatos további információkért lásd a Win32 hibakódjait.

Konstruktorok

Name	Description
Win32Exception()	Inicializálja az Win32Exception osztály új példányát az utolsó Win32-hibával.
Win32Exception(Int32, String)	Inicializálja az Win32Exception osztály új példányát a megadott hibával és a megadott részletes leírással.
Win32Exception(Int32)	Inicializálja az osztály új példányát Win32Exception a megadott hibával.
Win32Exception(SerializationInfo, StreamingContext)	Elavult. Inicializálja az Win32Exception osztály új példányát a megadott környezettel és szerializálási információkkal.
Win32Exception(String, Exception)	Inicializálja az Win32Exception osztály új példányát a megadott részletes leírással és a megadott kivétellel.
Win32Exception(String)	Inicializálja az osztály új példányát Win32Exception a megadott részletes leírással.

Tulajdonságok

Name	Description
Data	Lekéri a kulcs-/érték párok gyűjteményét, amelyek további, felhasználó által definiált információkat biztosítanak a kivételről. (Öröklődés forrása Exception)
ErrorCode	Lekéri a HRESULT hibát. (Öröklődés forrása ExternalException)
HelpLink	Lekéri vagy beállítja a kivételhez társított súgófájlra mutató hivatkozást. (Öröklődés forrása Exception)
HResult	Lekéri vagy beállítja a HRESULT-ot, egy kódolt numerikus értéket, amely egy adott kivételhez van hozzárendelve. (Öröklődés forrása Exception)
InnerException	Lekéri az Exception aktuális kivételt okozó példányt. (Öröklődés forrása Exception)
Message	Az aktuális kivételt leíró üzenet jelenik meg. (Öröklődés forrása Exception)
NativeErrorCode	Lekéri a kivételhez társított Win32 hibakódot.
Source	Lekéri vagy beállítja az alkalmazás vagy a hibát okozó objektum nevét. (Öröklődés forrása Exception)
StackTrace	Lekéri a hívásverem közvetlen kereteinek sztringképét. (Öröklődés forrása Exception)
TargetSite	Lekéri az aktuális kivételt okozó metódust. (Öröklődés forrása Exception)

Metódusok

Name	Description
Equals(Object)	Meghatározza, hogy a megadott objektum egyenlő-e az aktuális objektummal. (Öröklődés forrása Object)
GetBaseException()	Ha egy származtatott osztály felül van bírálva, egy Exception vagy több későbbi kivétel kiváltó okát adja vissza. (Öröklődés forrása Exception)
GetHashCode()	Ez az alapértelmezett kivonatoló függvény. (Öröklődés forrása Object)
GetObjectData(SerializationInfo, StreamingContext)	Elavult. Beállítja az SerializationInfo objektumot a fájlnévvel és a sorszámmal, amelyen ez Win32Exception történt.
GetType()	Lekéri az aktuális példány futtatókörnyezeti típusát. (Öröklődés forrása Exception)
MemberwiseClone()	Az aktuális Objectpéldány sekély másolatát hozza létre. (Öröklődés forrása Object)
ToString()	Olyan sztringet ad vissza, amely tartalmazza az NativeErrorCode, vagy HResult, vagy mindkettőt.

esemény

Name	Description
SerializeObjectState	Elavult. Akkor fordul elő, ha a kivétel szerializálva van egy kivételállapot-objektum létrehozásához, amely szerializált adatokat tartalmaz a kivételről. (Öröklődés forrása Exception)