LoggingActivity Classe

Définition

Espace de noms:

Windows.Foundation.Diagnostics

Crée le suivi d’événements pour les événements Windows (ETW) qui marquent le début et la fin d’un groupe d’événements associés.

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

function LoggingActivity(activityName, loggingChannel, level)

Public NotInheritable Class LoggingActivity
Implements IDisposable

Héritage

Object Platform::Object IInspectable LoggingActivity

Attributs

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Implémente

IClosable IDisposable ILoggingTarget

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

Windows 10 La classe LoggingActivity a été étendue de la manière suivante :+ Maintenant implémente ILoggingTarget qui fournit des méthodes de démarrage et d’arrêt d’activité qui fournissent un contrôle sur le format et le contenu des événements Start et Stop.

• Implémente maintenant des méthodes pour journaliser les événements. Les événements sont automatiquement étiquetés avec le GUID de LoggingActivity.
• Les activités peuvent être imbriquées. Chaque objet LoggingActivity est attaché à un objet LoggingChannel . Tous les événements créés par l’objet LoggingActivity sont écrits via l’objet LoggingChannel attaché.

Constructeurs

LoggingActivity(String, ILoggingChannel)	Initialise une nouvelle instance de la classe LoggingActivity pour le LoggingChannel spécifié en mode de compatibilité Windows 8.1.
LoggingActivity(String, ILoggingChannel, LoggingLevel)	Initialise une nouvelle instance de la classe LoggingActivity pour les éléments LoggingChannel et LoggingLevel spécifiés en mode de compatibilité Windows 8.1.

Propriétés

Channel	Retourne le canal associé à cette activité.
Id	Obtient l’identificateur de l’activité de journalisation actuelle.
Name	Obtient le nom de l’activité de journalisation actuelle.

Méthodes

Close()	Met fin à l’activité 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.
IsEnabled()	Indique si au moins une session écoute les événements du canal associé à cette activité.
IsEnabled(LoggingLevel)	Indique si au moins une session écoute les événements avec le niveau de gravité d’événement spécifié à partir du canal associé à cette activité.
IsEnabled(LoggingLevel, Int64)	Indique si au moins une session écoute les événements avec le niveau et les mots clés spécifiés du canal associé à cette activité.
LogEvent(String)	Consigne un événement portant le nom spécifié.
LogEvent(String, LoggingFields)	Consigne un événement avec le nom et les champs spécifiés.
LogEvent(String, LoggingFields, LoggingLevel)	Consigne un événement avec le nom, les champs et le niveau spécifiés.
LogEvent(String, LoggingFields, LoggingLevel, LoggingOptions)	Consigne un événement avec le nom, les champs, le niveau et les options spécifiés.
StartActivity(String)	Écrit un événement de début d’activité et crée un objet LoggingActivity .
StartActivity(String, LoggingFields)	Écrit un événement de début d’activité avec des champs et crée un objet LoggingActivity .
StartActivity(String, LoggingFields, LoggingLevel)	Écrit un événement de début d’activité avec les champs et le niveau spécifiés, puis crée un objet LoggingActivity .
StartActivity(String, LoggingFields, LoggingLevel, LoggingOptions)	Écrit un événement de début d’activité avec les champs, le niveau et les options spécifiés, et crée un objet LoggingActivity .
StopActivity(String)	Marque l’activité comme fermée/supprimée et génère un événement stop avec le nom d’événement spécifié.
StopActivity(String, LoggingFields)	Marque l’activité comme fermée/supprimée et génère un événement stop avec le nom d’événement et les champs spécifiés.
StopActivity(String, LoggingFields, LoggingOptions)	Marque l’activité comme fermée/supprimée et génère un événement stop avec le nom d’événement, les champs et les options spécifiés.

Voir aussi

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