EventProviderTraceListener Classe

Referência

Definição

Namespace:: System.Diagnostics.Eventing

Assembly:: System.Core.dll

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.

Um ouvinte para TraceSource que grava eventos no subsistema ETW.

public ref class EventProviderTraceListener : System::Diagnostics::TraceListener

public class EventProviderTraceListener : System.Diagnostics.TraceListener

type EventProviderTraceListener = class
    inherit TraceListener

Public Class EventProviderTraceListener
Inherits TraceListener

Herança: Object

MarshalByRefObject

TraceListener
EventProviderTraceListener

Exemplos

private static Guid providerId = new Guid("{B3F0C8FC-E8A8-4868-8901-1465E8A2F41B}");  

    EventProviderTraceListener listener = new EventProviderTraceListener(providerId.ToString(), "Test Listener", "::");  

    // You should use the All default level and control the level using the  
    // ETW session; otherwise, you may not log all the events requested by the  
    // session.  
    TraceSource source = new TraceSource("MyProvider", SourceLevels.All);  

    source.Listeners.Add(listener);  

    source.TraceData(TraceEventType.Warning | TraceEventType.Start, 2, new object[] { "abc", "def", true, 123 });  

    source.TraceEvent(TraceEventType.Warning, 12, "Provider guid: {0}", new object[] { providerId });  

    source.TraceInformation("string {0}, bool {1}, int {2}, ushort {3}", new object[] { "abc", false, 123, (UInt32)5 });

Comentários

Todos os dados de evento (rastreamento ou depuração) do evento de origem são gravados no subsistema ETW como uma cadeia de caracteres. Os elementos de dados são delimitados usando uma vírgula. Para especificar um delimitador diferente, use a Delimiter propriedade .

Adicionar o ouvinte para System.Diagnostics.TraceSource registrar o provedor com o subsistema ETW. Você deve criar uma sessão de rastreamento ETW usando o Logman.exe programa executável (ou algo semelhante) para gravar os eventos em um arquivo de log.

Você não precisa de um manifesto para consumir eventos do ouvinte porque os dados do evento são uma única cadeia de caracteres.

Ao chamar os System.Diagnostics.TraceSource métodos para gravar eventos, você passa um System.Diagnostics.TraceEventType valor de enumeração. A enumeração contém valores de nível e palavra-chave. Quando você habilita um provedor de ouvinte de rastreamento de uma sessão ETW, o valor de nível especificado pode ser o valor associado a um dos seguintes System.Diagnostics.TraceEventType valores de enumeração:

Crítico (o valor é 1)
Erro (o valor é 2)
Informações (o valor é 8)
Detalhado (o valor é 16)
Aviso (o valor é 4)

O valor da palavra-chave que você especifica para a sessão pode ser o valor associado a um dos seguintes System.Diagnostics.TraceEventType valores de enumeração:

Retomar (o valor é 2.048)
Iniciar (o valor é 256)
Parar (o valor é 512)
Suspender (o valor é 1.024)
Transferência (o valor é 4.096)

Construtores

EventProviderTraceListener(String)	Inicializa uma nova instância da classe EventProviderTraceListener usando o identificador de provedor especificado.
EventProviderTraceListener(String, String)	Inicializa uma nova instância da classe EventProviderTraceListener usando o identificador do provedor especificado e o nome do ouvinte.
EventProviderTraceListener(String, String, String)	Inicializa uma nova instância da classe EventProviderTraceListener usando o identificador do provedor especificado, o nome do ouvinte e o delimitador.

Propriedades

Attributes	Obtém os atributos do ouvinte de rastreamento personalizados definidos no arquivo de configuração de aplicativo. (Herdado de TraceListener)
Delimiter	Obtém ou define o delimitador usado para delimitar os dados de evento que são gravados no subsistema ETW.
Filter	Obtém ou define o filtro de rastreamento para o ouvinte de rastreamento. (Herdado de TraceListener)
IndentLevel	Obtém ou define o nível de recuo. (Herdado de TraceListener)
IndentSize	Obtém ou define o número de espaços em um recuo. (Herdado de TraceListener)
IsThreadSafe	Obtém um valor que indica se o ouvinte de rastreamento é thread-safe.
Name	Obtém ou define um nome para este TraceListener. (Herdado de TraceListener)
NeedIndent	Obtém ou define um valor que indica se a saída deve ser recuada. (Herdado de TraceListener)
TraceOutputOptions	Obtém ou define as opções de saída de rastreamento. (Herdado de TraceListener)

