TraceSource.TraceData メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
トレース データを Listeners コレクション内のトレース リスナーに書き込みます。
オーバーロード
| TraceData(TraceEventType, Int32, Object) |
指定されたイベントの種類、イベント識別子、およびトレース データを使用して、トレース データを Listeners コレクション内のトレース リスナーに書き込みます。 |
| TraceData(TraceEventType, Int32, Object[]) |
指定されたイベントの種類、イベント識別子、およびトレース データの配列を使用して、トレース データを Listeners コレクション内のトレース リスナーに書き込みます。 |
TraceData(TraceEventType, Int32, Object)
- ソース:
- TraceSource.cs
- ソース:
- TraceSource.cs
- ソース:
- 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")]
public void TraceData (System.Diagnostics.TraceEventType eventType, int id, object data);[<System.Diagnostics.Conditional("TRACE")>]
member this.TraceData : System.Diagnostics.TraceEventType * int * obj -> unitPublic Sub TraceData (eventType As TraceEventType, id As Integer, data As Object)パラメーター
- eventType
- TraceEventType
トレース データのイベントの種類を指定する列挙値の 1 つ。
- id
- Int32
イベントの数値識別子。
- data
- Object
トレース データ。
- 属性
例外
終了処理時にイベントをトレースしようとしました。
例
次のコード例は、 メソッドを 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
- ソース:
- TraceSource.cs
- ソース:
- 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")]
public void TraceData (System.Diagnostics.TraceEventType eventType, int id, params object[] data);[<System.Diagnostics.Conditional("TRACE")>]
member this.TraceData : System.Diagnostics.TraceEventType * int * obj[] -> unitPublic Sub TraceData (eventType As TraceEventType, id As Integer, ParamArray data As Object())パラメーター
- eventType
- TraceEventType
トレース データのイベントの種類を指定する列挙値の 1 つ。
- id
- Int32
イベントの数値識別子。
- data
- Object[]
トレース データが格納されているオブジェクト配列。
- 属性
例外
終了処理時にイベントをトレースしようとしました。
注釈
TraceDataメソッドと同様にTraceEvent、 メソッドは自動化されたツールを対象としていますが、例外インスタンスやスタック トレースなどの追加オブジェクトをトレースにアタッチすることもできます。
メソッドは TraceData 、 ShouldTrace プロパティによって返されるオブジェクトの SourceSwitch メソッドを Switch 呼び出します。 が を返す場合ShouldTraceはtrueTraceData、すべてのリスナーで対応するTraceDataメソッドを呼び出します。 それ以外の場合は、 TraceData リスナーのメソッドを呼び出さずに を返します。
注意
オブジェクトの EventLogTraceListener 最大値 id は 65,535 に制限されています。 指定した id 値が 65,535 より大きい場合、 EventLogTraceListener オブジェクトは 65,535 を使用します。
適用対象
.NET