TraceListener.TraceEvent 方法

定義

命名空間:

System.Diagnostics

組件:

System.Diagnostics.TraceSource.dll

寫入追蹤和事件資訊至特定接聽程式的輸出。

多載

TraceEvent(TraceEventCache, String, TraceEventType, Int32)	寫入追蹤和事件資訊至特定接聽程式的輸出。
TraceEvent(TraceEventCache, String, TraceEventType, Int32, String)	寫入追蹤資訊、訊息與事件資訊至特定接聽程式的輸出。
TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[])	寫入追蹤資訊、格式化的物件陣列與事件資訊至特定接聽程式的輸出。

TraceEvent(TraceEventCache, String, TraceEventType, Int32)

來源:

TraceListener.cs

寫入追蹤和事件資訊至特定接聽程式的輸出。

public:
 virtual void TraceEvent(System::Diagnostics::TraceEventCache ^ eventCache, System::String ^ source, System::Diagnostics::TraceEventType eventType, int id);

public virtual void TraceEvent (System.Diagnostics.TraceEventCache? eventCache, string source, System.Diagnostics.TraceEventType eventType, int id);

abstract member TraceEvent : System.Diagnostics.TraceEventCache * string * System.Diagnostics.TraceEventType * int -> unit
override this.TraceEvent : System.Diagnostics.TraceEventCache * string * System.Diagnostics.TraceEventType * int -> unit

Public Overridable Sub TraceEvent (eventCache As TraceEventCache, source As String, eventType As TraceEventType, id As Integer)

參數

eventCache

TraceEventCache

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

source

String

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

eventType

TraceEventType

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

id

Int32

事件的數值識別項。

備註

重要

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

默認實作會將、 eventType 和 id 參數的值source寫入為標頭。 數據 eventCache 會寫入為頁尾，輸出數據的本質取決於 屬性的值 TraceOutputOptions 。

另請參閱

• TraceListener
• DefaultTraceListener
• ConsoleTraceListener
• EventLogTraceListener
• TextWriterTraceListener
• Debug
• Trace

TraceEvent(TraceEventCache, String, TraceEventType, Int32, String)

來源:

TraceListener.cs

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

public:
 virtual void TraceEvent(System::Diagnostics::TraceEventCache ^ eventCache, System::String ^ source, System::Diagnostics::TraceEventType eventType, int id, System::String ^ message);

public virtual void TraceEvent (System.Diagnostics.TraceEventCache? eventCache, string source, System.Diagnostics.TraceEventType eventType, int id, string? message);

abstract member TraceEvent : System.Diagnostics.TraceEventCache * string * System.Diagnostics.TraceEventType * int * string -> unit
override this.TraceEvent : System.Diagnostics.TraceEventCache * string * System.Diagnostics.TraceEventType * int * string -> unit

Public Overridable Sub TraceEvent (eventCache As TraceEventCache, source As String, eventType As TraceEventType, id As Integer, message As String)

參數

eventCache

TraceEventCache

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

source

String

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

eventType

TraceEventType

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

id

Int32

事件的數值識別項。

message

String

要寫入的訊息。

備註

重要

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

默認實作會將 、 eventType 和 id 參數的值source寫入為標頭，後面接著message數據。 數據 eventCache 會寫入為頁尾，輸出數據的本質取決於 屬性的值 TraceOutputOptions 。

另請參閱

• TraceListener
• DefaultTraceListener
• ConsoleTraceListener
• EventLogTraceListener
• TextWriterTraceListener
• Debug
• Trace

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

來源:

TraceListener.cs

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

public:
 virtual void TraceEvent(System::Diagnostics::TraceEventCache ^ eventCache, System::String ^ source, System::Diagnostics::TraceEventType eventType, int id, System::String ^ format, ... cli::array <System::Object ^> ^ args);

public virtual void TraceEvent (System.Diagnostics.TraceEventCache? eventCache, string source, System.Diagnostics.TraceEventType eventType, int id, string? format, params object?[]? args);

abstract member TraceEvent : System.Diagnostics.TraceEventCache * string * System.Diagnostics.TraceEventType * int * string * obj[] -> unit
override this.TraceEvent : System.Diagnostics.TraceEventCache * string * System.Diagnostics.TraceEventType * int * string * obj[] -> unit

Public Overridable Sub TraceEvent (eventCache As TraceEventCache, source As String, eventType As TraceEventType, id As Integer, format As String, ParamArray args As Object())

參數

eventCache

TraceEventCache

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

source

String

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

eventType

TraceEventType

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

id

Int32

事件的數值識別項。

format

String

包含零或多個格式項目的格式字串，它與 args 陣列中的物件相對應。

args

Object[]

object 陣列，含有零或多個要格式化的物件。

備註

重要

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

默認實作會將、 eventType 和 id 參數的值source寫入為標頭。 物件 args 陣列會使用 Format 方法轉換成字串，傳遞 format 字串和 args 數位，將字串格式化為追蹤的訊息部分。 數據 eventCache 會寫入為頁尾，輸出數據的本質取決於 屬性的值 TraceOutputOptions 。

另請參閱

• TraceListener
• DefaultTraceListener
• ConsoleTraceListener
• EventLogTraceListener
• TextWriterTraceListener
• Debug
• Trace