Win32Exception Kelas

Definisi

Ruang nama:

System.ComponentModel

Rakitan:

Microsoft.Win32.Primitives.dll

Sumber:

Win32Exception.cs

Melempar pengecualian untuk kode kesalahan 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

Warisan

Object

Exception

SystemException

ExternalException

Win32Exception

Turunan

System.Net.HttpListenerException

System.Net.NetworkInformation.NetworkInformationException

System.Net.Sockets.SocketException

System.Net.WebSockets.WebSocketException

Contoh

Contoh kode berikut menunjukkan cara menangkap pengecualian Win32 dan menginterpretasikan kontennya. Contoh mencoba untuk memulai executable yang tidak ada, yang menghasilkan pengecualian Win32. Setelah menangkap pengecualian, contoh mengambil pesan kesalahan, kode, dan asal pengecualian masing-masing.

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

Keterangan

Kode kesalahan Win32 diterjemahkan dari representasi numeriknya ke dalam pesan sistem saat ditampilkan. Gunakan NativeErrorCode untuk mengakses representasi numerik dari kode kesalahan yang terkait dengan pengecualian ini. Untuk informasi selengkapnya tentang kode kesalahan, lihat Kode Kesalahan Win32.

Konstruktor

Win32Exception()	Menginisialisasi instans Win32Exception baru kelas dengan kesalahan Win32 terakhir yang terjadi.
Win32Exception(Int32)	Menginisialisasi instans Win32Exception baru kelas dengan kesalahan yang ditentukan.
Win32Exception(Int32, String)	Menginisialisasi instans Win32Exception baru kelas dengan kesalahan yang ditentukan dan deskripsi terperinci yang ditentukan.
Win32Exception(SerializationInfo, StreamingContext)	Kedaluwarsa. Menginisialisasi instans Win32Exception baru kelas dengan konteks yang ditentukan dan informasi serialisasi.
Win32Exception(String)	Menginisialisasi instans Win32Exception baru kelas dengan deskripsi terperinci yang ditentukan.
Win32Exception(String, Exception)	Menginisialisasi instans Win32Exception baru kelas dengan deskripsi terperinci yang ditentukan dan pengecualian yang ditentukan.

Properti

Data	Mendapatkan kumpulan pasangan kunci/nilai yang memberikan informasi tambahan yang ditentukan pengguna tentang pengecualian. (Diperoleh dari Exception)
ErrorCode	HRESULT Mendapatkan kesalahan. (Diperoleh dari ExternalException)
HelpLink	Mendapatkan atau mengatur tautan ke file bantuan yang terkait dengan pengecualian ini. (Diperoleh dari Exception)
HResult	Mendapatkan atau mengatur HRESULT, nilai numerik berkode yang ditetapkan ke pengecualian tertentu. (Diperoleh dari Exception)
InnerException	Mendapatkan instans Exception yang menyebabkan pengecualian saat ini. (Diperoleh dari Exception)
Message	Mendapatkan pesan yang menjelaskan pengecualian saat ini. (Diperoleh dari Exception)
NativeErrorCode	Mendapatkan kode kesalahan Win32 yang terkait dengan pengecualian ini.
Source	Get dan set nama aplikasi atau objek yang menyebabkan kesalahan. (Diperoleh dari Exception)
StackTrace	Mendapatkan representasi string dari bingkai langsung pada tumpukan panggilan. (Diperoleh dari Exception)
TargetSite	Mendapatkan metode yang melemparkan pengecualian saat ini. (Diperoleh dari Exception)

Metode

Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
GetBaseException()	Ketika ditimpa di kelas turunan Exception , mengembalikan yang merupakan akar penyebab dari satu atau beberapa pengecualian berikutnya. (Diperoleh dari Exception)
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetObjectData(SerializationInfo, StreamingContext)	Kedaluwarsa. Menyetel SerializationInfo objek dengan nama file dan nomor baris tempat ini Win32Exception terjadi.
GetType()	Mendapatkan jenis runtime dari instans saat ini. (Diperoleh dari Exception)
MemberwiseClone()	Membuat salinan dangkal dari saat ini Object. (Diperoleh dari Object)
ToString()	Mengembalikan string yang berisi NativeErrorCode, atau HResult, atau keduanya.

Acara

SerializeObjectState

Kedaluwarsa. Terjadi ketika pengecualian diserialisasikan untuk membuat objek status pengecualian yang berisi data berseri tentang pengecualian. (Diperoleh dari Exception)