共用方式為

Log.WriteException 方法

  • 參考

定義

命名空間:
Microsoft.VisualBasic.Logging
組件:
Microsoft.VisualBasic.dll
組件:
Microsoft.VisualBasic.Forms.dll

將例外狀況資訊寫入至應用程式的記錄檔接聽程式。

多載

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

具有部分信任的程式碼呼叫方法，但要寫入需要完全信任的事件記錄檔接聽程式 (Listener)。

範例

此範例示範如何使用 My.Application.Log.WriteException 方法來記錄例外狀況。 取消 Dim 和 MsgBox 行的註解，造成 NullReferenceException 例外狀況。 如需詳細資訊，請參閱 如何：記錄例外狀況。

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

此程式代碼範例只能在用戶端應用程式內執行。 針對 Web 應用程式變更 My.Application.Log.WriteException 為 My.Log.WriteException 。

備註

方法 WriteException 會將包含在例外狀況中的資訊寫入應用程式的事件記錄檔接聽程式。

在用戶端應用程式中 Log ，對象可透過 My.Application.Log 物件取得。 在 Web 應用程式中， 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 寫入資訊的位置

依專案類型的可用性

專案類型 可用
Windows 應用程式 是
類別庫 是
主控台應用程式 是
Windows 控制項程式庫 是
Web 控制項程式庫 否
Windows 服務 是
網站 是

另請參閱

適用於

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

具有部分信任的程式碼呼叫方法，但要寫入需要完全信任的事件記錄檔接聽程式 (Listener)。

範例

此範例示範如何使用 My.Application.Log.WriteException 方法來記錄例外狀況。 取消 Dim 和 MsgBox 行的註解，造成 NullReferenceException 例外狀況。 如需詳細資訊，請參閱 如何：記錄例外狀況。

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

此程式代碼範例只能在用戶端應用程式內執行。 針對 Web 應用程式變更 My.Application.Log.WriteException 為 My.Log.WriteException 。

備註

方法 WriteException 會將包含在例外狀況中的資訊寫入應用程式的事件記錄檔接聽程式。

在用戶端應用程式中 Log ，對象可透過 My.Application.Log 物件取得。 在 Web 應用程式中， 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 寫入資訊的位置

依專案類型的可用性

專案類型 可用
Windows 應用程式 是
類別庫 是
主控台應用程式 是
Windows 控制項程式庫 是
Web 控制項程式庫 否
Windows 服務 是
網站 是

另請參閱

適用於

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

具有部分信任的程式碼呼叫方法，但要寫入需要完全信任的事件記錄檔接聽程式 (Listener)。

範例

此範例示範如何使用 My.Application.Log.WriteException 方法來記錄例外狀況。 取消 Dim 和 MsgBox 行的註解，造成 NullReferenceException 例外狀況。 如需詳細資訊，請參閱 如何：記錄例外狀況。

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

此程式代碼範例只能在用戶端應用程式內執行。 針對 Web 應用程式變更 My.Application.Log.WriteException 為 My.Log.WriteException 。

備註

方法 WriteException 會將包含在例外狀況中的資訊寫入應用程式的事件記錄檔接聽程式。

在用戶端應用程式中 Log ，對象可透過 My.Application.Log 物件取得。 在 Web 應用程式中， 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 寫入資訊的位置

依專案類型的可用性

專案類型 可用
Windows 應用程式 是
類別庫 是
主控台應用程式 是
Windows 控制項程式庫 是
Web 控制項程式庫 否
Windows 服務 是
網站 是

另請參閱

適用於