LoggingChannel Classe

Définition

Espace de noms:

Windows.Foundation.Diagnostics

Représente une source de messages de journal.

public ref class LoggingChannel 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.ILoggingChannelFactory, 65536, "Windows.Foundation.UniversalApiContract")]
/// [Windows.Foundation.Metadata.Activatable(Windows.Foundation.Diagnostics.ILoggingChannelFactory2, 65536, "Windows.Foundation.UniversalApiContract")]
class LoggingChannel 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.ILoggingChannelFactory), 65536, "Windows.Foundation.UniversalApiContract")]
[Windows.Foundation.Metadata.Activatable(typeof(Windows.Foundation.Diagnostics.ILoggingChannelFactory2), 65536, "Windows.Foundation.UniversalApiContract")]
public sealed class LoggingChannel : System.IDisposable

function LoggingChannel(name, options, id)

Public NotInheritable Class LoggingChannel
Implements IDisposable

Héritage

Object Platform::Object IInspectable LoggingChannel

Attributs

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Implémente

IClosable IDisposable ILoggingChannel 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

LoggingLevel par défaut est Verbose.

Ajoutez des instances LoggingChannel à une Session LoggingSession ou à une FileLoggingSession pour activer la journalisation dans votre application.

Les méthodes LogMessage permettent de journaliser des messages de chaîne simples, tandis que les méthodes LogEvent permettent de journaliser des données de suivi plus complexes.

Windows 10 Deux modes de fonctionnement sont désormais pris en charge : Windows 8.1 mode de compatibilité et le nouveau comportement pris en charge par Windows 10 et versions ultérieures qui vous permet d’enregistrer des événements de suivi d’événements autodéscriptifs pour Windows (ETW) sans manifeste. + Pour Windows 8.1 mode de compatibilité, créez l’objet à l’aide du constructeur LoggingChannel(String).

• Pour un comportement spécifique Windows 10 et ultérieur, créez l’objet à l’aide du constructeur LoggingChannel(String, LoggingChannelOptions) ou LoggingChannel(String, LoggingChannelOptions, GUID). Les différences entre ces deux modes sont les suivantes :

mode de compatibilité Windows 8.1	comportement spécifique Windows 10 et ultérieur
Certains événements **LoggingChannel** peuvent référencer le 4bd2826e-54a1-4ba9-bf63-92b73ea1ac4a, qui est le [GUID](/windows/win32/api/guiddef/ns-guiddef-guid) pour le manifeste **Microsoft-Windows-Diagnostics-LoggingChannel** disponible sur Windows 8.1 ou version ultérieure.	Tous les événements sont autodéclarants. Aucun manifeste n’est requis.
The Constructeurs LoggingChannel(String) Ce constructeur crée un LoggingChannel en mode de compatibilité Windows 8.1. LoggingChannel(String, LoggingChannelOptions) Initialise une nouvelle instance de la classe LoggingChannel avec les options spécifiées. LoggingChannel(String, LoggingChannelOptions, Guid) Initialise une nouvelle instance de la classe LoggingChannel avec les options et l’ID de canal spécifiés. Propriétés Enabled Obtient une valeur qui indique si au moins une session journalisera des événements à partir de ce canal. Id Retourne l’identificateur du fournisseur pour ce canal. Level Obtient le niveau minimal auquel toute session écoute les événements de ce canal. Name Obtient le nom du LoggingChannel actuel. Méthodes Close() Fin de la journalisation sur le canal de journalisation actuel. 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. IsEnabled(LoggingLevel) Indique si au moins une session est à l’écoute des événements avec le niveau de gravité d’événement spécifié à partir du canal. IsEnabled(LoggingLevel, Int64) Indique si au moins une session écoute les événements avec le niveau et les mots clés spécifiés à partir de ce canal. LogEvent(String) Journalise un événement avec le nom spécifié. LogEvent(String, LoggingFields) Journalise un événement avec le nom et les champs spécifiés. LogEvent(String, LoggingFields, LoggingLevel) Enregistre un événement avec le nom, les champs et le niveau spécifiés. LogEvent(String, LoggingFields, LoggingLevel, LoggingOptions) Enregistre un événement avec le nom, les champs, le niveau et les options spécifiés. LogMessage(String) Journalise un message dans le LoggingChannel actuel. LogMessage(String, LoggingLevel) Journalise un message dans le LoggingChannel actuel avec le LoggingLevel spécifié. LogValuePair(String, Int32) Consigne les données dans le LoggingChannel actuel. LogValuePair(String, Int32, LoggingLevel) Journalise les données dans le LoggingChannel actuel avec le LoggingLevel spécifié. 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 les champs spécifiés 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, et 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 . Événements LoggingEnabled Déclenché lorsque le canal de journalisation est attaché à une session LoggingSession ou à d’autres outils de suivi et de débogage d’événements. Voir aussi LoggingSession FileLoggingSession ILoggingChannel IClosable Exemple de journalisation (Windows 10)