次の方法で共有


EventLogTraceListener.TraceData メソッド

定義

イベント ログにトレース データを書き込みます。

オーバーロード

TraceData(TraceEventCache, String, TraceEventType, Int32, Object)

トレース情報、データ オブジェクト、およびイベント情報をイベント ログに書き込みます。

TraceData(TraceEventCache, String, TraceEventType, Int32, Object[])

トレース情報、データ オブジェクトの配列、およびイベント情報をイベント ログに書き込みます。

TraceData(TraceEventCache, String, TraceEventType, Int32, Object)

ソース:
EventLogTraceListener.cs
ソース:
EventLogTraceListener.cs
ソース:
EventLogTraceListener.cs

トレース情報、データ オブジェクト、およびイベント情報をイベント ログに書き込みます。

public:
 override void TraceData(System::Diagnostics::TraceEventCache ^ eventCache, System::String ^ source, System::Diagnostics::TraceEventType severity, int id, System::Object ^ data);
[System.Runtime.InteropServices.ComVisible(false)]
public override void TraceData (System.Diagnostics.TraceEventCache eventCache, string source, System.Diagnostics.TraceEventType severity, int id, object data);
[<System.Runtime.InteropServices.ComVisible(false)>]
override this.TraceData : System.Diagnostics.TraceEventCache * string * System.Diagnostics.TraceEventType * int * obj -> unit
Public Overrides Sub TraceData (eventCache As TraceEventCache, source As String, severity As TraceEventType, id As Integer, data As Object)

パラメーター

eventCache
TraceEventCache

現在のプロセス ID、スレッド ID、およびスタック トレース情報を格納しているオブジェクト。

source
String

出力を識別するために使用される名前。通常は、トレース イベントを生成したアプリケーションの名前。

severity
TraceEventType

トレースを発生させたイベントの種類を指定する列挙値の 1 つ。

id
Int32

イベントの数値識別子。 source および id の組み合わせにより、イベントが一意に識別されます。

data
Object

出力ファイルまたは出力ストリームに書き込むデータ オブジェクト。

属性

例外

source が指定されていません。

- または -

ログ エントリの文字列の長さが 32,766 文字を超えています。

注釈

重要

メソッドは TraceData 、アプリケーション コードによって呼び出されるものではありません。 これらは、トレース データを出力するために、DebugTraceおよび TraceSource クラスのメソッドによって呼び出されます。

メソッドは TraceData 、 メソッドと同様 TraceEvent に、自動化されたツールを対象としていますが、例外インスタンスなどの追加のオブジェクトをトレースにアタッチすることもできます。

eventCacheおよび source パラメーターは、イベントをトレースする必要があるかどうかを判断するために使用されます。 idは オブジェクトをEventInstance作成するために使用され、 TraceEventType は プロパティの EntryTypeEventLogEntryType相当します。 EventInstanceは、 メソッドを使用して、文字列として書式設定された オブジェクトを使用してイベント ログdataWriteEvent書き込まれます。

注意

パラメーターの id 最大値は 65,535 です。 指定された id 値が 65,535 より大きい場合は、最大値が使用されます。

適用対象

TraceData(TraceEventCache, String, TraceEventType, Int32, Object[])

ソース:
EventLogTraceListener.cs
ソース:
EventLogTraceListener.cs
ソース:
EventLogTraceListener.cs

トレース情報、データ オブジェクトの配列、およびイベント情報をイベント ログに書き込みます。

public:
 override void TraceData(System::Diagnostics::TraceEventCache ^ eventCache, System::String ^ source, System::Diagnostics::TraceEventType severity, int id, ... cli::array <System::Object ^> ^ data);
[System.Runtime.InteropServices.ComVisible(false)]
public override void TraceData (System.Diagnostics.TraceEventCache eventCache, string source, System.Diagnostics.TraceEventType severity, int id, params object[] data);
[<System.Runtime.InteropServices.ComVisible(false)>]
override this.TraceData : System.Diagnostics.TraceEventCache * string * System.Diagnostics.TraceEventType * int * obj[] -> unit
Public Overrides Sub TraceData (eventCache As TraceEventCache, source As String, severity As TraceEventType, id As Integer, ParamArray data As Object())

パラメーター

eventCache
TraceEventCache

現在のプロセス ID、スレッド ID、およびスタック トレース情報を格納しているオブジェクト。

source
String

出力を識別するために使用される名前。通常は、トレース イベントを生成したアプリケーションの名前。

severity
TraceEventType

トレースを発生させたイベントの種類を指定する列挙値の 1 つ。

id
Int32

イベントの数値識別子。 source および id の組み合わせにより、イベントが一意に識別されます。

data
Object[]

データ オブジェクトの配列。

属性

例外

source が指定されていません。

- または -

ログ エントリの文字列の長さが 32,766 文字を超えています。

注釈

重要

メソッドは TraceData 、アプリケーション コードによって呼び出されるものではありません。 これらは、トレース データを出力するために、DebugTraceおよび TraceSource クラスのメソッドによって呼び出されます。

メソッドは TraceData 、 メソッドと同様 TraceEvent に、自動化されたツールを対象としていますが、例外インスタンスなどの追加のオブジェクトをトレースにアタッチすることもできます。

severityおよび id パラメーター データは、データ オブジェクトのEventInstance配列からのデータを使用してイベント ログに書き込まれるオブジェクトを作成するために使用されます。

eventCacheおよび source パラメーターは、イベントをトレースする必要があるかどうかを判断するために使用されます。 idは オブジェクトをEventInstance作成するために使用され、 TraceEventType は プロパティの EntryTypeEventLogEntryType相当します。 は EventInstance 、 メソッドを使用して、文字列配列として書式設定されたオブジェクト配列を使用してイベント ログ dataWriteEvent 書き込まれます。

注意

パラメーターの id 最大値は 65,535 です。 指定された id 値が 65,535 より大きい場合は、最大値が使用されます。

適用対象