LoggingChannel Classe

Referência

Definição

Namespace:: Windows.Foundation.Diagnostics

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Editar

Representa uma fonte de mensagens de log.

public ref class LoggingChannel sealed : IClosable

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

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

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.

Aplica-se a

Compartilhar via

LoggingChannel Classe

Definição

Requisitos do Windows

Comentários

Construtores

Propriedades

Métodos

Eventos

Aplica-se a

Confira também

Comentários

Recursos adicionais