Bagikan melalui

Log.WriteException Metode

  • Referensi

Definisi

Ruang nama:
Microsoft.VisualBasic.Logging
Rakitan:
Microsoft.VisualBasic.dll
Rakitan:
Microsoft.VisualBasic.Forms.dll

Menulis informasi pengecualian ke pendengar log aplikasi.

Overload

WriteException(Exception)

Menulis informasi pengecualian ke pendengar log aplikasi.
WriteException(Exception, TraceEventType, String)

Menulis informasi pengecualian ke pendengar log aplikasi.
WriteException(Exception, TraceEventType, String, Int32)

Menulis informasi pengecualian ke pendengar log aplikasi.

WriteException(Exception)

Menulis informasi pengecualian ke pendengar log aplikasi.

public:
 void WriteException(Exception ^ ex);
public void WriteException (Exception ex);
member this.WriteException : Exception -> unit
Public Sub WriteException (ex As Exception)

Parameter

ex
Exception

Wajib diisi. Pengecualian untuk mencatat.

Pengecualian

ArgumentNullException

exadalah Nothing.

SecurityException

Kode dengan kepercayaan parsial memanggil metode , tetapi menulis ke pendengar log peristiwa yang memerlukan kepercayaan penuh.

Contoh

Contoh ini menunjukkan cara menggunakan My.Application.Log.WriteException metode untuk mencatat pengecualian. Batalkan komentar pada baris Dim dan MsgBox untuk menyebabkan pengecualian NullReferenceException. Untuk informasi selengkapnya, lihat Cara: Pengecualian Log.

Public Sub ExceptionLogTest(ByVal fileName As String)
    Try
        ' Code that might generate an exception goes here.
        ' For example:
        '    Dim x As Object
        '    MsgBox(x.ToString)
    Catch ex As Exception
        My.Application.Log.WriteException(ex, 
            TraceEventType.Error, 
            "Exception in ExceptionLogTest " & 
            "with argument " & fileName & ".")
    End Try
End Sub

Contoh kode ini hanya dapat berjalan dalam aplikasi klien. Ubah My.Application.Log.WriteException ke My.Log.WriteException untuk aplikasi Web.

Keterangan

Metode menulis WriteException informasi yang terkandung dalam pengecualian untuk pendengar log peristiwa aplikasi.

Dalam aplikasi klien, Log objek tersedia melalui My.Application.Log objek . Dalam aplikasi Web, Log objek tersedia melalui My.Log objek .

Untuk mempelajari pendengar log mana yang menerima WriteException pesan metode, lihat Panduan: Menentukan Tempat My.Application.Log Menulis Informasi. Anda dapat mengubah pendengar log default. Untuk informasi selengkapnya, lihat Bekerja dengan Log Aplikasi.

Untuk kelebihan beban yang tidak mengambil id argumen, pengidentifikasi yang ditulis ke log ditentukan oleh tabel berikut.

severity Default id
Information 0
Warning 1
Error 2
Critical 3
Start 4
Stop 5
Suspend 6
Resume 7
Verbose 8
Transfer 9

Tabel berikut ini mencantumkan contoh tugas yang melibatkan WriteException metode .

Untuk Lihat
Tulis informasi pengecualian ke pendengar log peristiwa aplikasi. Cara: Mencatat Pengecualian
Menentukan di mana Log menulis informasi. Panduan: Menentukan Tempat My.Application.Log Menulis Informasi

Ketersediaan menurut Jenis Proyek

Jenis proyek Tersedia
Aplikasi Windows Ya
Pustaka Kelas Ya
Aplikasi Konsol Ya
Pustaka Kontrol Windows Ya
Pustaka Kontrol Web Tidak
Layanan Windows Ya
Situs Web Ya

Lihat juga

Berlaku untuk

WriteException(Exception, TraceEventType, String)

Menulis informasi pengecualian ke pendengar log aplikasi.

public:
 void WriteException(Exception ^ ex, System::Diagnostics::TraceEventType severity, System::String ^ additionalInfo);
public void WriteException (Exception ex, System.Diagnostics.TraceEventType severity, string additionalInfo);
member this.WriteException : Exception * System.Diagnostics.TraceEventType * string -> unit
Public Sub WriteException (ex As Exception, severity As TraceEventType, additionalInfo As String)

Parameter

ex
Exception

Wajib diisi. Pengecualian untuk mencatat.

severity
TraceEventType

Jenis pesan. Secara default, Error.

additionalInfo
String

String untuk ditambahkan ke pesan. Secara default, ini adalah string kosong.

Pengecualian

ArgumentNullException

exadalah Nothing.

InvalidEnumArgumentException

Jenis pesan bukan salah TraceEventType satu nilai enumerasi.

SecurityException

Kode dengan kepercayaan parsial memanggil metode , tetapi menulis ke pendengar log peristiwa yang memerlukan kepercayaan penuh.

Contoh

Contoh ini menunjukkan cara menggunakan My.Application.Log.WriteException metode untuk mencatat pengecualian. Batalkan komentar pada baris Dim dan MsgBox untuk menyebabkan pengecualian NullReferenceException. Untuk informasi selengkapnya, lihat Cara: Pengecualian Log.

Public Sub ExceptionLogTest(ByVal fileName As String)
    Try
        ' Code that might generate an exception goes here.
        ' For example:
        '    Dim x As Object
        '    MsgBox(x.ToString)
    Catch ex As Exception
        My.Application.Log.WriteException(ex, 
            TraceEventType.Error, 
            "Exception in ExceptionLogTest " & 
            "with argument " & fileName & ".")
    End Try
End Sub

