次の方法で共有


Log.WriteException メソッド

定義

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

オーバーロード

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

必須です。 記録する例外。

例外

exNothingです。

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

この例では、 メソッドを使用して例外を 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.Log.WriteException変更My.Application.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 サービス はい
Web サイト はい

こちらもご覧ください

適用対象

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

メッセージに追加する文字列。 既定では空の文字列です。

例外

exNothingです。

メッセージの種類が TraceEventType 列挙値のどれでもありません。

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

この例では、 メソッドを使用して例外を 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.Log.WriteException変更My.Application.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 サービス はい
Web サイト はい

こちらもご覧ください

適用対象

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

メッセージ ID。一般に、メッセージの相関関係を示すために使用されます。 既定では、「解説」セクションの表の説明に従って に関連 entryType します。

例外

exNothingです。

メッセージの種類が TraceEventType 列挙値のどれでもありません。

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

この例では、 メソッドを使用して例外を 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.Log.WriteException変更My.Application.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 サービス はい
Web サイト はい

こちらもご覧ください

適用対象