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

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

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呼叫 屬性所Switch傳回之 物件的 方法SourceSwitch。 如果 ShouldTrace 傳 true回 ， TraceData 則會在所有接聽程式上呼叫對應的 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

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

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。