FileLogTraceListener.TraceEvent 方法

定義

命名空間:

Microsoft.VisualBasic.Logging

組件:

Microsoft.VisualBasic.Forms.dll

將追蹤和事件資訊寫入輸出檔或資料流。

多載

TraceEvent(TraceEventCache, String, TraceEventType, Int32, String)	將追蹤資訊、訊息和事件資訊寫入至輸出檔或資料流。
TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[])	寫入追蹤資訊、格式化的物件陣列，及事件資訊至輸出檔或資料流。

備註

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

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

將追蹤資訊、訊息和事件資訊寫入至輸出檔或資料流。

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

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

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

Public Overrides 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

要寫入的訊息。

備註

這個方法：

1. 格式化輸出的數據和內容資訊。

2. 視需要建立新的記錄檔。

3. 將資訊寫入記錄檔。

如需建立新記錄檔的詳細資訊，請參閱 FullLogFileName。

下表會依顯示的順序列出輸出欄位。 欄位是以 屬性指定的字串 Delimiter 分隔，後面接著行終止符。

欄位	輸出條件	說明
source	永遠。	name 的值。
severity	永遠。	的 eventType列舉值名稱。
id	永遠。	id 的字串表示。
message	永遠。	message 的值。
callStack	Callstack在屬性中設定 旗標時TraceOutputOptions。	Callstack的eventCache屬性。
CorrelationID	LogicalOperationStack在屬性中設定 旗標時TraceOutputOptions。	ThreadId的eventCache屬性。
DateTime	DateTime在屬性中設定 旗標時TraceOutputOptions。	之屬性的DateTimeeventCache字串表示。 不因文化特性而用於字串轉換。
ProcessID	ProcessId在屬性中設定 旗標時TraceOutputOptions。	之屬性的ProcessIdeventCache字串表示。 不因文化特性而用於字串轉換。
ThreadID	ThreadId在屬性中設定 旗標時TraceOutputOptions。	ThreadId的eventCache屬性。
Timestamp	Timestamp在屬性中設定 旗標時TraceOutputOptions。	之屬性的TimestampeventCache字串表示。 不因文化特性而用於字串轉換。
HostName	IncludeHostName當屬性為 True時。	電腦的名稱。

另請參閱

• TraceListener
• FullLogFileName
• TraceOutputOptions
• TraceEventCache
• TraceEventType

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

寫入追蹤資訊、格式化的物件陣列，及事件資訊至輸出檔或資料流。

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

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

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

Public Overrides 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 陣列，含有零或多個要格式化的物件。

備註

這個方法：

1. 格式化輸出的數據和內容資訊。

2. 視需要建立新的記錄檔。

3. 將資訊寫入記錄檔。

如需建立新記錄檔的詳細資訊，請參閱 FullLogFileName。

下表會依顯示的順序列出輸出欄位。 欄位是以 屬性指定的字串 Delimiter 分隔，後面接著行終止符。

欄位	輸出條件	說明
source	一律	name 的值。
severity	一律	的 eventType列舉值名稱。
id	一律	id 的字串表示。
message	一律	以format字串格式化的數據args，並使用字串轉換的非變異文化特性。
callStack	Callstack在屬性中設定 旗標時TraceOutputOptions。	Callstack的eventCache屬性。
CorrelationID	LogicalOperationStack在屬性中設定 旗標時TraceOutputOptions。	ThreadId的eventCache屬性。
DateTime	DateTime在屬性中設定 旗標時TraceOutputOptions。	之屬性的DateTimeeventCache字串表示。 不因文化特性而用於字串轉換。
ProcessID	ProcessId在屬性中設定 旗標時TraceOutputOptions。	之屬性的ProcessIdeventCache字串表示。 不因文化特性而用於字串轉換。
ThreadID	ThreadId在屬性中設定 旗標時TraceOutputOptions。	ThreadId的eventCache屬性。
Timestamp	Timestamp在屬性中設定 旗標時TraceOutputOptions。	之屬性的TimestampeventCache字串表示。 不因文化特性而用於字串轉換。
HostName	IncludeHostName當屬性為 True時。	電腦的名稱。

另請參閱

• TraceListener
• FullLogFileName
• TraceOutputOptions
• TraceEventCache
• TraceEventType