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 集合中的追蹤接聽程式。

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

參數

eventType

TraceEventType

其中一個列舉值，可指定追蹤資料的事件類型。

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.");

備註

方法 TraceData 和方法一樣 TraceEvent 適用於自動化工具，但也允許附加其他物件，例如例外狀況實例至追蹤。

方法TraceData會SourceSwitch.ShouldTrace呼叫 屬性所Switch傳回之 物件的 方法SourceSwitch。 如果 ShouldTrace 傳 true回 ， TraceData 則會在所有接聽程式上呼叫對應的 TraceData 方法。 否則會 TraceData 傳回 ，而不呼叫接聽程式的方法。

注意

物件 EventLogTraceListener 限制為最大值 id 65,535。 id如果指定的值大於 65,535，則EventLogTraceListener物件會使用 65,535。

TraceData(TraceEventType, Int32, Object[])

來源:

TraceSource.cs

使用指定的事件類型、事件識別項和追蹤資料，將追蹤資料陣列寫入 Listeners 集合中的追蹤接聽程式。

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

參數

eventType

TraceEventType

其中一個列舉值，可指定追蹤資料的事件類型。

id

Int32

事件的數值識別項。

data

Object[]

包含追蹤資料的物件陣列。

屬性

ConditionalAttribute

例外狀況

ObjectDisposedException

嘗試在最終處理期間追蹤事件。

備註

方法 TraceData 與方法一樣 TraceEvent 適用於自動化工具，但也允許附加其他物件，例如例外狀況實例和堆棧追蹤。

方法TraceData會ShouldTrace呼叫 屬性所Switch傳回之 物件的 方法SourceSwitch。 如果 ShouldTrace 傳 true回 ， TraceData 則會在所有接聽程式上呼叫對應的 TraceData 方法。 否則會 TraceData 傳回 ，而不呼叫接聽程式的方法。

注意

物件 EventLogTraceListener 限制為最大值 id 65,535。 id如果指定的值大於 65,535，則EventLogTraceListener物件會使用 65,535。