LoggingSession Klasse

Definition

Namespace:

Windows.Foundation.Diagnostics

Stellt das Ziel der protokollierten Nachrichten von LoggingChannel-Instanzen dar.

public ref class LoggingSession sealed : ILoggingSession, 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.ILoggingSessionFactory, 65536, "Windows.Foundation.UniversalApiContract")]
class LoggingSession final : ILoggingSession, 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.ILoggingSessionFactory), 65536, "Windows.Foundation.UniversalApiContract")]
public sealed class LoggingSession : System.IDisposable, ILoggingSession

function LoggingSession(name)

Public NotInheritable Class LoggingSession
Implements IDisposable, ILoggingSession

Vererbung

Object Platform::Object IInspectable LoggingSession

Attribute

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Implementiert

IClosable IDisposable ILoggingSession

Windows-Anforderungen

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

Hinweise

Verwenden Sie die LoggingSession-Klasse, um Nachrichten und Daten während der Ausführung Ihrer App in einem Speicherkreispuffer zu protokollieren. Verwenden Sie die SaveToFileAsync-Methode , um den Puffer in einer Datei zu speichern. Sie können die Protokolldateien mit dem Windows Performance Toolkit (WPT) und anderen Hilfsprogrammen wie tracerpt.exe anzeigen.

LoggingSession-Instanzen behalten protokollierte Nachrichten im Arbeitsspeicher bei, bis die SaveToFileAsync-Methode aufgerufen wird. Dies ermöglicht das on-demand-Speichern von Ereignissen, bis die App die In-Memory-Nachrichten speichert.

Fügen Sie LoggingChannel-Instanzen zu einer LoggingSession hinzu, und rufen Sie LoggingSession instance Methoden auf, um Kanäle zu entfernen, zu löschen und andere Vorgänge auszuführen.

LoggingSession zeichnet die neuesten 260 KB-Ereignisse auf, nach denen ältere Ereignisse überschrieben werden.

Sie dürfen nicht mehr als eine Sitzung mit demselben Namen haben. Darüber hinaus ist jede App auf insgesamt vier Sitzungen beschränkt.

Konstruktoren

LoggingSession(String)

Initialisiert eine neue instance der LoggingSession-Klasse.

Eigenschaften

Name	Ruft den Namen der Protokollierungssitzung ab.

Methoden

AddLoggingChannel(ILoggingChannel)	Fügt der aktuellen Protokollierungssitzung einen Protokollierungskanal hinzu.
AddLoggingChannel(ILoggingChannel, LoggingLevel)	Fügt der aktuellen Protokollierungssitzung einen Protokollierungskanal mit der angegebenen Protokollierungsebene hinzu.
Close()	Beendet die aktuelle Protokollierungssitzung.
Dispose()	Führt anwendungsspezifische Aufgaben durch, die mit der Freigabe, der Zurückgabe oder dem Zurücksetzen von nicht verwalteten Ressourcen zusammenhängen.
RemoveLoggingChannel(ILoggingChannel)	Entfernt den angegebenen Protokollierungskanal aus der aktuellen Protokollierungssitzung.
SaveToFileAsync(IStorageFolder, String)	Speichert die aktuelle Protokollierungssitzung in einer Datei.

Weitere Informationen

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