LoggingActivity 类

定义

命名空间:

Windows.Foundation.Diagnostics

创建 Windows (ETW 的事件跟踪) 事件，用于标记一组相关事件的开始和结束。

public ref class LoggingActivity 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.ILoggingActivityFactory, 65536, "Windows.Foundation.UniversalApiContract")]
class LoggingActivity 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.ILoggingActivityFactory), 65536, "Windows.Foundation.UniversalApiContract")]
public sealed class LoggingActivity : System.IDisposable

function LoggingActivity(activityName, loggingChannel, level)

Public NotInheritable Class LoggingActivity
Implements IDisposable

继承

Object Platform::Object IInspectable LoggingActivity

属性

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

实现

IClosable IDisposable ILoggingTarget

Windows 要求

设备系列	Windows 10 (在 10.0.10240.0 中引入)
API contract	Windows.Foundation.UniversalApiContract (在 v1.0 中引入)

注解

Windows 10LoggingActivity 类已通过以下方式进行了扩展：+ Now 实现 ILoggingTarget，它提供活动开始和停止方法，这些方法提供对 Start 和 Stop 事件的格式和内容的控制。

• 现在实现用于记录事件的方法。 使用 LoggingActivity 的 GUID 自动标记事件。
• 活动可以嵌套。 每个 LoggingActivity 对象都附加到 LoggingChannel 对象。 LoggingActivity 对象创建的所有事件都通过附加的 LoggingChannel 对象写入。

构造函数

LoggingActivity(String, ILoggingChannel)	在兼容模式下为指定的 LoggingChannel 初始化 LoggingActivity 类的新实例Windows 8.1。
LoggingActivity(String, ILoggingChannel, LoggingLevel)	在兼容模式下为指定的 LoggingChannel 和 LoggingLevel 初始化 LoggingActivity 类的新实例Windows 8.1。

属性

Channel	返回与此活动关联的通道。
Id	获取当前日志记录活动的标识符。
Name	获取当前日志记录活动的名称。

方法

Close()	结束当前日志记录活动。
Dispose()	执行与释放或重置非托管资源关联的应用程序定义的任务。
IsEnabled()	指示是否至少有一个会话正在侦听与此活动关联的通道中的事件。
IsEnabled(LoggingLevel)	指示是否至少有一个会话从与此活动关联的通道侦听具有指定事件严重性级别的事件。
IsEnabled(LoggingLevel, Int64)	指示是否至少有一个会话正在侦听具有指定级别和关键字的事件，这些事件来自与此活动关联的通道。
LogEvent(String)	记录具有指定名称的事件。
LogEvent(String, LoggingFields)	记录具有指定名称和字段的事件。
LogEvent(String, LoggingFields, LoggingLevel)	记录具有指定名称、字段和级别的事件。
LogEvent(String, LoggingFields, LoggingLevel, LoggingOptions)	记录具有指定名称、字段、级别和选项的事件。
StartActivity(String)	写入活动开始事件并创建 LoggingActivity 对象。
StartActivity(String, LoggingFields)	使用字段写入活动开始事件，并创建 LoggingActivity 对象。
StartActivity(String, LoggingFields, LoggingLevel)	写入具有指定字段和级别的活动开始事件，并创建 LoggingActivity 对象。
StartActivity(String, LoggingFields, LoggingLevel, LoggingOptions)	使用指定的字段、级别和选项写入活动开始事件，并创建 LoggingActivity 对象。
StopActivity(String)	将活动标记为已关闭/已释放，并生成具有指定事件名称的停止事件。
StopActivity(String, LoggingFields)	将活动标记为已关闭/已释放，并生成具有指定事件名称和字段的停止事件。
StopActivity(String, LoggingFields, LoggingOptions)	将活动标记为已关闭/已释放，并使用指定的事件名称、字段和选项生成停止事件。

另请参阅

• IClosable
• LoggingChannel
• ILoggingTarget
• 日志记录示例 (Windows 10)