EventLogTraceListener Classe
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Fornece um ouvinte simples que direciona a saída de rastreio 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 seguinte cria um ouvinte de traço que envia saída para um registo de eventos. Primeiro, o código cria um novo EventLogTraceListener que utiliza a fonte myEventLogSource. De seguida, myTraceListener é adicionado à Trace.Listeners coleção. Finalmente, 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
Observações
Uma instância disto EventLogTraceListener pode ser adicionada às Debug.Listeners, Trace.Listeners, ou TraceSource.Listeners coleções para enviar saídas de traço ou depuração para um EventLog. Pode adicionar a instância no seu código ou, para uma aplicação .NET Framework, especificá-la no ficheiro de configuração da aplicação.
Para adicionar um EventLogTraceListener usando um ficheiro de configuração de aplicação .NET Framework, edite o ficheiro que corresponde ao nome da sua aplicação. Neste ficheiro, insira um elemento para um System.Diagnostics.EventLogTraceListener tipo. O exemplo seguinte acrescenta um EventLogTraceListener objeto nomeado myListener à Trace.Listeners coleção. O initializeData parâmetro especifica o nome da fonte do registo de eventos que deve ser passada ao 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>
Note
Se o Source para o registo de eventos associado à EventLogTraceListener instância não existir, é criado um novo código de origem de eventos. Para criar uma fonte de eventos no Windows Vista, Windows XP Professional ou Windows Server 2003, deve ter privilégios administrativos.
A razão para este requisito é que todos os registos de eventos, incluindo a segurança, devem ser pesquisados para determinar se a fonte do evento é única. Em Windows Vista, os utilizadores não têm permissão para aceder ao registo de segurança; por isso, é lançado um SecurityException.
No Windows Vista, o Controle de Conta de Usuário (UAC) determina os privilégios de um usuário. Se for membro do grupo Administradores Incorporados, é-lhe atribuídos dois tokens de acesso em tempo de execução: um token de acesso de utilizador 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 acede ao registo de segurança, deve primeiro elevar os seus privilégios de utilizador 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 registo de eventos que recebe a saída de rastreio ou depuração, e a Name propriedade para conter o nome do EventLogTraceListener.
O Close método fecha o registo de eventos, deixando de receber resultados de rastreio ou depuração. Os Write métodos e WriteLine escrevem uma mensagem no registo de eventos.
Note
Para evitar a possibilidade de escrever grandes quantidades de dados no registo de eventos, o EventLogTraceListener não gera os dados opcionais de traço especificados pela TraceOutputOptions propriedade.
Construtores
| Name | 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 registo de eventos especificado. |
| EventLogTraceListener(String) |
Inicializa uma nova instância da EventLogTraceListener classe usando a fonte especificada. |
Propriedades
| Name | Description |
|---|---|
| Attributes |
Obtém os atributos personalizados do ouvinte de rastreio definidos no ficheiro de configuração da aplicação. (Herdado de TraceListener) |
| EventLog |
Obtém ou define o registo de eventos para escrever. |
| Filter |
Obtém ou define o filtro de traço para o ouvinte de traços. (Herdado de TraceListener) |
| IndentLevel |
Obtém ou define o nível da recuação. (Herdado de TraceListener) |
| IndentSize |
Obtém ou define o número de espaços num reentro. (Herdado de TraceListener) |
| IsThreadSafe |
Recebe um valor que indica se o ouvinte de rastreio é seguro para threads. (Herdado de TraceListener) |
| Name |
Obtém ou define o nome deste EventLogTraceListener. |
| NeedIndent |
Obtém ou define um valor que indica se deve indentar a saída. (Herdado de TraceListener) |
| TraceOutputOptions |
Obtém ou define as opções de saída do traço. (Herdado de TraceListener) |
Métodos
| Name | Description |
|---|---|
| Close() |
Fecha o registo de eventos para que deixe de receber resultados de rastreamento ou depuração. |
| CreateObjRef(Type) |
Cria um objeto que contém toda a informação relevante necessária para gerar um proxy usado para comunicar com um objeto remoto. (Herdado de MarshalByRefObject) |
| Dispose() |
Liberta todos os recursos utilizados pelo TraceListener. (Herdado de TraceListener) |
| Dispose(Boolean) |
Liberta os recursos não geridos usados pelo TraceListener e opcionalmente liberta os recursos geridos. (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 crias quando implementas a TraceListener classe. (Herdado de TraceListener) |
| Fail(String) |
Emite uma mensagem de erro para o ouvinte que crias quando implementas a TraceListener classe. (Herdado de TraceListener) |
| Flush() |
Quando sobreposto numa classe derivada, limpa o buffer de saída. (Herdado de TraceListener) |
| GetHashCode() |
Serve como função de hash predefinida. (Herdado de Object) |
| GetLifetimeService() |
Recupera o objeto de serviço de tempo de vida atual que controla a política de vida útil neste caso. (Herdado de MarshalByRefObject) |
| GetSupportedAttributes() |
Obtém os atributos personalizados suportados pelo ouvinte de rastreamento. (Herdado de TraceListener) |
| GetType() |
Obtém o Type da instância atual. (Herdado de Object) |
| InitializeLifetimeService() |
Obtém-se um objeto de serviço vitalício para controlar a apólice vitalícia neste caso. (Herdado de MarshalByRefObject) |
| MemberwiseClone() |
Cria uma cópia superficial do atual Object. (Herdado de Object) |
| MemberwiseClone(Boolean) |
Cria uma cópia superficial do objeto atual MarshalByRefObject . (Herdado de MarshalByRefObject) |
| ToString() |
Devolve uma cadeia que representa o objeto atual. (Herdado de Object) |
| TraceData(TraceEventCache, String, TraceEventType, Int32, Object) |
Escreve informação de rastreio, um objeto de dados e informações de eventos no registo de eventos. |
| TraceData(TraceEventCache, String, TraceEventType, Int32, Object[]) |
Escreve informação de rastreio, um array de objetos de dados e informações de eventos no registo de eventos. |
| TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[]) |
Escreve informações de rastreamento, um array formatado de objetos e informações de eventos no registo de eventos. |
| TraceEvent(TraceEventCache, String, TraceEventType, Int32, String) |
Escreve informações de rastreio, uma mensagem e informações de eventos no registo de eventos. |
| TraceEvent(TraceEventCache, String, TraceEventType, Int32) |
Escreve informações de rastreio e evento para a saída específica do ouvinte. (Herdado de TraceListener) |
| TraceTransfer(TraceEventCache, String, Int32, String, Guid) |
Escreve informação de rastreio, uma mensagem, uma identidade de atividade relacionada e informações de eventos para a saída específica do ouvinte. (Herdado de TraceListener) |
| Write(Object, String) |
Escreve um nome de categoria e o valor do método do objeto ToString() para o ouvinte que crias quando implementas a TraceListener classe. (Herdado de TraceListener) |
| Write(Object) |
Escreve o valor do método do objeto ToString() para o ouvinte que crias quando implementas a TraceListener classe. (Herdado de TraceListener) |
| Write(String, String) |
Escreve um nome de categoria e uma mensagem para o ouvinte que crias quando implementas a TraceListener classe. (Herdado de TraceListener) |
| Write(String) |
Escreve uma mensagem no registo de eventos neste caso. |
| WriteIndent() |
Escreve o indentamento para o ouvinte que crias quando implementas esta classe, e redefine a NeedIndent propriedade para |
| WriteLine(Object, String) |
Escreve um nome de categoria e o valor do método do objeto ToString() para o ouvinte que crias quando implementas a TraceListener classe, seguido de um terminador de linha. (Herdado de TraceListener) |
| WriteLine(Object) |
Escreve o valor do método do ToString() objeto para o ouvinte que crias quando implementas a TraceListener classe, seguido de um terminador de linha. (Herdado de TraceListener) |
| WriteLine(String, String) |
Escreve um nome de categoria e uma mensagem para o ouvinte que crias quando implementas a TraceListener classe, seguido de um terminador de linha. (Herdado de TraceListener) |
| WriteLine(String) |
Escreve uma mensagem no registo de eventos neste caso. |
Aplica-se a
Segurança de Thread
Este tipo é seguro para fios.