Log.WriteException メソッド

定義

名前空間:

Microsoft.VisualBasic.Logging

アセンブリ:

Microsoft.VisualBasic.Forms.dll

アプリケーションのログ リスナーに例外情報を書き込みます。

オーバーロード

名前	説明
WriteException(Exception)	アプリケーションのログ リスナーに例外情報を書き込みます。
WriteException(Exception, TraceEventType, String)	アプリケーションのログ リスナーに例外情報を書き込みます。
WriteException(Exception, TraceEventType, String, Int32)	アプリケーションのログ リスナーに例外情報を書き込みます。

WriteException(Exception)

ソース:

Log.vb

アプリケーションのログ リスナーに例外情報を書き込みます。

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例外が発生するように、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を Web アプリケーションの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 アプリケーション	Yes
クラス ライブラリ	Yes
コンソール アプリケーション	Yes
Windows コントロール ライブラリ	Yes
Web コントロール ライブラリ	いいえ
Windows サービス	Yes
ウェブサイト	Yes

こちらもご覧ください

• Exception
• TraceEventType
• オブジェクト (Visual Basic)
• Visual Basic
• 方法: Visual Basic
• チュートリアル: My.Application.Log が情報を書き込む場所の決定

WriteException(Exception, TraceEventType, String)

ソース:

Log.vb

アプリケーションのログ リスナーに例外情報を書き込みます。

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 列挙値の 1 つではありません。

SecurityException

部分信頼を持つコードはメソッドを呼び出しますが、完全信頼を必要とするイベント ログ リスナーに書き込みます。

例

この例では、 My.Application.Log.WriteException メソッドを使用して例外をログに記録する方法を示します。 Dim例外が発生するように、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を Web アプリケーションの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 アプリケーション	Yes
クラス ライブラリ	Yes
コンソール アプリケーション	Yes
Windows コントロール ライブラリ	Yes
Web コントロール ライブラリ	いいえ
Windows サービス	Yes
ウェブサイト	Yes

こちらもご覧ください

• Exception
• TraceEventType
• オブジェクト (Visual Basic)
• Visual Basic
• 方法: Visual Basic
• チュートリアル: My.Application.Log が情報を書き込む場所の決定

WriteException(Exception, TraceEventType, String, Int32)

ソース:

Log.vb

アプリケーションのログ リスナーに例外情報を書き込みます。

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 列挙値の 1 つではありません。

SecurityException

部分信頼を持つコードはメソッドを呼び出しますが、完全信頼を必要とするイベント ログ リスナーに書き込みます。

例

この例では、 My.Application.Log.WriteException メソッドを使用して例外をログに記録する方法を示します。 Dim例外が発生するように、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を Web アプリケーションの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 アプリケーション	Yes
クラス ライブラリ	Yes
コンソール アプリケーション	Yes
Windows コントロール ライブラリ	Yes
Web コントロール ライブラリ	いいえ
Windows サービス	Yes
ウェブサイト	Yes

こちらもご覧ください

• Exception
• TraceEventType
• オブジェクト (Visual Basic)
• Visual Basic
• 方法: Visual Basic
• チュートリアル: My.Application.Log が情報を書き込む場所の決定