LoggingSession Classe

Definição

Namespace:

Windows.Foundation.Diagnostics

Representa o destino de mensagens registradas de instâncias do 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

Herança

Object Platform::Object IInspectable LoggingSession

Atributos

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Implementações

IClosable IDisposable ILoggingSession

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.

Confira também

• LoggingChannel
• ILoggingSession
• IClosable
• Exemplo de registro em log (Windows 10)