Partager via


LoggingChannel Classe

Définition

Représente une source de messages de journal.

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

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).

mode de compatibilité Windows 8.1comportement 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.

S’applique à

Voir aussi