EventLogTraceListener.TraceEvent メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
イベント ログにトレース情報を書き込みます。
オーバーロード
| TraceEvent(TraceEventCache, String, TraceEventType, Int32, String) |
トレース情報、メッセージ、およびイベント情報をイベント ログに書き込みます。 |
| TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[]) |
トレース情報、オブジェクトの書式付き配列、およびイベント情報をイベント ログに書き込みます。 |
TraceEvent(TraceEventCache, String, TraceEventType, Int32, String)
トレース情報、メッセージ、およびイベント情報をイベント ログに書き込みます。
public:
override void TraceEvent(System::Diagnostics::TraceEventCache ^ eventCache, System::String ^ source, System::Diagnostics::TraceEventType severity, int id, System::String ^ message);[System.Runtime.InteropServices.ComVisible(false)]
public override void TraceEvent (System.Diagnostics.TraceEventCache eventCache, string source, System.Diagnostics.TraceEventType severity, int id, string message);[<System.Runtime.InteropServices.ComVisible(false)>]
override this.TraceEvent : System.Diagnostics.TraceEventCache * string * System.Diagnostics.TraceEventType * int * string -> unitPublic Overrides Sub TraceEvent (eventCache As TraceEventCache, source As String, severity As TraceEventType, id As Integer, message As String)パラメーター
- eventCache
- TraceEventCache
現在のプロセス ID、スレッド ID、およびスタック トレース情報を格納しているオブジェクト。
- source
- String
出力を識別するために使用される名前。通常は、トレース イベントを生成したアプリケーションの名前。
- severity
- TraceEventType
トレースを発生させたイベントの種類を指定する列挙値の 1 つ。
- id
- Int32
イベントの数値識別子。 source および id の組み合わせにより、イベントが一意に識別されます。
- message
- String
トレース メッセージ。
- 属性
例外
注釈
重要
メソッドは TraceEvent 、アプリケーション コードによって呼び出されるものではありません。 これらのメソッドは、トレース データを Debug書き込む、、 Trace、 TraceSource クラスのメソッドによって呼び出されます。
メソッドは TraceEvent 、ツールによって自動的に処理できるイベントをトレースすることを目的としています。 たとえば、監視ツールは、特定のイベントが特定のソースによってトレースされた場合に管理者に通知できます。
eventCacheおよび source パラメーターは、イベントをトレースする必要があるかどうかを判断するために使用されます。 idは オブジェクトをEventInstance作成するために使用され、 TraceEventType は プロパティの EntryType にEventLogEntryType相当します。 EventInstanceは、 メソッドを使用してデータをmessage使用してイベント ログにWriteEvent書き込まれます。
注意
パラメーターの id 最大値は 65,535 です。 指定された id 値が 65,535 より大きい場合は、最大値が使用されます。
適用対象
TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[])
トレース情報、オブジェクトの書式付き配列、およびイベント情報をイベント ログに書き込みます。
public:
override void TraceEvent(System::Diagnostics::TraceEventCache ^ eventCache, System::String ^ source, System::Diagnostics::TraceEventType severity, int id, System::String ^ format, ... cli::array <System::Object ^> ^ args);[System.Runtime.InteropServices.ComVisible(false)]
public override void TraceEvent (System.Diagnostics.TraceEventCache eventCache, string source, System.Diagnostics.TraceEventType severity, int id, string format, params object[] args);[<System.Runtime.InteropServices.ComVisible(false)>]
override this.TraceEvent : System.Diagnostics.TraceEventCache * string * System.Diagnostics.TraceEventType * int * string * obj[] -> unitPublic Overrides Sub TraceEvent (eventCache As TraceEventCache, source As String, severity As TraceEventType, id As Integer, format As String, ParamArray args As Object())パラメーター
- eventCache
- TraceEventCache
現在のプロセス ID、スレッド ID、およびスタック トレース情報を格納しているオブジェクト。
- source
- String
出力を識別するために使用される名前。通常は、トレース イベントを生成したアプリケーションの名前。
- severity
- TraceEventType
トレースを発生させたイベントの種類を指定する列挙値の 1 つ。
- id
- Int32
イベントの数値識別子。 source および id の組み合わせにより、イベントが一意に識別されます。
- format
- String
0 個以上の書式項目を格納している書式指定文字列。args 配列内のオブジェクトに対応します。
- args
- Object[]
0 個以上の書式設定対象オブジェクトを含んだ object 配列。
- 属性
例外
注釈
重要
メソッドは TraceEvent 、アプリケーション コードによって呼び出されるものではありません。 これらのメソッドは、トレース データを Debug書き込む、、 Trace、 TraceSource クラスのメソッドによって呼び出されます。
メソッドは TraceEvent 、ツールによって自動的に処理できるイベントをトレースすることを目的としています。 たとえば、監視ツールは、特定のイベントが特定のソースによってトレースされた場合に管理者に通知できます。
eventCacheおよび source パラメーターは、イベントをトレースする必要があるかどうかを判断するために使用されます。 idは オブジェクトをEventInstance作成するために使用され、 TraceEventType は プロパティの EntryType にEventLogEntryType相当します。 はEventInstance、 パラメーターと args パラメーターから取得したメッセージと共に、 メソッドをWriteEvent使用してイベント ログにformat書き込まれます。 argsオブジェクト配列は、 メソッドを使用してFormat文字列に変換され、文字列とargs配列をformat渡して、イベント ログのメッセージとして文字列を書式設定します。
注意
パラメーターの id 最大値は 65,535 です。 指定された id 値が 65,535 より大きい場合は、最大値が使用されます。
適用対象
.NET