EventLogTraceListener.TraceData メソッド

定義

名前空間:

System.Diagnostics

アセンブリ:

System.Diagnostics.EventLog.dll

パッケージ:

System.Diagnostics.EventLog v8.0.0

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

オーバーロード

TraceData(TraceEventCache, String, TraceEventType, Int32, Object)	トレース情報、データ オブジェクト、およびイベント情報をイベント ログに書き込みます。
TraceData(TraceEventCache, String, TraceEventType, Int32, Object[])	トレース情報、データ オブジェクトの配列、およびイベント情報をイベント ログに書き込みます。

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

ソース:

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

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

属性

ComVisibleAttribute

例外

ArgumentException

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

- または -

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

注釈

重要

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

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

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

注意

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

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

ソース:

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[]

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

属性

ComVisibleAttribute

例外

ArgumentException

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

- または -

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

注釈

重要

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

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

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

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

注意

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