TraceSource.TraceEvent 方法

定義

命名空間:

System.Diagnostics

組件:

System.Diagnostics.TraceSource.dll

將追蹤事件訊息寫入 Listeners 集合中的追蹤接聽程式。

多載

TraceEvent(TraceEventType, Int32)	使用指定的事件類型和事件識別項，將追蹤事件訊息寫入 Listeners 集合中的追蹤接聽程式。
TraceEvent(TraceEventType, Int32, String)	使用指定的事件類型、事件識別項和訊息，將追蹤事件訊息寫入 Listeners 集合中的追蹤接聽程式。
TraceEvent(TraceEventType, Int32, String, Object[])	使用指定的事件類型、事件識別項和引數陣列與格式，將追蹤事件寫入 Listeners 集合中的追蹤接聽程式。

TraceEvent(TraceEventType, Int32)

來源:

TraceSource.cs

使用指定的事件類型和事件識別項，將追蹤事件訊息寫入 Listeners 集合中的追蹤接聽程式。

public:
 void TraceEvent(System::Diagnostics::TraceEventType eventType, int id);

[System.Diagnostics.Conditional("TRACE")]
public void TraceEvent (System.Diagnostics.TraceEventType eventType, int id);

[<System.Diagnostics.Conditional("TRACE")>]
member this.TraceEvent : System.Diagnostics.TraceEventType * int -> unit

Public Sub TraceEvent (eventType As TraceEventType, id As Integer)

參數

eventType

TraceEventType

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

id

Int32

事件的數值識別項。

屬性

ConditionalAttribute

例外狀況

ObjectDisposedException

嘗試在最終處理期間追蹤事件。

範例

下列程式代碼範例示範如何使用 TraceEvent(TraceEventType, Int32) 方法將追蹤事件傳遞至接聽程式。 此程式代碼範例是提供給 類別之較大範例的 TraceSource 一部分。

ts.TraceEvent(TraceEventType.Warning, 1);

ts.TraceEvent(TraceEventType.Warning, 1)

備註

方法 TraceEvent 旨在追蹤可由工具自動處理的事件。 例如，監視工具可以在特定來源追蹤特定事件時通知系統管理員。

方法TraceEvent會ShouldTrace呼叫 屬性所Switch傳回之 物件的 方法SourceSwitch。 如果 ShouldTrace 傳 true回 ， TraceEvent 則呼叫每個接聽程式的對應 TraceEvent 方法。 否則會 TraceEvent 傳回 ，而不呼叫接聽程式的方法。

追蹤內容是特定接聽程式。 如果接聽程式實作未覆寫方法，則默認輸出會是追蹤來源的名稱、其數值識別和事件類型。 其他追蹤內容取決於接聽程式的 TraceOutputOptions 屬性值。

注意

物件 EventLogTraceListener 限制為最大值 id 65,535。 id如果指定的值大於 65,535，則 EventLogTraceListener 會使用 65,535。

TraceEvent(TraceEventType, Int32, String)

來源:

TraceSource.cs

使用指定的事件類型、事件識別項和訊息，將追蹤事件訊息寫入 Listeners 集合中的追蹤接聽程式。

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

[System.Diagnostics.Conditional("TRACE")]
public void TraceEvent (System.Diagnostics.TraceEventType eventType, int id, string? message);

[<System.Diagnostics.Conditional("TRACE")>]
member this.TraceEvent : System.Diagnostics.TraceEventType * int * string -> unit

Public Sub TraceEvent (eventType As TraceEventType, id As Integer, message As String)

參數

eventType

TraceEventType

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

id

Int32

事件的數值識別項。

message

String

要寫入的追蹤訊息。

屬性

ConditionalAttribute

例外狀況

ObjectDisposedException

嘗試在最終處理期間追蹤事件。

範例

下列程式代碼範例示範如何使用 TraceEvent(TraceEventType, Int32) 方法將追蹤事件傳遞至接聽程式。 此程式代碼範例是提供給 類別之較大範例的 TraceSource 一部分。

