LoggingChannel Classe

Definição

Namespace:

Windows.Foundation.Diagnostics

Representa uma fonte de mensagens de log.

public ref class LoggingChannel sealed : 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.ILoggingChannelFactory, 65536, "Windows.Foundation.UniversalApiContract")]
/// [Windows.Foundation.Metadata.Activatable(Windows.Foundation.Diagnostics.ILoggingChannelFactory2, 65536, "Windows.Foundation.UniversalApiContract")]
class LoggingChannel final : 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.ILoggingChannelFactory), 65536, "Windows.Foundation.UniversalApiContract")]
[Windows.Foundation.Metadata.Activatable(typeof(Windows.Foundation.Diagnostics.ILoggingChannelFactory2), 65536, "Windows.Foundation.UniversalApiContract")]
public sealed class LoggingChannel : System.IDisposable

function LoggingChannel(name, options, id)

Public NotInheritable Class LoggingChannel
Implements IDisposable

Herança

Object Platform::Object IInspectable LoggingChannel

Atributos

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Implementações

IClosable IDisposable ILoggingChannel ILoggingTarget

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

O LoggingLevel padrão é Detalhado.

Adicione instâncias do LoggingChannel a uma LoggingSession ou a FileLoggingSession para habilitar o registro em log em seu aplicativo.

Os métodos LogMessage fornecem maneiras de registrar mensagens de cadeia de caracteres simples, enquanto os métodos LogEvent fornecem maneiras de registrar dados de rastreamento mais complexos.

Windows 10 Agora há suporte para dois modos de operação: Windows 8.1 modo de compatibilidade e o novo comportamento compatível com o Windows 10 e posterior, que permite registrar eventos etw (Rastreamento de Eventos para Windows) autodescritivos sem um manifesto. + Para Windows 8.1 modo de compatibilidade, crie o objeto usando o construtor LoggingChannel(String).

• Para o Windows 10 e comportamento específico posterior, crie o objeto usando o construtor LoggingChannel(String, LoggingChannelOptions) ou LoggingChannel(String, LoggingChannelOptions, Guid ). As diferenças entre esses dois modos são:

Windows 8.1 modo de compatibilidade	Comportamento específico do Windows 10 e posterior
Alguns eventos **LoggingChannel** podem fazer referência ao 4bd2826e-54a1-4ba9-bf63-92b73ea1ac4a, que é o [GUID]. (/windows/win32/api/guiddef/ns-guiddef-guid) para o manifesto **Microsoft-Windows-Diagnostics-LoggingChannel** que está disponível no Windows 8.1 ou posterior.	Todos os eventos são autodescritivos. Nenhum manifesto é necessário.
O Construtores LoggingChannel(String) Esse construtor cria um LoggingChannel no modo de compatibilidade Windows 8.1. LoggingChannel(String, LoggingChannelOptions) Inicializa uma nova instância da classe LoggingChannel com as opções especificadas. LoggingChannel(String, LoggingChannelOptions, Guid) Inicializa uma nova instância da classe LoggingChannel com as opções especificadas e a ID do canal. Propriedades Enabled Obtém um valor que indica se pelo menos uma sessão está registrando eventos desse canal. Id Retorna o identificador do provedor para este canal. Level Obtém o nível mínimo no qual qualquer sessão está escutando eventos desse canal. Name Obtém o nome do LoggingChannel atual. Métodos Close() Termina o registro em log no canal de log atual. Dispose() Realiza tarefas definidas pelo aplicativo associadas à liberação ou à redefinição de recursos não gerenciados. IsEnabled() Indica se pelo menos uma sessão está escutando eventos do canal. IsEnabled(LoggingLevel) Indica se pelo menos uma sessão está escutando eventos com o nível de severidade do evento especificado do canal. IsEnabled(LoggingLevel, Int64) Indica se pelo menos uma sessão está escutando eventos com o nível e as palavras-chave especificados deste canal. LogEvent(String) Registra um evento com o nome especificado. LogEvent(String, LoggingFields) Registra um evento com o nome e os campos especificados. LogEvent(String, LoggingFields, LoggingLevel) Registra um evento com o nome, os campos e o nível especificados. LogEvent(String, LoggingFields, LoggingLevel, LoggingOptions) Registra um evento com o nome, os campos, o nível e as opções especificados. LogMessage(String) Registra uma mensagem no LoggingChannel atual. LogMessage(String, LoggingLevel) Registra uma mensagem no LoggingChannel atual com o LoggingLevel especificado. LogValuePair(String, Int32) Registra dados no LoggingChannel atual. LogValuePair(String, Int32, LoggingLevel) Registra dados no LoggingChannel atual com o LoggingLevel especificado. StartActivity(String) Grava um evento de início de atividade e cria um objeto LoggingActivity . StartActivity(String, LoggingFields) Grava um evento de início de atividade com os campos especificados e cria um objeto LoggingActivity . StartActivity(String, LoggingFields, LoggingLevel) Grava um evento de início de atividade com os campos e o nível especificados e cria um objeto LoggingActivity . StartActivity(String, LoggingFields, LoggingLevel, LoggingOptions) Grava um evento de início de atividade com os campos, o nível e as opções especificados e cria um objeto LoggingActivity . Eventos LoggingEnabled Gerado quando o canal de registro em log é anexado a uma LoggingSession ou a outras ferramentas de rastreamento e depuração de eventos. Confira também LoggingSession FileLoggingSession ILoggingChannel IClosable Exemplo de registro em log (Windows 10)