TraceSource.TraceData メソッド

定義

名前空間:

System.Diagnostics

アセンブリ:

System.Diagnostics.TraceSource.dll

トレース データを Listeners コレクション内のトレース リスナーに書き込みます。

オーバーロード

TraceData(TraceEventType, Int32, Object)	指定されたイベントの種類、イベント識別子、およびトレース データを使用して、トレース データを Listeners コレクション内のトレース リスナーに書き込みます。
TraceData(TraceEventType, Int32, Object[])	指定されたイベントの種類、イベント識別子、およびトレース データの配列を使用して、トレース データを Listeners コレクション内のトレース リスナーに書き込みます。

TraceData(TraceEventType, Int32, Object)

ソース:

TraceSource.cs

指定されたイベントの種類、イベント識別子、およびトレース データを使用して、トレース データを Listeners コレクション内のトレース リスナーに書き込みます。

public:
 void TraceData(System::Diagnostics::TraceEventType eventType, int id, System::Object ^ data);

[System.Diagnostics.Conditional("TRACE")]
public void TraceData (System.Diagnostics.TraceEventType eventType, int id, object? data);

[<System.Diagnostics.Conditional("TRACE")>]
member this.TraceData : System.Diagnostics.TraceEventType * int * obj -> unit

Public Sub TraceData (eventType As TraceEventType, id As Integer, data As Object)

パラメーター

eventType

TraceEventType

トレース データのイベントの種類を指定する列挙値の 1 つ。

id

Int32

イベントの数値識別子。

data

Object

トレース データ。

属性

ConditionalAttribute

例外

ObjectDisposedException

終了処理時にイベントをトレースしようとしました。

例

次のコード例は、 メソッドを TraceData(TraceEventType, Int32, Object) 使用してトレース メッセージをフィルター処理し、リスナーに転送する方法を示しています。 このコード例は、TraceSource クラスのために提供されている大規模な例の一部です。

// Test the filter on the ConsoleTraceListener.
ts.Listeners["console"].Filter = new SourceFilter("No match");
ts.TraceData(TraceEventType.Error, 5,
    "SourceFilter should reject this message for the console trace listener.");
ts.Listeners["console"].Filter = new SourceFilter("TraceTest");
ts.TraceData(TraceEventType.Error, 6,
    "SourceFilter should let this message through on the console trace listener.");

' Test the filter on the ConsoleTraceListener.
ts.Listeners("console").Filter = New SourceFilter("No match")
ts.TraceData(TraceEventType.Error, 5, "SourceFilter should reject this message for the console trace listener.")
ts.Listeners("console").Filter = New SourceFilter("TraceTest")
ts.TraceData(TraceEventType.Error, 6, "SourceFilter should let this message through on the console trace listener.")

注釈

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

メソッドは TraceData 、 SourceSwitch.ShouldTrace プロパティによって返されるオブジェクトの SourceSwitch メソッドを Switch 呼び出します。 が を返す場合ShouldTraceはtrueTraceData、すべてのリスナーで対応するTraceDataメソッドを呼び出します。 それ以外の場合は、 TraceData リスナーのメソッドを呼び出さずに を返します。

注意

オブジェクトの EventLogTraceListener 最大値 id は 65,535 に制限されています。 指定した id 値が 65,535 より大きい場合、 EventLogTraceListener オブジェクトは 65,535 を使用します。

TraceData(TraceEventType, Int32, Object[])

ソース:

TraceSource.cs

指定されたイベントの種類、イベント識別子、およびトレース データの配列を使用して、トレース データを Listeners コレクション内のトレース リスナーに書き込みます。

public:
 void TraceData(System::Diagnostics::TraceEventType eventType, int id, ... cli::array <System::Object ^> ^ data);

[System.Diagnostics.Conditional("TRACE")]
public void TraceData (System.Diagnostics.TraceEventType eventType, int id, params object?[]? data);

[<System.Diagnostics.Conditional("TRACE")>]
member this.TraceData : System.Diagnostics.TraceEventType * int * obj[] -> unit

Public Sub TraceData (eventType As TraceEventType, id As Integer, ParamArray data As Object())

パラメーター

eventType

TraceEventType

トレース データのイベントの種類を指定する列挙値の 1 つ。

id

Int32

イベントの数値識別子。

data

Object[]

トレース データが格納されているオブジェクト配列。

属性

ConditionalAttribute

例外

ObjectDisposedException

終了処理時にイベントをトレースしようとしました。

注釈

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

メソッドは TraceData 、 ShouldTrace プロパティによって返されるオブジェクトの SourceSwitch メソッドを Switch 呼び出します。 が を返す場合ShouldTraceはtrueTraceData、すべてのリスナーで対応するTraceDataメソッドを呼び出します。 それ以外の場合は、 TraceData リスナーのメソッドを呼び出さずに を返します。

注意

オブジェクトの EventLogTraceListener 最大値 id は 65,535 に制限されています。 指定した id 値が 65,535 より大きい場合、 EventLogTraceListener オブジェクトは 65,535 を使用します。