LoggingSession Classe

Definizione

Spazio dei nomi:

Windows.Foundation.Diagnostics

Rappresenta la destinazione dei messaggi registrati dalle istanze di LoggingChannel .

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

Ereditarietà

Object Platform::Object IInspectable LoggingSession

Attributi

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Implementazioni

IClosable IDisposable ILoggingSession

Requisiti Windows

Famiglia di dispositivi	Windows 10 (è stato introdotto in 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (è stato introdotto in v1.0)

Commenti

Usare la classe LoggingSession per registrare i messaggi e i dati in un buffer circolare in memoria durante l'esecuzione dell'app. Usare il metodo SaveToFileAsync per salvare il buffer in un file. È possibile visualizzare i file di log usando Windows Performance Toolkit (WPT) e altre utilità come tracerpt.exe.

Le istanze di LoggingSession mantengono i messaggi registrati in memoria finché non viene chiamato il metodo SaveToFileAsync . Ciò consente il salvataggio su richiesta di eventi fino a quando l'app salva i messaggi in memoria.

Aggiungere istanze di LoggingChannel a un oggetto LoggingSession e chiamare i metodi di istanza di LoggingSession per rimuovere canali, eliminare ed eseguire altre operazioni.

LoggingSession registra i più recenti 260 KB di eventi, dopo il quale inizierà a sovrascrivere gli eventi meno recenti.

Non è possibile avere più sessioni con lo stesso nome. Inoltre, ogni app è limitata a 4 sessioni totali.

Costruttori

LoggingSession(String)

Inizializza una nuova istanza della classe LoggingSession .

Proprietà

Name	Ottiene il nome della sessione di registrazione.

Metodi

AddLoggingChannel(ILoggingChannel)	Aggiunge un canale di registrazione alla sessione di registrazione corrente.
AddLoggingChannel(ILoggingChannel, LoggingLevel)	Aggiunge un canale di registrazione con il livello di registrazione specificato alla sessione di registrazione corrente.
Close()	Termina la sessione di registrazione corrente.
Dispose()	Esegue attività definite dall'applicazione, come rilasciare o reimpostare risorse non gestite.
RemoveLoggingChannel(ILoggingChannel)	Rimuove il canale di registrazione specificato dalla sessione di registrazione corrente.
SaveToFileAsync(IStorageFolder, String)	Salva la sessione di registrazione corrente in un file.

Vedi anche

• LoggingChannel
• ILoggingSession
• IClosable
• Esempio di registrazione (Windows 10)