LoggingSession Classe

  • Referência

Definição

Namespace:
Windows.Foundation.Diagnostics
Editar

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
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.

Aplica-se a

Confira também