Métodos

Close()	Fecha o fluxo de saída para que ele não receba mais a saída de rastreamento ou de depuração.
CreateObjRef(Type)	Cria um objeto que contém todas as informações relevantes necessárias para gerar um proxy usado para se comunicar com um objeto remoto. (Herdado de MarshalByRefObject)
Dispose()	Libera todos os recursos usados pelo TraceListener. (Herdado de TraceListener)
Dispose(Boolean)	Libera os recursos não gerenciados usados pelo TraceListener e opcionalmente libera os recursos gerenciados. (Herdado de TraceListener)
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
Fail(String)	Emite uma mensagem de erro para o ouvinte criado ao implementar a classe TraceListener. (Herdado de TraceListener)
Fail(String, String)	Emite uma mensagem de erro e uma mensagem de erro detalhada para o ouvinte criado ao implementar a classe TraceListener.
Flush()	Libera o buffer de saída.
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetLifetimeService()	Obsoleto. Recupera o objeto de serviço de tempo de vida atual que controla a política de ciclo de vida para esta instância. (Herdado de MarshalByRefObject)
GetSupportedAttributes()	Obtém os atributos personalizados com suporte no ouvinte de rastreamento.
GetType()	Obtém o Type da instância atual. (Herdado de Object)
InitializeLifetimeService()	Obsoleto. Obtém um objeto de serviço de tempo de vida para controlar a política de tempo de vida para essa instância. (Herdado de MarshalByRefObject)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
MemberwiseClone(Boolean)	Cria uma cópia superficial do objeto MarshalByRefObject atual. (Herdado de MarshalByRefObject)
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)
TraceData(TraceEventCache, String, TraceEventType, Int32, Object)	Grava as informações de rastreamento, um objeto de dados e informações de evento para a saída específica do ouvinte.
TraceData(TraceEventCache, String, TraceEventType, Int32, Object[])	Grava as informações de rastreamento, um objeto de dados e informações de evento para a saída específica do ouvinte.
TraceEvent(TraceEventCache, String, TraceEventType, Int32)	Grava as informações de rastreamento e evento para a saída específica do ouvinte.
TraceEvent(TraceEventCache, String, TraceEventType, Int32, String)	Grava informações de rastreamento, uma mensagem e informações de evento na saída específica do ouvinte.
TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[])	Grava informações de rastreamento, uma matriz de objetos formatada e informações de evento na saída específica do ouvinte.
TraceTransfer(TraceEventCache, String, Int32, String, Guid)	Grava informações de rastreamento, uma mensagem, uma identidade de atividade relacionada e informações de evento na saída específica do ouvinte.
Write(Object)	Grava o valor do método ToString() do objeto no ouvinte criado ao implementar a classe TraceListener. (Herdado de TraceListener)
Write(Object, String)	Grava um nome de categoria e o valor do método ToString() do objeto no ouvinte criado ao implementar a classe TraceListener. (Herdado de TraceListener)
Write(String)	Quando substituído em uma classe derivada, grava a mensagem especificada no ouvinte criado na classe derivada.
Write(String, String)	Grava um nome de categoria e uma mensagem no ouvinte criado ao implementar a classe TraceListener. (Herdado de TraceListener)
WriteIndent()	Grava o recuo para o ouvinte criar durante a implementação dessa classe e redefine a propriedade NeedIndent para `false`. (Herdado de TraceListener)
WriteLine(Object)	Grava o valor do método ToString() do objeto no ouvinte criado ao implementar a classe TraceListener, seguido por um terminador de linha. (Herdado de TraceListener)
WriteLine(Object, String)	Grava um nome de categoria e o valor do método ToString() do objeto no ouvinte criado ao implementar a classe TraceListener, seguido por um terminador de linha. (Herdado de TraceListener)
WriteLine(String)	Quando substituído em uma classe derivada, grava uma mensagem no ouvinte criado na classe derivada, seguida por um terminador de linha.
WriteLine(String, String)	Grava um nome de categoria e uma mensagem no ouvinte criado ao implementar a classe TraceListener, seguido por um terminador de linha. (Herdado de TraceListener)

Aplica-se a

Confira também

TraceListener

Compartilhar via