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です。
部分信頼を持つコードがこのメソッドを呼び出して、完全信頼を必要とするイベント ログ リスナーに書き込みを行っています。
例
この例では、 メソッドを使用して例外を 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 サイト | はい |
こちらもご覧ください
- 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 列挙値のどれでもありません。
部分信頼を持つコードがこのメソッドを呼び出して、完全信頼を必要とするイベント ログ リスナーに書き込みを行っています。
例
この例では、 メソッドを使用して例外を 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 サイト | はい |
こちらもご覧ください
- 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
メッセージ ID。一般に、メッセージの相関関係を示すために使用されます。 既定では、「解説」セクションの表の説明に従って に関連 entryType します。
例外
ex が Nothingです。
メッセージの種類が 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 サイト | はい |
こちらもご覧ください
- Exception
- TraceEventType
- オブジェクト (Visual Basic)
- Visual Basic でのアプリケーション ログの使用
- 方法: Visual Basic で例外をログに記録する
- チュートリアル: My.Application.Log による情報の書き込み先の確認
適用対象
.NET