LoggingChannel 類別

定義

命名空間:

Windows.Foundation.Diagnostics

表示記錄訊息的來源。

public ref class LoggingChannel sealed : IClosable

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.Activatable(Windows.Foundation.Diagnostics.ILoggingChannelFactory, 65536, "Windows.Foundation.UniversalApiContract")]
/// [Windows.Foundation.Metadata.Activatable(Windows.Foundation.Diagnostics.ILoggingChannelFactory2, 65536, "Windows.Foundation.UniversalApiContract")]
class LoggingChannel final : IClosable

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.Activatable(typeof(Windows.Foundation.Diagnostics.ILoggingChannelFactory), 65536, "Windows.Foundation.UniversalApiContract")]
[Windows.Foundation.Metadata.Activatable(typeof(Windows.Foundation.Diagnostics.ILoggingChannelFactory2), 65536, "Windows.Foundation.UniversalApiContract")]
public sealed class LoggingChannel : System.IDisposable

function LoggingChannel(name, options, id)

Public NotInheritable Class LoggingChannel
Implements IDisposable

繼承

Object Platform::Object IInspectable LoggingChannel

屬性

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

實作

IClosable IDisposable ILoggingChannel ILoggingTarget

Windows 需求

裝置系列	Windows 10 (已於 10.0.10240.0 引進)
API contract	Windows.Foundation.UniversalApiContract (已於 v1.0 引進)

備註

預設 LoggingLevel 為 Verbose。

將 LoggingChannel 實例新增至 LoggingSession 或 FileLoggingSession ，以在應用程式中啟用記錄。

LogMessage方法提供記錄簡單字串訊息的方式，而 LogEvent方法則提供記錄更複雜的追蹤資料的方法。

Windows 10現在支援兩種作業模式：Windows 8.1相容性模式和Windows 10和更新版本支援的新行為，可讓您記錄 Windows (ETW) 事件自我描述的事件追蹤，而不需要資訊清單。 + 針對Windows 8.1相容性模式，請使用LoggingChannel (String) 建構函式建立物件。

• 如需Windows 10和更新版本的特定行為，請使用LoggingChannel (String、LoggingChannelOptions) 或LoggingChannel (String、LoggingChannelOptions、Guid) 建構函式來建立 物件。 這兩種模式之間的差異如下：

Windows 8.1相容性模式	Windows 10和更新版本的特定行為
某些 **LoggingChannel** 事件可能會參考 4bd2826e-54a1-4ba9-bf63-92b73ea1ac4a，也就是 [GUID] (/windows/win32/api/guiddef/ns-guiddef-guid) ，適用于Windows 8.1或更新版本的 **Microsoft-Windows-Diagnostics-LoggingChannel** 資訊清單。	所有事件都是自我描述的。 不需要任何資訊清單。
此 建構函式 LoggingChannel(String) 此建構函式會在Windows 8.1相容性模式中建立LoggingChannel。 LoggingChannel(String, LoggingChannelOptions) 使用指定的選項，初始化 LoggingChannel 類別的新實例。 LoggingChannel(String, LoggingChannelOptions, Guid) 使用指定的選項和通道識別碼，初始化 LoggingChannel 類別的新實例。 屬性 Enabled 取得值，這個值表示至少一個會話是否記錄來自這個通道的事件。 Id 傳回這個通道的提供者識別碼。 Level 取得任何會話從這個通道接聽事件的最低層級。 Name 取得目前 LoggingChannel的名稱。 方法 Close() 結束目前記錄通道上的記錄。 Dispose() 執行與釋放 (Free)、釋放 (Release) 或重設 Unmanaged 資源相關聯之應用程式定義的工作。 IsEnabled() 指出至少有一個會話正在接聽來自通道的事件。 IsEnabled(LoggingLevel) 指出至少有一個會話正在接聽信道中具有指定事件嚴重性層級的事件。 IsEnabled(LoggingLevel, Int64) 指出至少有一個會話正在接聽來自這個通道的指定層級和關鍵字的事件。 LogEvent(String) 記錄具有指定名稱的事件。 LogEvent(String, LoggingFields) 記錄具有指定名稱和欄位的事件。 LogEvent(String, LoggingFields, LoggingLevel) 記錄具有指定名稱、欄位和層級的事件。 LogEvent(String, LoggingFields, LoggingLevel, LoggingOptions) 記錄具有指定名稱、欄位、層級和選項的事件。 LogMessage(String) 將訊息記錄至目前的 LoggingChannel。 LogMessage(String, LoggingLevel) 使用指定的LoggingLevel，將訊息記錄至目前的LoggingChannel。 LogValuePair(String, Int32) 將資料記錄到目前的 LoggingChannel。 LogValuePair(String, Int32, LoggingLevel) 使用指定的LoggingLevel將資料記錄至目前的LoggingChannel。 StartActivity(String) 寫入活動開始事件，並建立 LoggingActivity 物件。 StartActivity(String, LoggingFields) 使用指定的欄位寫入活動開始事件，並建立 LoggingActivity 物件。 StartActivity(String, LoggingFields, LoggingLevel) 寫入具有指定欄位和層級的活動開始事件，並建立 LoggingActivity 物件。 StartActivity(String, LoggingFields, LoggingLevel, LoggingOptions) 寫入具有指定欄位、層級和選項的活動開始事件，並建立 LoggingActivity 物件。 事件 LoggingEnabled 當記錄通道附加至 LoggingSession 或其他事件追蹤和偵錯工具時引發。 另請參閱 LoggingSession FileLoggingSession ILoggingChannel IClosable 記錄範例 (Windows 10)