Log.WriteException 方法

定義

命名空間:: Microsoft.VisualBasic.Logging

組件:: Microsoft.VisualBasic.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

將例外資訊寫入應用程式的日誌監聽器。

多載

名稱	Description
WriteException(Exception)	將例外資訊寫入應用程式的日誌監聽器。
WriteException(Exception, TraceEventType, String)	將例外資訊寫入應用程式的日誌監聽器。
WriteException(Exception, TraceEventType, String, Int32)	將例外資訊寫入應用程式的日誌監聽器。

WriteException(Exception)

將例外資訊寫入應用程式的日誌監聽器。

public:
 void WriteException(Exception ^ ex);

public void WriteException(Exception ex);

member this.WriteException : Exception -> unit

Public Sub WriteException (ex As Exception)

參數

ex: Exception

必須的。對日誌有例外。

例外狀況

ArgumentNullException

ex 是 Nothing。

SecurityException

部分信任的程式碼呼叫該方法，但寫入事件日誌監聽器時需要完全信任。

範例

這個範例展示了如何使用該 My.Application.Log.WriteException 方法來記錄異常。取消註解 Dim and MsgBox 行以觸發 NullReferenceException 例外。欲了解更多資訊，請參閱「如何記錄例外」。

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

此程式碼範例只能在用戶端應用程式中執行。改 My.Application.Log.WriteException 成 My.Log.WriteException for for Web 應用程式。

備註

此 WriteException 方法會將例外中包含的資訊寫入應用程式的事件日誌監聽器。

在用戶端應用程式中， Log 物件是透過物件 My.Application.Log 取得的。在網頁應用程式中， Log 物件是透過物件 My.Log 來取得的。

要了解哪些日誌監聽器接收該 WriteException 方法的訊息，請參閱「攻略：確定 My.Application.Log 在哪裡寫入資訊」。你可以更改預設的日誌監聽器。欲了解更多資訊，請參閱「應用日誌操作」。

對於不接受參數的 id 超載，寫入日誌的識別碼由以下表格定義。

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

下表列出與此 WriteException 方法相關的任務範例。

至	看！
將例外資訊寫入應用程式的事件日誌監聽器。	如何：記錄例外狀況
確定資訊的寫入地點 `Log` 。	操作指南：判斷 My.Application.Log 寫入資訊的位置

依專案類型提供可用性

專案類型	Available
Windows 應用程式	Yes
類別庫	Yes
主控台應用程式	Yes
Windows 控件庫	Yes
Web 控制庫	No
Windows 服務	Yes
網站	Yes

另請參閱

適用於

WriteException(Exception, TraceEventType, String)

將例外資訊寫入應用程式的日誌監聽器。

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)

參數

ex: Exception

必須的。對日誌有例外。

severity: TraceEventType

訊息類型。根據預設，Error。

additionalInfo: String

字串要附加到訊息後面。預設情況下，這是空字串。

例外狀況

ArgumentNullException

ex 是 Nothing。

InvalidEnumArgumentException

訊息類型並非 TraceEventType 列舉值之一。

SecurityException

部分信任的程式碼呼叫該方法，但寫入事件日誌監聽器時需要完全信任。

範例

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

此程式碼範例只能在用戶端應用程式中執行。改 My.Application.Log.WriteException 成 My.Log.WriteException for for Web 應用程式。

備註

此 WriteException 方法會將例外中包含的資訊寫入應用程式的事件日誌監聽器。

在用戶端應用程式中， Log 物件是透過物件 My.Application.Log 取得的。在網頁應用程式中， Log 物件是透過物件 My.Log 來取得的。

對於不接受參數的 id 超載，寫入日誌的識別碼由以下表格定義。

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

下表列出與此 WriteException 方法相關的任務範例。

至	看！
將例外資訊寫入應用程式的事件日誌監聽器。	如何：記錄例外狀況
確定資訊的寫入地點 `Log` 。	操作指南：判斷 My.Application.Log 寫入資訊的位置

依專案類型提供可用性

專案類型	Available
Windows 應用程式	Yes
類別庫	Yes
主控台應用程式	Yes
Windows 控件庫	Yes
Web 控制庫	No
Windows 服務	Yes
網站	Yes

另請參閱

適用於

WriteException(Exception, TraceEventType, String, Int32)

將例外資訊寫入應用程式的日誌監聽器。

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)

參數

ex: Exception

必須的。對日誌有例外。

severity: TraceEventType

訊息類型。根據預設，Error。

additionalInfo: String

字串要附加到訊息後面。預設情況下，這是空字串。

id: Int32

訊息識別碼，通常用於相關性。預設，與 entryType 備註區表格中所述相關。

例外狀況

ArgumentNullException

ex 是 Nothing。

InvalidEnumArgumentException

訊息類型並非 TraceEventType 列舉值之一。

SecurityException

部分信任的程式碼呼叫該方法，但寫入事件日誌監聽器時需要完全信任。

範例

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

此程式碼範例只能在用戶端應用程式中執行。改 My.Application.Log.WriteException 成 My.Log.WriteException for for Web 應用程式。

備註

此 WriteException 方法會將例外中包含的資訊寫入應用程式的事件日誌監聽器。

在用戶端應用程式中， Log 物件是透過物件 My.Application.Log 取得的。在網頁應用程式中， Log 物件是透過物件 My.Log 來取得的。

對於不接受參數的 id 超載，寫入日誌的識別碼由以下表格定義。

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

下表列出與此 WriteException 方法相關的任務範例。

至	看！
將例外資訊寫入應用程式的事件日誌監聽器。	如何：記錄例外狀況
確定資訊的寫入地點 `Log` 。	操作指南：判斷 My.Application.Log 寫入資訊的位置

依專案類型提供可用性

專案類型	Available
Windows 應用程式	Yes
類別庫	Yes
主控台應用程式	Yes
Windows 控件庫	Yes
Web 控制庫	No
Windows 服務	Yes
網站	Yes

另請參閱

適用於

意見反應

此頁面對您有幫助嗎？