Freigeben über


LoggingSession Klasse

Definition

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

public ref class LoggingSession sealed : ILoggingSession, IClosable
/// [Windows.Foundation.Metadata.Activatable(Windows.Foundation.Diagnostics.ILoggingSessionFactory, 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 LoggingSession final : 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.Activatable(typeof(Windows.Foundation.Diagnostics.ILoggingSessionFactory), 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 LoggingSession : System.IDisposable, ILoggingSession
[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
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

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.

Gilt für:

Weitere Informationen