EventLogTraceListener Classe

Definição

Fornece um ouvinte simples que direciona a saída do rastreamento ou da depuração para um EventLog.

public ref class EventLogTraceListener sealed : System::Diagnostics::TraceListener
public sealed class EventLogTraceListener : System.Diagnostics.TraceListener
type EventLogTraceListener = class
    inherit TraceListener
Public NotInheritable Class EventLogTraceListener
Inherits TraceListener
Herança
EventLogTraceListener

Exemplos

O exemplo a seguir cria um ouvinte de rastreamento que envia a saída para um log de eventos. Primeiro, o código cria um novo EventLogTraceListener que usa o de origem myEventLogSource. Em seguida, myTraceListener é adicionado à Trace.Listeners coleção. Por fim, o exemplo envia uma linha de saída para o Listeners objeto .

int main()
{
   #if defined(TRACE)
   
   // Create a trace listener for the event log.
   EventLogTraceListener^ myTraceListener = 
      gcnew EventLogTraceListener( "myEventLogSource" );
   
   // Add the event log trace listener to the collection.
   Trace::Listeners->Add( myTraceListener );
   
   // Write output to the event log.
   Trace::WriteLine( "Test output" );
   
   #endif
}
// Create a trace listener for the event log.
EventLogTraceListener myTraceListener = new EventLogTraceListener("myEventLogSource");

// Add the event log trace listener to the collection.
Trace.Listeners.Add(myTraceListener);

// Write output to the event log.
Trace.WriteLine("Test output");
Overloads Public Shared Sub Main(args() As String)
   
    ' Create a trace listener for the event log.
    Dim myTraceListener As New EventLogTraceListener("myEventLogSource")
    
    ' Add the event log trace listener to the collection.
    Trace.Listeners.Add(myTraceListener)
    
    ' Write output to the event log.
    Trace.WriteLine("Test output")
End Sub

Comentários

Uma instância disso EventLogTraceListener pode ser adicionada às Debug.Listenerscoleções , Trace.Listenersou TraceSource.Listeners para enviar a saída de rastreamento ou depuração para um EventLog. Você pode adicionar a instância em seu código ou, para um aplicativo .NET Framework, especificá-la no arquivo de configuração do aplicativo.

Para adicionar um EventLogTraceListener usando um .NET Framework arquivo de configuração de aplicativo, edite o arquivo que corresponde ao nome do aplicativo. Nesse arquivo, insira um elemento para um System.Diagnostics.EventLogTraceListener tipo. O exemplo a Trace.Listeners seguir adiciona um EventLogTraceListener objeto chamado myListener à coleção. O initializeData parâmetro especifica o nome da origem do log de eventos que deve ser passada para o EventLogTraceListener(String) construtor.

<configuration>  
  <system.diagnostics>  
    <trace autoflush="false" indentsize="4">  
      <listeners>  
        <add name="myListener"  
          type="System.Diagnostics.EventLogTraceListener"  
          initializeData="TraceListenerLog" />  
      </listeners>  
    </trace>  
  </system.diagnostics>  
</configuration>  

Observação

Se o Source do log de eventos associado à EventLogTraceListener instância não existir, uma nova origem do evento será criada. Para criar uma fonte de eventos no Windows Vista, Windows XP Professional ou Windows Server 2003, você deve ter privilégios administrativos.

O motivo desse requisito é que todos os logs de eventos, incluindo a segurança, devem ser pesquisados para determinar se a origem do evento é exclusiva. No Windows Vista, os usuários não têm permissão para acessar o log de segurança; portanto, um SecurityException é lançado.

No Windows Vista, o UAC (Controle de Conta de Usuário) determina os privilégios de um usuário. Se for um membro do grupo Administradores Internos, você receberá dois tokens de acesso do tempo de execução: um token de acesso do usuário padrão e um token de acesso do administrador. Por padrão, você está na função de usuário padrão. Para executar o código que acessa o log de segurança, primeiro você deve elevar seus privilégios de usuário padrão para administrador. Você pode fazer isso ao iniciar um aplicativo, clicando com o botão direito do mouse no ícone do aplicativo e indicando que você deseja executar como administrador.

A classe fornece a EventLog propriedade para obter ou definir o log de eventos que recebe a saída de rastreamento ou depuração e a Name propriedade para manter o nome do EventLogTraceListener.

O Close método fecha o log de eventos para que ele não receba mais a saída de rastreamento ou depuração. Os Write métodos e WriteLine gravam uma mensagem no log de eventos.

Observação

Para evitar a possibilidade de gravar grandes quantidades de dados no log de eventos, o EventLogTraceListener não gera os dados de rastreamento opcionais especificados pela TraceOutputOptions propriedade .

Construtores

EventLogTraceListener()

Inicializa uma nova instância da classe EventLogTraceListener sem um ouvinte de rastreamento.

EventLogTraceListener(EventLog)

Inicializa uma nova instância da classe EventLogTraceListener usando o log de evento especificado.

EventLogTraceListener(String)

Inicializa uma nova instância da classe EventLogTraceListener usando a origem especificada.

Propriedades

Attributes

Obtém os atributos do ouvinte de rastreamento personalizados definidos no arquivo de configuração de aplicativo.

(Herdado de TraceListener)
EventLog

Obtém ou define o log de eventos de gravação.

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.

(Herdado de TraceListener)
Name

Obtém ou define o nome deste EventLogTraceListener.

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 log de eventos 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.

(Herdado de TraceListener)
Flush()

Quando substituído em uma classe derivada, libera o buffer de saída.

(Herdado de TraceListener)
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.

(Herdado de TraceListener)
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 no log de eventos.

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.

(Herdado de TraceListener)
TraceData(TraceEventCache, String, TraceEventType, Int32, Object[])

Grava as informações de rastreamento, uma matriz de objetos de dados e informações de evento para o log de evento.

TraceData(TraceEventCache, String, TraceEventType, Int32, Object[])

Grava informações de rastreamento, uma matriz de objetos de dados e informações de evento na saída específica do ouvinte.

(Herdado de TraceListener)
TraceEvent(TraceEventCache, String, TraceEventType, Int32)

Grava as informações de rastreamento e evento para a saída específica do ouvinte.

(Herdado de TraceListener)
TraceEvent(TraceEventCache, String, TraceEventType, Int32, String)

Grava informações de rastreamento, uma mensagem e informações de evento no log de eventos.

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.

(Herdado de TraceListener)
TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[])

Grava informações de rastreamento, uma matriz de objetos formatados e informações de evento no log de eventos.

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.

(Herdado de TraceListener)
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.

(Herdado de TraceListener)
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)

Grava uma mensagem no log de eventos para essa instância.

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)

Grava uma mensagem no log de eventos para essa instância.

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

Acesso thread-safe

Este tipo é thread-safe.

Confira também