Contoh kode ini hanya dapat berjalan dalam aplikasi klien. Ubah My.Application.Log.WriteException ke My.Log.WriteException untuk aplikasi Web.

Keterangan

Metode menulis WriteException informasi yang terkandung dalam pengecualian untuk pendengar log peristiwa aplikasi.

Dalam aplikasi klien, Log objek tersedia melalui My.Application.Log objek . Dalam aplikasi Web, Log objek tersedia melalui My.Log objek .

Untuk mempelajari pendengar log mana yang menerima WriteException pesan metode, lihat Panduan: Menentukan Tempat My.Application.Log Menulis Informasi. Anda dapat mengubah pendengar log default. Untuk informasi selengkapnya, lihat Bekerja dengan Log Aplikasi.

Untuk kelebihan beban yang tidak mengambil id argumen, pengidentifikasi yang ditulis ke log ditentukan oleh tabel berikut.

severity Default id
Information 0
Warning 1
Error 2
Critical 3
Start 4
Stop 5
Suspend 6
Resume 7
Verbose 8
Transfer 9

Tabel berikut ini mencantumkan contoh tugas yang melibatkan WriteException metode .

Untuk Lihat
Tulis informasi pengecualian ke pendengar log peristiwa aplikasi. Cara: Mencatat Pengecualian
Menentukan di mana Log menulis informasi. Panduan: Menentukan Tempat My.Application.Log Menulis Informasi

Ketersediaan menurut Jenis Proyek

Jenis proyek Tersedia
Aplikasi Windows Ya
Pustaka Kelas Ya
Aplikasi Konsol Ya
Pustaka Kontrol Windows Ya
Pustaka Kontrol Web Tidak
Layanan Windows Ya
Situs Web Ya

Lihat juga

Berlaku untuk

WriteException(Exception, TraceEventType, String, Int32)

Menulis informasi pengecualian ke pendengar log aplikasi.

public:
 void WriteException(Exception ^ ex, System::Diagnostics::TraceEventType severity, System::String ^ additionalInfo, int id);
public void WriteException (Exception ex, System.Diagnostics.TraceEventType severity, string additionalInfo, int id);
member this.WriteException : Exception * System.Diagnostics.TraceEventType * string * int -> unit
Public Sub WriteException (ex As Exception, severity As TraceEventType, additionalInfo As String, id As Integer)

Parameter

ex
Exception

Wajib diisi. Pengecualian untuk mencatat.

severity
TraceEventType

Jenis pesan. Secara default, Error.

additionalInfo
String

String untuk ditambahkan ke pesan. Secara default, ini adalah string kosong.

id
Int32

Pengidentifikasi pesan, biasanya digunakan untuk korelasi. Secara default, terkait dengan entryType seperti yang dijelaskan dalam tabel di bagian Keterangan.

Pengecualian

ArgumentNullException

exadalah Nothing.

InvalidEnumArgumentException

Jenis pesan bukan salah TraceEventType satu nilai enumerasi.

SecurityException

Kode dengan kepercayaan parsial memanggil metode , tetapi menulis ke pendengar log peristiwa yang memerlukan kepercayaan penuh.

Contoh

Contoh ini menunjukkan cara menggunakan My.Application.Log.WriteException metode untuk mencatat pengecualian. Batalkan komentar pada baris Dim dan MsgBox untuk menyebabkan pengecualian NullReferenceException. Untuk informasi selengkapnya, lihat Cara: Pengecualian Log.

Public Sub ExceptionLogTest(ByVal fileName As String)
    Try
        ' Code that might generate an exception goes here.
        ' For example:
        '    Dim x As Object
        '    MsgBox(x.ToString)
    Catch ex As Exception
        My.Application.Log.WriteException(ex, 
            TraceEventType.Error, 
            "Exception in ExceptionLogTest " & 
            "with argument " & fileName & ".")
    End Try
End Sub

Contoh kode ini hanya dapat berjalan dalam aplikasi klien. Ubah My.Application.Log.WriteException ke My.Log.WriteException untuk aplikasi Web.

Keterangan

Metode menulis WriteException informasi yang terkandung dalam pengecualian untuk pendengar log peristiwa aplikasi.

Dalam aplikasi klien, Log objek tersedia melalui My.Application.Log objek . Dalam aplikasi Web, Log objek tersedia melalui My.Log objek .

Untuk mempelajari pendengar log mana yang menerima WriteException pesan metode, lihat Panduan: Menentukan Tempat My.Application.Log Menulis Informasi. Anda dapat mengubah pendengar log default. Untuk informasi selengkapnya, lihat Bekerja dengan Log Aplikasi.

Untuk kelebihan beban yang tidak mengambil id argumen, pengidentifikasi yang ditulis ke log ditentukan oleh tabel berikut.

severity Default id
Information 0
Warning 1
Error 2
Critical 3
Start 4
Stop 5
Suspend 6
Resume 7
Verbose 8
Transfer 9

Tabel berikut ini mencantumkan contoh tugas yang melibatkan WriteException metode .

Untuk Lihat
Tulis informasi pengecualian ke pendengar log peristiwa aplikasi. Cara: Mencatat Pengecualian
Menentukan di mana Log menulis informasi. Panduan: Menentukan Tempat My.Application.Log Menulis Informasi

Ketersediaan menurut Jenis Proyek

Jenis proyek Tersedia
Aplikasi Windows Ya
Pustaka Kelas Ya
Aplikasi Konsol Ya
Pustaka Kontrol Windows Ya
Pustaka Kontrol Web Tidak
Layanan Windows Ya
Situs Web Ya

Lihat juga

Berlaku untuk