LoggingChannel Klasse

Referenz

Definition

Namespace:: Windows.Foundation.Diagnostics

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Bearbeiten

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: ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Implementiert: IClosable IDisposable ILoggingChannel ILoggingTarget

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.

Erstellen Sie für Windows 10 und höher spezifisches Verhalten das Objekt mithilfe des LoggingChannel(String, LoggingChannelOptions) oder LoggingChannel(String, LoggingChannelOptions, Guid)-Konstruktors. Die Unterschiede zwischen diesen beiden Modi sind:

Windows 8.1 Kompatibilitätsmodus

Windows 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:

Freigeben über