LoggingSession 类

定义

命名空间:

Windows.Foundation.Diagnostics

表示来自 LoggingChannel 实例的已记录消息的目标。

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

function LoggingSession(name)

Public NotInheritable Class LoggingSession
Implements IDisposable, ILoggingSession

继承

Object Platform::Object IInspectable LoggingSession

属性

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

实现

IClosable IDisposable ILoggingSession

Windows 要求

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

注解

在应用运行时，使用 LoggingSession 类将消息和数据记录到内存中循环缓冲区。 使用 SaveToFileAsync 方法将缓冲区保存到文件。 可以使用 Windows Performance Toolkit (WPT) 和其他实用工具（如 tracerpt.exe）查看日志文件。

LoggingSession 实例将记录的消息保留在内存中，直到调用 SaveToFileAsync 方法。 这样就可以按需保存事件，直到应用保存内存中消息。

将 LoggingChannel 实例添加到 LoggingSession，并调用 LoggingSession 实例方法以删除通道、释放和执行其他操作。

LoggingSession 记录最近的 260KB 事件，之后它将开始覆盖较旧的事件。

不能有多个同名的会话。 此外，每个应用总共只能有 4 个会话。

构造函数

LoggingSession(String)

初始化 LoggingSession 类的新实例。

属性

Name	获取日志记录会话的名称。

方法

AddLoggingChannel(ILoggingChannel)	将日志记录通道添加到当前日志记录会话。
AddLoggingChannel(ILoggingChannel, LoggingLevel)	将具有指定日志记录级别的日志记录通道添加到当前日志记录会话。
Close()	结束当前日志记录会话。
Dispose()	执行与释放或重置非托管资源关联的应用程序定义的任务。
RemoveLoggingChannel(ILoggingChannel)	从当前日志记录会话中删除指定的日志记录通道。
SaveToFileAsync(IStorageFolder, String)	将当前日志记录会话保存到文件中。

另请参阅

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