Log.WriteException 方法
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
將例外狀況資訊寫入至應用程式的記錄檔接聽程式。
多載
| 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 -> unitPublic Sub WriteException (ex As Exception)參數
- ex
- Exception
必要。 要記錄的例外狀況。
例外狀況
ex 為 Nothing。
具有部分信任的程式碼呼叫方法，但要寫入需要完全信任的事件記錄檔接聽程式 (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 服務 | 是 |
| 網站 | 是 |
另請參閱
- Exception
- TraceEventType
- 物件 (Visual Basic)
- 在 Visual Basic 中使用應用程式記錄檔
- 如何：在 Visual Basic 中記錄例外狀況
- 逐步解說：判斷 My.Application.Log 寫入資訊的位置
適用於
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 -> unitPublic Sub WriteException (ex As Exception, severity As TraceEventType, additionalInfo As String)參數
- ex
- Exception
必要。 要記錄的例外狀況。
- severity
- TraceEventType
訊息的類型。 預設值為 Error。
- additionalInfo
- String
要附加至訊息的字串。 預設為空字串。
例外狀況
ex 為 Nothing。
訊息類型不是其中一個 TraceEventType 列舉值。
具有部分信任的程式碼呼叫方法，但要寫入需要完全信任的事件記錄檔接聽程式 (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 服務 | 是 |
| 網站 | 是 |
另請參閱
- Exception
- TraceEventType
- 物件 (Visual Basic)
- 在 Visual Basic 中使用應用程式記錄檔
- 如何：在 Visual Basic 中記錄例外狀況
- 逐步解說：判斷 My.Application.Log 寫入資訊的位置
適用於
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 -> unitPublic Sub WriteException (ex As Exception, severity As TraceEventType, additionalInfo As String, id As Integer)參數
- ex
- Exception
必要。 要記錄的例外狀況。
- severity
- TraceEventType
訊息的類型。 預設值為 Error。
- additionalInfo
- String
要附加至訊息的字串。 預設為空字串。
- id
- Int32
訊息識別項，通常用於相互關聯。 根據預設，與 entryType 一節中的表格中所述相關。
例外狀況
ex 為 Nothing。
訊息類型不是其中一個 TraceEventType 列舉值。
具有部分信任的程式碼呼叫方法，但要寫入需要完全信任的事件記錄檔接聽程式 (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 服務 | 是 |
| 網站 | 是 |
另請參閱
- Exception
- TraceEventType
- 物件 (Visual Basic)
- 在 Visual Basic 中使用應用程式記錄檔
- 如何：在 Visual Basic 中記錄例外狀況
- 逐步解說：判斷 My.Application.Log 寫入資訊的位置
適用於
意見反應
即將登場：在 2024 年，我們將逐步淘汰 GitHub 問題作為內容的意見反應機制，並將它取代為新的意見反應系統。 如需詳細資訊，請參閱：https://aka.ms/ContentUserFeedback。
提交並檢視相關的意見反應