EventLogTraceListener Classe
Definição
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.
Fornece um ouvinte simples que direciona a saída de rastreamento ou depuração para um EventLog.
public ref class EventLogTraceListener sealed : System::Diagnostics::TraceListenerpublic sealed class EventLogTraceListener : System.Diagnostics.TraceListenertype EventLogTraceListener = class
inherit TraceListenerPublic NotInheritable Class EventLogTraceListener
Inherits TraceListener- Herança
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 a origem myEventLogSource. Em seguida, myTraceListener é adicionado à Trace.Listeners coleção. Por fim, o exemplo envia uma linha de saída para o Listeners objeto.
// 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 ao Debug.Listeners, Trace.Listenersou TraceSource.Listeners coleções para enviar 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, especifique-a no arquivo de configuração do aplicativo.
Para adicionar um EventLogTraceListener arquivo de configuração de aplicativo do .NET Framework usando, edite o arquivo que corresponde ao nome do aplicativo. Neste arquivo, insira um elemento para um System.Diagnostics.EventLogTraceListener tipo. O exemplo a seguir adiciona um EventLogTraceListener objeto nomeado myListener à Trace.Listeners 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 log de eventos associado à EventLogTraceListener instância não existir, uma nova fonte de evento será criada. Para criar uma fonte de evento 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 você for membro do grupo Administradores Internos, será atribuído dois tokens de acesso em tempo de execução: um token de acesso de usuário padrão e um token de acesso de 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 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 os WriteLine métodos gravam uma mensagem no log de eventos.
Observação
Para evitar a possibilidade de gravar grandes quantidades de dados no log de eventos, ele EventLogTraceListener não gera os dados de rastreamento opcionais especificados pela TraceOutputOptions propriedade.
Construtores
| Nome | Description |
|---|---|
| EventLogTraceListener() |
Inicializa uma nova instância da EventLogTraceListener classe sem um ouvinte de rastreamento. |
| EventLogTraceListener(EventLog) |
Inicializa uma nova instância da EventLogTraceListener classe usando o log de eventos especificado. |
| EventLogTraceListener(String) |
Inicializa uma nova instância da EventLogTraceListener classe usando a origem especificada. |
Propriedades
| Nome | Description |
|---|---|
| Attributes |
Obtém os atributos do ouvinte de rastreamento personalizado definidos no arquivo de configuração do aplicativo. (Herdado de TraceListener) |
| EventLog |
Obtém ou define o log de eventos para o qual gravar. |
| 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 deve recuar a saída. (Herdado de TraceListener) |
| TraceOutputOptions |
Obtém ou define as opções de saída de rastreamento. (Herdado de TraceListener) |
Métodos
| Nome | Description |
|---|---|
| Close() |
Fecha o log de eventos para que ele não receba mais a saída de rastreamento ou 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, String) |
Emite uma mensagem de erro e uma mensagem de erro detalhada para o ouvinte que você cria ao implementar a TraceListener classe. (Herdado de TraceListener) |
| Fail(String) |
Emite uma mensagem de erro para o ouvinte que você cria ao implementar a TraceListener classe. (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 tempo de vida para essa instância. (Herdado de MarshalByRefObject) |
| GetSupportedAttributes() |
Obtém os atributos personalizados compatíveis com o 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 dessa instância. (Herdado de MarshalByRefObject) |
| MemberwiseClone() |
Cria uma cópia superficial do Objectatual. (Herdado de Object) |
| MemberwiseClone(Boolean) |
Cria uma cópia superficial do objeto atual MarshalByRefObject . (Herdado de MarshalByRefObject) |
| ToString() |
Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object) |
| TraceData(TraceEventCache, String, TraceEventType, Int32, Object) |
Grava informações de rastreamento, um objeto de dados e informações de evento no log de eventos. |
| TraceData(TraceEventCache, String, TraceEventType, Int32, Object[]) |
Grava informações de rastreamento, uma matriz de objetos de dados e informações de evento no log de eventos. |
| TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[]) |
Grava informações de rastreamento, uma matriz formatada de objetos 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 no log de eventos. |
| TraceEvent(TraceEventCache, String, TraceEventType, Int32) |
Grava informações de rastreamento e 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 para a saída específica do ouvinte. (Herdado de TraceListener) |
| Write(Object, String) |
Grava um nome de categoria e o valor do método do ToString() objeto no ouvinte que você cria ao implementar a TraceListener classe. (Herdado de TraceListener) |
| Write(Object) |
Grava o valor do método do ToString() objeto no ouvinte que você cria ao implementar a TraceListener classe. (Herdado de TraceListener) |
| Write(String, String) |
Grava um nome de categoria e uma mensagem no ouvinte que você cria ao implementar a TraceListener classe. (Herdado de TraceListener) |
| Write(String) |
Grava uma mensagem no log de eventos dessa instância. |
| WriteIndent() |
Grava o recuo no ouvinte que você cria ao implementar essa classe e redefine a NeedIndent propriedade para |
| WriteLine(Object, String) |
Grava um nome de categoria e o valor do método do ToString() objeto no ouvinte que você cria quando implementa a TraceListener classe, seguido por um terminador de linha. (Herdado de TraceListener) |
| WriteLine(Object) |
Grava o valor do método do ToString() objeto no ouvinte que você cria quando implementa a TraceListener classe, seguido por um terminador de linha. (Herdado de TraceListener) |
| WriteLine(String, String) |
Grava um nome de categoria e uma mensagem para o ouvinte que você cria ao implementar a TraceListener classe, seguido por um terminador de linha. (Herdado de TraceListener) |
| WriteLine(String) |
Grava uma mensagem no log de eventos dessa instância. |
Aplica-se a
Acesso thread-safe
Esse tipo é thread safe.
