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 8.1 或更高版本上提供的 Microsoft-Windows-Diagnostics-LoggingChannel 清单的 /windows/win32/api/guiddef/ns-guiddef-guid-guid) 。	所有事件都是自我描述的。 不需要任何清单。
The 构造函数 LoggingChannel(String) 此构造函数在Windows 8.1兼容模式下创建 LoggingChannel。 LoggingChannel(String, LoggingChannelOptions) 使用指定的选项初始化 LoggingChannel 类的新实例。 LoggingChannel(String, LoggingChannelOptions, Guid) 使用指定的选项和通道 ID 初始化 LoggingChannel 类的新实例。 属性 Enabled 获取一个值，该值指示是否至少有一个会话记录来自此通道的事件。 Id 返回此通道的提供程序标识符。 Level 获取任何会话侦听来自此通道的事件的最低级别。 Name 获取当前 LoggingChannel 的名称。 方法 Close() 结束当前日志记录通道上的日志记录。 Dispose() 执行与释放或重置非托管资源关联的应用程序定义的任务。 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)