Freigeben über


LoggingChannel Klasse

Definition

Stellt eine Quelle von Protokollmeldungen dar.

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
Vererbung
Object Platform::Object IInspectable LoggingChannel
Attribute
Implementiert

Windows-Anforderungen

Gerätefamilie
Windows 10 (eingeführt in 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (eingeführt in v1.0)

Hinweise

Der Standardmäßige LoggingLevel ist Ausführlich.

Fügen Sie LoggingChannel-Instanzen zu einer LoggingSession oder einer FileLoggingSession hinzu, um die Protokollierung in Ihrer App zu aktivieren.

Die LogMessage-Methoden bieten Möglichkeiten, einfache Zeichenfolgenmeldungen zu protokollieren, während die LogEvent-Methoden Möglichkeiten zum Protokollieren komplexerer Ablaufverfolgungsdaten bieten.

Windows 10 Zwei Betriebsmodi werden jetzt unterstützt: Windows 8.1 Kompatibilitätsmodus und das neue Verhalten, das von Windows 10 und höher unterstützt wird, mit dem Sie selbstbeschreibende Ereignisse der Ereignisablaufverfolgung für Windows (ETW) ohne Manifest protokollieren können. + Erstellen Sie für Windows 8.1 Kompatibilitätsmodus das Objekt mithilfe des LoggingChannel(String)-Konstruktors.

Windows 8.1 KompatibilitätsmodusWindows 10 und höher spezifisches Verhalten
Einige **LoggingChannel**-Ereignisse verweisen möglicherweise auf die 4bd2826e-54a1-4ba9-bf63-92b73ea1ac4a, bei der es sich um die [GUID](/windows/win32/api/guiddef/ns-guiddef-guid-guid) für das Manifest **Microsoft-Windows-Diagnostics-LoggingChannel** handelt, das auf Windows 8.1 oder höher verfügbar ist.Alle Ereignisse sind selbstbeschreibend. Es ist kein Manifest erforderlich.
The

Konstruktoren

LoggingChannel(String)

Dieser Konstruktor erstellt einen LoggingChannel im Kompatibilitätsmodus Windows 8.1.

LoggingChannel(String, LoggingChannelOptions)

Initialisiert eine neue instance der LoggingChannel-Klasse mit den angegebenen Optionen.

LoggingChannel(String, LoggingChannelOptions, Guid)

Initialisiert einen neuen instance der LoggingChannel-Klasse mit den angegebenen Optionen und der angegebenen Kanal-ID.

Eigenschaften

Enabled

Ruft einen Wert ab, der angibt, ob mindestens eine Sitzung Ereignisse aus diesem Kanal protokolliert.

Id

Gibt den Anbieterbezeichner für diesen Kanal zurück.

Level

Ruft die Mindestebene ab, auf der jede Sitzung Ereignisse aus diesem Kanal lauscht.

Name

Ruft den Namen des aktuellen LoggingChannel ab.

Methoden

Close()

Beendet die Protokollierung im aktuellen Protokollierungskanal.

Dispose()

Führt anwendungsspezifische Aufgaben durch, die mit der Freigabe, der Zurückgabe oder dem Zurücksetzen von nicht verwalteten Ressourcen zusammenhängen.

IsEnabled()

Gibt an, ob mindestens eine Sitzung auf Ereignisse aus dem Kanal lauscht.

IsEnabled(LoggingLevel)

Gibt an, ob mindestens eine Sitzung auf Ereignisse mit dem angegebenen Ereignisschweregrad aus dem Kanal lauscht.

IsEnabled(LoggingLevel, Int64)

Gibt an, ob mindestens eine Sitzung auf Ereignisse mit der angegebenen Ebene und Schlüsselwörtern aus diesem Kanal lauscht.

LogEvent(String)

Protokolliert ein Ereignis mit dem angegebenen Namen.

LogEvent(String, LoggingFields)

Protokolliert ein Ereignis mit dem angegebenen Namen und den angegebenen Feldern.

LogEvent(String, LoggingFields, LoggingLevel)

Protokolliert ein Ereignis mit dem angegebenen Namen, den angegebenen Feldern und der angegebenen Ebene.

LogEvent(String, LoggingFields, LoggingLevel, LoggingOptions)

Protokolliert ein Ereignis mit dem angegebenen Namen, den angegebenen Feldern, der angegebenen Ebene und den angegebenen Optionen.

LogMessage(String)

Protokolliert eine Nachricht an den aktuellen LoggingChannel.

LogMessage(String, LoggingLevel)

Protokolliert eine Nachricht beim aktuellen LoggingChannel mit dem angegebenen LoggingLevel.

LogValuePair(String, Int32)

Protokolliert Daten im aktuellen LoggingChannel.

LogValuePair(String, Int32, LoggingLevel)

Protokolliert Daten im aktuellen LoggingChannel mit dem angegebenen LoggingLevel.

StartActivity(String)

Schreibt ein Aktivitätsstartereignis und erstellt ein LoggingActivity-Objekt .

StartActivity(String, LoggingFields)

Schreibt ein Aktivitätsstartereignis mit den angegebenen Feldern und erstellt ein LoggingActivity-Objekt .

StartActivity(String, LoggingFields, LoggingLevel)

Schreibt ein Aktivitätsstartereignis mit den angegebenen Feldern und der angegebenen Ebene und erstellt ein LoggingActivity-Objekt .

StartActivity(String, LoggingFields, LoggingLevel, LoggingOptions)

Schreibt ein Aktivitätsstartereignis mit den angegebenen Feldern, Ebenen und Optionen und erstellt ein LoggingActivity-Objekt .

Ereignisse

LoggingEnabled

Wird ausgelöst, wenn der Protokollierungskanal an eine LoggingSession oder andere Ereignisablaufverfolgungs- und Debugtools angefügt wird.

Gilt für:

Weitere Informationen