Partilhar via


LoggingSession Classe

Definição

Representa o destino de mensagens registradas de instâncias do LoggingChannel .

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
Herança
Object Platform::Object IInspectable LoggingSession
Atributos
Implementações

Requisitos do Windows

Família de dispositivos
Windows 10 (introduzida na 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (introduzida na v1.0)

Comentários

Use a classe LoggingSession para registrar mensagens e dados em um buffer circular na memória conforme o aplicativo é executado. Use o método SaveToFileAsync para salvar o buffer em um arquivo. Você pode exibir os arquivos de log usando o WPT (Windows Performance Toolkit) e outros utilitários, como tracerpt.exe.

As instâncias de LoggingSession mantêm mensagens registradas na memória até que o método SaveToFileAsync seja chamado. Isso permite o salvamento sob demanda de eventos até que o aplicativo salve as mensagens na memória.

Adicione instâncias do LoggingChannel a uma LoggingSession e chame métodos de instância LoggingSession para remover canais, descartar e executar outras operações.

O LoggingSession registra os 260 KB de eventos mais recentes, após os quais começará a substituir eventos mais antigos.

Você não pode ter mais de uma sessão com o mesmo nome. Além disso, cada aplicativo é limitado a quatro sessões no total.

Construtores

LoggingSession(String)

Inicializa uma nova instância da classe LoggingSession .

Propriedades

Name

Obtém o nome da sessão de registro em log.

Métodos

AddLoggingChannel(ILoggingChannel)

Adiciona um canal de registro em log à sessão de log atual.

AddLoggingChannel(ILoggingChannel, LoggingLevel)

Adiciona um canal de registro em log com o nível de log especificado à sessão de log atual.

Close()

Encerra a sessão de log atual.

Dispose()

Realiza tarefas definidas pelo aplicativo associadas à liberação ou à redefinição de recursos não gerenciados.

RemoveLoggingChannel(ILoggingChannel)

Remove o canal de log especificado da sessão de log atual.

SaveToFileAsync(IStorageFolder, String)

Salva a sessão de log atual em um arquivo.

Aplica-se a

Confira também