LoggingSession Classe

Définition

Espace de noms:

Windows.Foundation.Diagnostics

Représente la destination des messages enregistrés à partir d’instances 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

Héritage

Object Platform::Object IInspectable LoggingSession

Attributs

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Implémente

IClosable IDisposable ILoggingSession

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.

Voir aussi

• LoggingChannel
• ILoggingSession
• IClosable
• Exemple de journalisation (Windows 10)