Log.WriteException Metode

Definisi

Ruang nama:

Microsoft.VisualBasic.Logging

Rakitan:

Microsoft.VisualBasic.Forms.dll

Menulis informasi pengecualian ke pendengar log aplikasi.

Overload

Nama	Deskripsi
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)

Sumber:

Log.vb

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

Required. Pengecualian untuk log.

Pengecualian

ArgumentNullException

ex adalah 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 baris Dim dan MsgBox untuk menyebabkan NullReferenceException pengecualian. Untuk informasi selengkapnya, lihat Cara: Pengecualian Log.

Private Sub GetOpenFormTitles()
    Dim formTitles As New Collection

    Try
        For Each f As Form In My.Application.OpenForms
            If Not f.InvokeRequired Then
                ' Can access the form directly.
                formTitles.Add(f.Text)
            End If
        Next
    Catch ex As Exception
        formTitles.Add("Error: " & ex.Message)
    End Try

    Form1.ListBox1.DataSource = formTitles
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 ini WriteException menulis 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 Di Mana Informasi Penulisan My.Application.Log. 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	id default
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
Tentukan di mana Log menulis informasi.	Panduan: Menentukan Di mana My.Application.Log Menulis Informasi

Ketersediaan menurut Jenis Proyek

Jenis proyek	Available
Aplikasi Windows	Yes
Pustaka Kelas	Yes
Aplikasi Konsol	Yes
Pustaka Kontrol Windows	Yes
Perpustakaan Kontrol Situs Web	Tidak
Layanan Windows	Yes
Situs Web	Yes

Lihat juga

• Exception
• TraceEventType
• Objek (Visual Basic)
• Kerjakan dengan Log Aplikasi di Visual Basic
• Cara:Pengecualian Log di Visual Basic
• Panduan: Menentukan Di mana My.Application.Log Menulis Informasi

WriteException(Exception, TraceEventType, String)

Sumber:

Log.vb

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

Required. Pengecualian untuk log.

severity

TraceEventType

Jenis pesan. Secara bawaan, Error.

additionalInfo

String

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

Pengecualian

ArgumentNullException

ex adalah 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 baris Dim dan MsgBox untuk menyebabkan NullReferenceException pengecualian. Untuk informasi selengkapnya, lihat Cara: Pengecualian Log.

Private Sub GetOpenFormTitles()
    Dim formTitles As New Collection

    Try
        For Each f As Form In My.Application.OpenForms
            If Not f.InvokeRequired Then
                ' Can access the form directly.
                formTitles.Add(f.Text)
            End If
        Next
    Catch ex As Exception
        formTitles.Add("Error: " & ex.Message)
    End Try

    Form1.ListBox1.DataSource = formTitles
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 ini WriteException menulis 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 Di Mana Informasi Penulisan My.Application.Log. 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	id default
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
Tentukan di mana Log menulis informasi.	Panduan: Menentukan Di mana My.Application.Log Menulis Informasi

Ketersediaan menurut Jenis Proyek

Jenis proyek	Available
Aplikasi Windows	Yes
Pustaka Kelas	Yes
Aplikasi Konsol	Yes
Pustaka Kontrol Windows	Yes
Perpustakaan Kontrol Situs Web	Tidak
Layanan Windows	Yes
Situs Web	Yes

Lihat juga

• Exception
• TraceEventType
• Objek (Visual Basic)
• Kerjakan dengan Log Aplikasi di Visual Basic
• Cara:Pengecualian Log di Visual Basic
• Panduan: Menentukan Di mana My.Application.Log Menulis Informasi

WriteException(Exception, TraceEventType, String, Int32)

Sumber:

Log.vb

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

Required. Pengecualian untuk log.

severity

TraceEventType

Jenis pesan. Secara bawaan, 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

ex adalah 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 baris Dim dan MsgBox untuk menyebabkan NullReferenceException pengecualian. Untuk informasi selengkapnya, lihat Cara: Pengecualian Log.

Private Sub GetOpenFormTitles()
    Dim formTitles As New Collection

    Try
        For Each f As Form In My.Application.OpenForms
            If Not f.InvokeRequired Then
                ' Can access the form directly.
                formTitles.Add(f.Text)
            End If
        Next
    Catch ex As Exception
        formTitles.Add("Error: " & ex.Message)
    End Try

    Form1.ListBox1.DataSource = formTitles
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 ini WriteException menulis 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 Di Mana Informasi Penulisan My.Application.Log. 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	id default
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
Tentukan di mana Log menulis informasi.	Panduan: Menentukan Di mana My.Application.Log Menulis Informasi

Ketersediaan menurut Jenis Proyek

Jenis proyek	Available
Aplikasi Windows	Yes
Pustaka Kelas	Yes
Aplikasi Konsol	Yes
Pustaka Kontrol Windows	Yes
Perpustakaan Kontrol Situs Web	Tidak
Layanan Windows	Yes
Situs Web	Yes

Lihat juga

• Exception
• TraceEventType
• Objek (Visual Basic)
• Kerjakan dengan Log Aplikasi di Visual Basic
• Cara:Pengecualian Log di Visual Basic
• Panduan: Menentukan Di mana My.Application.Log Menulis Informasi