TraceSource.TraceInformation 方法

定義

命名空間:

System.Diagnostics

組件:

System.Diagnostics.TraceSource.dll

將告知性訊息寫入 Listeners 集合中的追蹤接聽程式。

多載

TraceInformation(String)	使用指定的訊息，將告知性訊息寫入 Listeners 集合中的追蹤接聽程式。
TraceInformation(String, Object[])	使用指定的物件陣列和格式化資訊，將告知性訊息寫入 Listeners 集合中的追蹤接聽程式。

TraceInformation(String)

來源:

TraceSource.cs

使用指定的訊息，將告知性訊息寫入 Listeners 集合中的追蹤接聽程式。

C#

[System.Diagnostics.Conditional("TRACE")]
public void TraceInformation (string? message);

參數

message

String

要寫入的資訊訊息。

屬性

ConditionalAttribute

例外狀況

ObjectDisposedException

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

備註

方法 TraceInformation 提供一則資訊訊息，供使用者讀取，而不是由工具讀取。

TraceInformation(String) TraceEvent(TraceEventType, Int32, String)呼叫 方法，將 設定eventType為 TraceEventType.Information ，並將資訊訊息傳遞為訊息字串。 方法 TraceEvent(TraceEventType, Int32, String) 接著會呼叫 TraceEvent(TraceEventCache, String, TraceEventType, Int32, String) 每個追蹤接聽程式的方法。

TraceInformation(String, Object[])

來源:

TraceSource.cs

使用指定的物件陣列和格式化資訊，將告知性訊息寫入 Listeners 集合中的追蹤接聽程式。

C#

[System.Diagnostics.Conditional("TRACE")]
public void TraceInformation (string? format, params object?[]? args);

參數

format

String

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

args

Object[]

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

屬性

ConditionalAttribute

例外狀況

ArgumentNullException

format 為 null。

FormatException

format 無效。

-或-

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

ObjectDisposedException

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

備註

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

方法 TraceInformation 提供一則資訊訊息，供使用者讀取，而不是由工具讀取。

TraceInformation(String, Object[]) TraceEvent(TraceEventType, Int32, String, Object[])會呼叫 方法，並將訊息內容設定eventTypeTraceEventType.Information為具有格式信息的物件數位。 方法 TraceEvent(TraceEventType, Int32, String, Object[]) 接著會呼叫 TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[]) 每個追蹤接聽程式的方法。

另請參閱

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