EventLogTraceListener.TraceData 方法

定義

命名空間:

System.Diagnostics

組件:

System.Diagnostics.EventLog.dll

套件:

System.Diagnostics.EventLog v8.0.0

將追蹤資訊寫入事件記錄檔。

多載

TraceData(TraceEventCache, String, TraceEventType, Int32, Object)	寫入追蹤資訊、資料物件，以及事件資訊至事件記錄檔。
TraceData(TraceEventCache, String, TraceEventType, Int32, Object[])	寫入追蹤資訊，資料物件的陣列，及事件資訊至事件記錄檔。

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

來源:

EventLogTraceListener.cs

寫入追蹤資訊、資料物件，以及事件資訊至事件記錄檔。

public:
 override void TraceData(System::Diagnostics::TraceEventCache ^ eventCache, System::String ^ source, System::Diagnostics::TraceEventType severity, int id, System::Object ^ data);

[System.Runtime.InteropServices.ComVisible(false)]
public override void TraceData (System.Diagnostics.TraceEventCache eventCache, string source, System.Diagnostics.TraceEventType severity, int id, object data);

[<System.Runtime.InteropServices.ComVisible(false)>]
override this.TraceData : System.Diagnostics.TraceEventCache * string * System.Diagnostics.TraceEventType * int * obj -> unit

Public Overrides Sub TraceData (eventCache As TraceEventCache, source As String, severity As TraceEventType, id As Integer, data As Object)

參數

eventCache

TraceEventCache

包含目前處理序 ID、執行緒 ID 和堆疊追蹤資訊的物件。

source

String

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

severity

TraceEventType

其中一個列舉值，指定引發追蹤的事件型別。

id

Int32

事件的數值識別項。 source 和 id 的組合，會唯一識別事件。

data

Object

將資料物件寫入輸出檔或資料流。

屬性

ComVisibleAttribute

例外狀況

ArgumentException

source 未指定。

-或-

記錄項目字串超過 32,766 個字元。

備註

重要

方法 TraceData 並非由應用程式程式代碼呼叫。 它們是由、 Trace和 TraceSource 類別的方法Debug呼叫，以輸出追蹤數據。

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

eventCache和 source 參數可用來判斷是否應該追蹤事件。 id 是用來建立 EventInstance 物件，而且 TraceEventType 等於 EventLogEntryType 屬性的 EntryType 。 會EventInstance使用 WriteEvent 方法，將物件格式化為字串，寫入事件記錄data檔。

注意

參數的 id 最大值為 65,535。 id如果指定的值大於 65,535，則會使用最大值。

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

來源:

EventLogTraceListener.cs

寫入追蹤資訊，資料物件的陣列，及事件資訊至事件記錄檔。

public:
 override void TraceData(System::Diagnostics::TraceEventCache ^ eventCache, System::String ^ source, System::Diagnostics::TraceEventType severity, int id, ... cli::array <System::Object ^> ^ data);

[System.Runtime.InteropServices.ComVisible(false)]
public override void TraceData (System.Diagnostics.TraceEventCache eventCache, string source, System.Diagnostics.TraceEventType severity, int id, params object[] data);

[<System.Runtime.InteropServices.ComVisible(false)>]
override this.TraceData : System.Diagnostics.TraceEventCache * string * System.Diagnostics.TraceEventType * int * obj[] -> unit

Public Overrides Sub TraceData (eventCache As TraceEventCache, source As String, severity As TraceEventType, id As Integer, ParamArray data As Object())

參數

eventCache

TraceEventCache

包含目前處理序 ID、執行緒 ID 和堆疊追蹤資訊的物件。

source

String

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

severity

TraceEventType

其中一個列舉值，指定引發追蹤的事件型別。

id

Int32

事件的數值識別項。 source 和 id 的組合，會唯一識別事件。

data

Object[]

資料物件的陣列。

屬性

ComVisibleAttribute

例外狀況

ArgumentException

source 未指定。

-或-

記錄項目字串超過 32,766 個字元。

備註

重要

方法 TraceData 並非由應用程式程式代碼呼叫。 它們是由、 Trace和 TraceSource 類別的方法Debug呼叫，以輸出追蹤數據。

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

severity和 id 參數數據可用來建立EventInstance物件，此物件會寫入事件記錄檔，其中包含來自數據物件陣列的數據。

eventCache和 source 參數可用來判斷是否應該追蹤事件。 id 是用來建立 EventInstance 物件，而且 TraceEventType 等於 EventLogEntryType 屬性的 EntryType 。 會EventInstance使用 WriteEvent 方法，將 寫入事件記錄檔，data並將 物件數位格式化為字串陣列。

注意

參數的 id 最大值為 65,535。 id如果指定的值大於 65,535，則會使用最大值。