// Issue file not found message as a warning.
ts.TraceEvent(TraceEventType.Warning, 2, "File Test not found");

' Issue file not found message as a warning.
ts.TraceEvent(TraceEventType.Warning, 2, "File Test not found")

備註

方法 TraceEvent 旨在追蹤可由工具自動處理的事件。 例如，監視工具可以在特定來源追蹤特定事件時通知系統管理員。

方法TraceEvent會ShouldTrace呼叫 屬性所Switch傳回之 物件的 方法SourceSwitch。 如果 ShouldTrace 傳 true回 ， TraceEvent 則呼叫每個接聽程式的對應 TraceEvent 方法。 否則會 TraceEvent 傳回 ，而不呼叫接聽程式的方法。

追蹤內容是特定接聽程式。 如果接聽程式實作未覆寫方法，默認輸出會是追蹤來源的名稱、其數值識別、事件類型和訊息。 其他追蹤內容取決於接聽程式的 TraceOutputOptions 屬性值。

注意

物件 EventLogTraceListener 限制為最大值 id 65,535。 id如果指定的值大於 65,535，則EventLogTraceListener物件會使用 65,535。

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

來源:

TraceSource.cs

使用指定的事件類型、事件識別項和引數陣列與格式，將追蹤事件寫入 Listeners 集合中的追蹤接聽程式。

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

[System.Diagnostics.Conditional("TRACE")]
public void TraceEvent (System.Diagnostics.TraceEventType eventType, int id, string? format, params object?[]? args);

[<System.Diagnostics.Conditional("TRACE")>]
member this.TraceEvent : System.Diagnostics.TraceEventType * int * string * obj[] -> unit

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

參數

eventType

TraceEventType

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

id

Int32

事件的數值識別項。

format

String

複合格式字串，其中包含混合零或多個格式項目的文字，並與 args 陣列中的物件相對應。

args

Object[]

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

屬性

ConditionalAttribute

例外狀況

ArgumentNullException

format 為 null。

FormatException

format 無效。

-或-

用來指示要格式化的引數的數目小於零，或者大於或等於要格式化的指定物件數目。

ObjectDisposedException

嘗試在最終處理期間追蹤事件。

範例

下列程式代碼範例示範如何使用 TraceEvent(TraceEventType, Int32) 方法將追蹤事件傳遞至接聽程式。 此程式代碼範例是提供給 類別之較大範例的 TraceSource 一部分。

// Issue file not found message as a verbose event using a formatted string.
ts.TraceEvent(TraceEventType.Verbose, 3, "File {0} not found.", "test");

' Issue file not found message as a verbose event using a formatted string.
ts.TraceEvent(TraceEventType.Verbose, 3, "File {0} not found.", "test")

備註

如需 參數的詳細資訊 format ，請參閱 複合格式設定。

方法 TraceEvent 旨在追蹤可由工具自動處理的事件。 例如，監視工具可以在特定來源追蹤特定事件時通知系統管理員。

方法TraceEvent會ShouldTrace呼叫 屬性所Switch傳回之 物件的 方法SourceSwitch。 如果 ShouldTrace 傳 true回 ， TraceEvent 則呼叫每個接聽程式的對應 TraceEvent 方法。 否則會 TraceEvent 傳回 ，而不呼叫接聽程式的方法。

追蹤內容是特定接聽程式。 默認 TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[]) 方法會在追蹤標頭中寫入來源名稱、事件類型和數值識別，然後呼叫 String.Format(IFormatProvider, String, Object[]) 方法、傳遞 format 字串和 args 陣列，並使用 CultureInfo.InvariantCulture 屬性將字串格式化為訊息輸出。

注意

物件 EventLogTraceListener 限制為最大值 id 65,535。 id如果指定的值大於 65,535，則EventLogTraceListener物件會使用 65,535。

另請參閱

• 複合格式
• 標準數值格式字串
• Custom Numeric Format Strings
• 標準 DateTime 格式字串
• 自訂 DateTime 格式字串
• Enumeration Format Strings
• 在 .NET 中將類型格式化