Partager via


LoggingSession Classe

Définition

Représente la destination des messages enregistrés à partir d’instances 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
Héritage
Object Platform::Object IInspectable LoggingSession
Attributs
Implémente

Configuration requise pour Windows

Famille d’appareils
Windows 10 (introduit dans 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (introduit dans v1.0)

Remarques

Utilisez la classe LoggingSession pour enregistrer des messages et des données dans une mémoire tampon circulaire en mémoire pendant l’exécution de votre application. Utilisez la méthode SaveToFileAsync pour enregistrer la mémoire tampon dans un fichier. Vous pouvez afficher les fichiers journaux à l’aide de Windows Performance Toolkit (WPT) et d’autres utilitaires tels que tracerpt.exe.

Les instances LoggingSession conservent les messages enregistrés en mémoire jusqu’à ce que la méthode SaveToFileAsync soit appelée. Cela permet l’enregistrement à la demande des événements jusqu’à ce que l’application enregistre les messages en mémoire.

Ajoutez des instances LoggingChannel à une loggingSession et appelez les méthodes LoggingSession instance pour supprimer des canaux, supprimer et effectuer d’autres opérations.

LoggingSession enregistre les 260 Ko d’événements les plus récents, après quoi elle commencera à remplacer les événements plus anciens.

Vous ne pouvez pas avoir plusieurs sessions portant le même nom. En outre, chaque application est limitée à 4 sessions au total.

Constructeurs

LoggingSession(String)

Initialise une nouvelle instance de la classe LoggingSession.

Propriétés

Name

Obtient le nom de la session de journalisation.

Méthodes

AddLoggingChannel(ILoggingChannel)

Ajoute un canal de journalisation à la session de journalisation actuelle.

AddLoggingChannel(ILoggingChannel, LoggingLevel)

Ajoute un canal de journalisation avec le niveau de journalisation spécifié à la session de journalisation actuelle.

Close()

Met fin à la session de journalisation actuelle.

Dispose()

Exécute les tâches définies par l'application associées à la libération ou à la redéfinition des ressources non managées.

RemoveLoggingChannel(ILoggingChannel)

Supprime le canal de journalisation spécifié de la session de journalisation actuelle.

SaveToFileAsync(IStorageFolder, String)

Enregistre la session de journalisation active dans un fichier.

S’applique à

Voir aussi