TraceListener.TraceData 方法

  • 參考

定義

命名空間:
System.Diagnostics
組件:
System.Diagnostics.TraceSource.dll
組件:
System.dll
組件:
netstandard.dll

寫入追蹤資料至特定接聽程式的輸出。

多載

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

寫入追蹤資訊、資料物件與事件資訊至特定接聽程式的輸出。
TraceData(TraceEventCache, String, TraceEventType, Int32, Object[])

寫入追蹤資訊、資料物件的陣列與事件資訊至特定接聽程式的輸出。

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

Source:
TraceListener.cs
Source:
TraceListener.cs
Source:
TraceListener.cs

寫入追蹤資訊、資料物件與事件資訊至特定接聽程式的輸出。

public:
 virtual void TraceData(System::Diagnostics::TraceEventCache ^ eventCache, System::String ^ source, System::Diagnostics::TraceEventType eventType, int id, System::Object ^ data);
public virtual void TraceData (System.Diagnostics.TraceEventCache? eventCache, string source, System.Diagnostics.TraceEventType eventType, int id, object? data);
public virtual void TraceData (System.Diagnostics.TraceEventCache eventCache, string source, System.Diagnostics.TraceEventType eventType, int id, object data);
[System.Runtime.InteropServices.ComVisible(false)]
public virtual void TraceData (System.Diagnostics.TraceEventCache eventCache, string source, System.Diagnostics.TraceEventType eventType, int id, object data);
abstract member TraceData : System.Diagnostics.TraceEventCache * string * System.Diagnostics.TraceEventType * int * obj -> unit
override this.TraceData : System.Diagnostics.TraceEventCache * string * System.Diagnostics.TraceEventType * int * obj -> unit
[<System.Runtime.InteropServices.ComVisible(false)>]
abstract member TraceData : System.Diagnostics.TraceEventCache * string * System.Diagnostics.TraceEventType * int * obj -> unit
override this.TraceData : System.Diagnostics.TraceEventCache * string * System.Diagnostics.TraceEventType * int * obj -> unit
Public Overridable Sub TraceData (eventCache As TraceEventCache, source As String, eventType As TraceEventType, id As Integer, data As Object)

參數

eventCache
TraceEventCache

TraceEventCache 物件，包含目前處理程序識別碼、執行緒識別碼與堆疊追蹤資訊。

source
String

用來識別輸出的名稱，通常是產生追蹤事件的應用程式名稱。

eventType
TraceEventType

其中一個 TraceEventType 值，可指定引發追蹤的事件類型。

id
Int32

事件的數值識別項。

data
Object

要發出的追蹤資料。

屬性
ComVisibleAttribute

備註

重要

此方法並非直接由應用程式程式碼呼叫，而是由 、 Trace 和 TraceSource 類別的成員 Debug 呼叫，以將追蹤資料寫入輸出。

預設實作會在 eventCache 追蹤的頁首和頁尾中寫入 、 sourceeventType 和 id 參數。 參數 data 會寫入為追蹤訊息的本文。 資料 ToString 物件的 方法可用來將 物件 String 轉換成 。

另請參閱

適用於

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

Source:
TraceListener.cs
Source:
TraceListener.cs
Source:
TraceListener.cs

寫入追蹤資訊、資料物件的陣列與事件資訊至特定接聽程式的輸出。

public:
 virtual void TraceData(System::Diagnostics::TraceEventCache ^ eventCache, System::String ^ source, System::Diagnostics::TraceEventType eventType, int id, ... cli::array <System::Object ^> ^ data);
public virtual void TraceData (System.Diagnostics.TraceEventCache? eventCache, string source, System.Diagnostics.TraceEventType eventType, int id, params object?[]? data);
public virtual void TraceData (System.Diagnostics.TraceEventCache eventCache, string source, System.Diagnostics.TraceEventType eventType, int id, params object[] data);
[System.Runtime.InteropServices.ComVisible(false)]
public virtual void TraceData (System.Diagnostics.TraceEventCache eventCache, string source, System.Diagnostics.TraceEventType eventType, int id, params object[] data);
abstract member TraceData : System.Diagnostics.TraceEventCache * string * System.Diagnostics.TraceEventType * int * obj[] -> unit
override this.TraceData : System.Diagnostics.TraceEventCache * string * System.Diagnostics.TraceEventType * int * obj[] -> unit
[<System.Runtime.InteropServices.ComVisible(false)>]
abstract member TraceData : System.Diagnostics.TraceEventCache * string * System.Diagnostics.TraceEventType * int * obj[] -> unit
override this.TraceData : System.Diagnostics.TraceEventCache * string * System.Diagnostics.TraceEventType * int * obj[] -> unit
Public Overridable Sub TraceData (eventCache As TraceEventCache, source As String, eventType As TraceEventType, id As Integer, ParamArray data As Object())

參數

eventCache
TraceEventCache

TraceEventCache 物件，包含目前處理程序識別碼、執行緒識別碼與堆疊追蹤資訊。

source
String

用來識別輸出的名稱，通常是產生追蹤事件的應用程式名稱。

eventType
TraceEventType

其中一個 TraceEventType 值，可指定引發追蹤的事件類型。

id
Int32

事件的數值識別項。

data
Object[]

要發出做為資料的物件陣列。

屬性
ComVisibleAttribute

備註

重要

此方法並非直接由應用程式程式碼呼叫，而是由 、 Trace 和 TraceSource 類別的成員 Debug 呼叫，以將追蹤資料寫入輸出。

預設實作會將 、 eventType 和 id 參數的值 source 寫入為標頭。 資料物件會使用 ToString 每個 物件的 方法轉換成字串。 資料 eventCache 會寫入為頁尾，輸出資料的本質取決於 屬性的值 TraceOutputOptions 。

另請參閱

適用於