LoggingChannel Classe

Definição

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

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

Windows 8.1 modo de compatibilidadeComportamento 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.

Aplica-se a

Confira também