LoggingSession 类
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
表示来自 LoggingChannel 实例的已记录消息的目标。
public ref class LoggingSession sealed : ILoggingSession, IClosable
/// [Windows.Foundation.Metadata.Activatable(Windows.Foundation.Diagnostics.ILoggingSessionFactory, 65536, Windows.Foundation.UniversalApiContract)]
/// [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)]
class LoggingSession final : 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.Activatable(typeof(Windows.Foundation.Diagnostics.ILoggingSessionFactory), 65536, typeof(Windows.Foundation.UniversalApiContract))]
[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)]
public sealed class LoggingSession : System.IDisposable, ILoggingSession
[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
- 继承
- 属性
- 实现
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) |
将当前日志记录会话保存到文件中。 |