LoggingSession クラス

リファレンス

定義

名前空間:: Windows.Foundation.Diagnostics

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 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

継承: 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 では、最新の 260 KB のイベントが記録され、その後、古いイベントの上書きが開始されます。

同じ名前のセッションを複数持つことはできません。さらに、各アプリは合計 4 セッションに制限されます。

コンストラクター

LoggingSession(String)

LoggingSession クラスの新しいインスタンスを初期化します。

プロパティ

Name	ログセッションの名前を取得します。

メソッド

AddLoggingChannel(ILoggingChannel)	現在のログ記録セッションにログチャネルを追加します。
AddLoggingChannel(ILoggingChannel, LoggingLevel)	指定したログレベルのログチャネルを現在のログセッションに追加します。
Close()	現在のログ記録セッションを終了します。
Dispose()	アンマネージリソースの解放またはリセットに関連付けられているアプリケーション定義のタスクを実行します。
RemoveLoggingChannel(ILoggingChannel)	指定したログチャネルを現在のログセッションから削除します。
SaveToFileAsync(IStorageFolder, String)	現在のログセッションをファイルに保存します。

適用対象