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 -> unit
Public 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[] -> unit
Public 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
フィードバック
https://aka.ms/ContentUserFeedback」を参照してください。
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「フィードバックの送信と表示