LoggingActivity Klasse

Definition

Namespace:

Windows.Foundation.Diagnostics

Erstellt ETW-Ereignisse (Event Tracing for Windows), die den Anfang und das Ende einer Gruppe verwandter Ereignisse markieren.

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

Vererbung

Object Platform::Object IInspectable LoggingActivity

Attribute

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Implementiert

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

Windows 10 Die LoggingActivity-Klasse wurde auf folgende Weise erweitert:+ Implementiert jetzt ILoggingTarget, das Methoden zum Starten und Beenden von Aktivitäten bereitstellt, die Kontrolle über das Format und den Inhalt der Ereignisse Start und Stop bieten.

• Implementiert nun Methoden zum Protokollieren von Ereignissen. Ereignisse werden automatisch mit der GUID der LoggingActivity markiert.
• Aktivitäten können geschachtelt werden. Jedes LoggingActivity-Objekt wird an ein LoggingChannel-Objekt angefügt. Alle vom LoggingActivity-Objekt erstellten Ereignisse werden über das angefügte LoggingChannel-Objekt geschrieben.

Konstruktoren

LoggingActivity(String, ILoggingChannel)	Initialisiert eine neue instance der LoggingActivity-Klasse für den angegebenen LoggingChannel im Windows 8.1 Kompatibilitätsmodus.
LoggingActivity(String, ILoggingChannel, LoggingLevel)	Initialisiert eine neue instance der LoggingActivity-Klasse für den angegebenen LoggingChannel und LoggingLevel im Windows 8.1 Kompatibilitätsmodus.

Eigenschaften

Channel	Gibt den Kanal zurück, der dieser Aktivität zugeordnet ist.
Id	Ruft den Bezeichner für die aktuelle Protokollierungsaktivität ab.
Name	Ruft den Namen der aktuellen Protokollierungsaktivität ab.

Methoden

Close()	Beendet die aktuelle Protokollierungsaktivität.
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, der dieser Aktivität zugeordnet ist.
IsEnabled(LoggingLevel)	Gibt an, ob mindestens eine Sitzung auf Ereignisse mit dem angegebenen Ereignisschweregrad aus dem Kanal lauscht, der dieser Aktivität zugeordnet ist.
IsEnabled(LoggingLevel, Int64)	Gibt an, ob mindestens eine Sitzung auf Ereignisse mit der angegebenen Ebene und Schlüsselwörtern aus dem Kanal lauscht, der dieser Aktivität zugeordnet ist.
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 ebene und den angegebenen Optionen.
StartActivity(String)	Schreibt ein Aktivitätsstartereignis und erstellt ein LoggingActivity-Objekt .
StartActivity(String, LoggingFields)	Schreibt ein Aktivitätsstartereignis mit 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 .
StopActivity(String)	Markiert die Aktivität als geschlossen/verworfen und generiert ein Stoppereignis mit dem angegebenen Ereignisnamen.
StopActivity(String, LoggingFields)	Markiert die Aktivität als geschlossen/verworfen und generiert ein Stoppereignis mit dem angegebenen Ereignisnamen und den angegebenen Feldern.
StopActivity(String, LoggingFields, LoggingOptions)	Markiert die Aktivität als geschlossen/verworfen und generiert ein Stoppereignis mit dem angegebenen Ereignisnamen, Feldern und Optionen.

Weitere Informationen

• IClosable
• LoggingChannel
• ILoggingTarget
• Protokollierungsbeispiel (Windows 10)