EventLog Classe

Definição

public ref class EventLog : System::ComponentModel::Component, System::ComponentModel::ISupportInitialize

public class EventLog : System.ComponentModel.Component, System.ComponentModel.ISupportInitialize

type EventLog = class
    inherit Component
    interface ISupportInitialize

Public Class EventLog
Inherits Component
Implements ISupportInitialize

Herança

Object

MarshalByRefObject

Component

EventLog

Implementações

ISupportInitialize

Exemplos

O exemplo seguinte cria a fonte MySource do evento se esta ainda não existir, e escreve uma entrada no registo MyNewLogde eventos .

using System;
using System.Diagnostics;
using System.Threading;

class MySample{

    public static void Main(){

        // Create the source, if it does not already exist.
        if(!EventLog.SourceExists("MySource"))
        {
             //An event log source should not be created and immediately used.
             //There is a latency time to enable the source, it should be created
             //prior to executing the application that uses the source.
             //Execute this sample a second time to use the new source.
            EventLog.CreateEventSource("MySource", "MyNewLog");
            Console.WriteLine("CreatedEventSource");
            Console.WriteLine("Exiting, execute the application a second time to use the source.");
            // The source is created.  Exit the application to allow it to be registered.
            return;
        }

        // Create an EventLog instance and assign its source.
        EventLog myLog = new EventLog();
        myLog.Source = "MySource";

        // Write an informational entry to the event log.
        myLog.WriteEntry("Writing to event log.");
    }
}

Option Explicit
Option Strict

Imports System.Diagnostics
Imports System.Threading

Class MySample
    Public Shared Sub Main()
        
        If Not EventLog.SourceExists("MySource") Then
            ' Create the source, if it does not already exist.
            ' An event log source should not be created and immediately used.
            ' There is a latency time to enable the source, it should be created
            ' prior to executing the application that uses the source.
            ' Execute this sample a second time to use the new source.
            EventLog.CreateEventSource("MySource", "MyNewLog")
            Console.WriteLine("CreatingEventSource")
            'The source is created.  Exit the application to allow it to be registered.
            Return
        End If
        
        ' Create an EventLog instance and assign its source.
        Dim myLog As New EventLog()
        myLog.Source = "MySource"
        
        ' Write an informational entry to the event log.    
        myLog.WriteEntry("Writing to event log.")
    End Sub
End Class

Observações

EventLog permite-lhe aceder ou personalizar registos de eventos Windows, que registam informações sobre eventos importantes de software ou hardware. Usando EventLog, pode ler registos existentes, escrever entradas nos registos, criar ou eliminar fontes de eventos, apagar registos e responder a entradas de registo. Também pode criar novos registos ao criar uma fonte de eventos.

Para além de fornecer acesso a registos de eventos individuais e respetivas entradas, a EventLog classe permite-lhe aceder à coleção de todos os registos de eventos. Pode usar os static membros de EventLog para apagar registos, obter listas de registos, criar ou eliminar uma fonte, ou determinar se um computador já contém uma fonte específica.

Existem três registos de eventos predefinidos: Aplicação, Sistema e Segurança. Um registo de segurança é apenas de leitura. Outras aplicações e serviços que instale, como o Active Directory, podem ter registos de eventos adicionais.

Existem considerações de segurança ao usar a EventLog aula. EventLog Requer EventLogPermission permissões para ações específicas. Recomendamos que EventLogPermission não seja concedido a código parcialmente confiável. Nunca deve passar qualquer objeto do registo de eventos, incluindo EventLogEntryCollection objetos and EventLogEntry , para código menos confiável. Por exemplo, criar um EventLog objeto, escrever uma entrada e depois passar o EventLog objeto para código parcialmente confiável pode criar um problema de segurança, porque a capacidade de ler e escrever no registo de eventos permite que o código execute ações como emitir mensagens do registo de eventos em nome de outra aplicação.

A partir do Windows Vista, o Controlo de Conta de Utilizador (UAC) determina as credenciais de um utilizador. 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 as suas credenciais de utilizador padrão para administrador. Pode fazer isto ao iniciar uma aplicação abrindo o menu de atalho da aplicação (se estiver a usar um rato, clique com o botão direito no ícone da aplicação) e indicando que quer correr como administrador.

Podes usar EventLog para criar registos de eventos personalizados que podes visualizar através do Visualizador de Eventos do servidor. Use o método RegisterDisplayName para mostrar um nome localizado para o seu registo de eventos no Visualizador de Eventos. Use o ModifyOverflowPolicy método para configurar o comportamento do seu registo de eventos quando atingir o tamanho máximo do registo.

Para ler a partir de um registo de eventos, especifique o nome do registo (Log propriedade) e o nome do computador servidor (MachineName propriedade para o registo de eventos). Se não especificar o nome do computador servidor, assume-se o computador local, ".". Não é necessário especificar a fonte do evento (Source propriedade), porque uma fonte é necessária apenas para escrever nos logs. A Entries propriedade é automaticamente preenchida com a lista de entradas do registo de eventos.

Para escrever num registo de eventos, especifique ou crie uma fonte de evento (Source propriedade). Deve ter credenciais administrativas no computador para criar uma nova fonte de eventos. A fonte de eventos regista a sua aplicação no registo de eventos como fonte válida de entradas. Podes usar a fonte do evento para escrever apenas num registo de cada vez. A Source propriedade pode ser qualquer cadeia aleatória, mas o nome deve ser distinto de outras fontes no computador. A fonte do evento é tipicamente o nome da aplicação ou outra cadeia identificadora. Tentar criar um valor duplicado Source cria uma exceção. No entanto, um único registo de eventos pode ser associado a múltiplas fontes.

Se a fonte de eventos do registo de eventos associada à EventLog instância não existir, é criada uma nova fonte de eventos. Para criar uma fonte de evento no Windows Vista e versões posteriores ou no Windows Server 2003, deve ter credenciais administrativas.

Este requisito deve-se ao facto de todos os registos de eventos, incluindo os registos de segurança, terem de ser pesquisados para determinar se a fonte do evento é única. A partir de Windows Vista, os utilizadores não têm permissão para aceder ao registo de Segurança; por isso, é lançado um SecurityException.

As aplicações e serviços devem escrever no registo de aplicações ou num registo personalizado. Os drivers de dispositivo devem escrever no registo do sistema. Se não definir explicitamente a Log propriedade, o registo de eventos passa por defeito ao registo de aplicação.

Use os WriteEvent métodos e WriteEntry para escrever eventos num registo de eventos. Deve especificar uma fonte de eventos para escrever eventos; Deve criar e configurar o código-fonte do evento antes de escrever a primeira entrada com o código-fonte.

Crie a nova fonte de eventos durante a instalação da sua aplicação. Isto permite que o sistema operativo atualize a sua lista de fontes de eventos registadas e a sua configuração. Se o sistema operativo não atualizou a sua lista de fontes de eventos, e tentar escrever um evento com a nova fonte, a operação de escrita falhará. Pode configurar uma nova fonte usando um EventLogInstaller objeto ou o CreateEventSource método. Deve ter credenciais administrativas no computador para criar uma nova fonte de eventos.

Cada fonte pode escrever apenas num registo de eventos de cada vez; No entanto, a sua aplicação pode usar múltiplas fontes para escrever em vários registos de eventos. Por exemplo, a sua aplicação pode exigir múltiplas fontes configuradas para diferentes registos de eventos ou diferentes ficheiros de recursos. Para alterar os detalhes de configuração de uma fonte existente, tem de apagar a fonte e depois criá-la com a nova configuração. Se outras aplicações ou componentes usarem a fonte existente, crie uma nova fonte com a configuração atualizada em vez de eliminar a fonte existente.

Pode registar a fonte do evento com recursos localizados para a sua categoria de evento e as cadeias de mensagens. A sua aplicação pode escrever entradas no registo de eventos usando identificadores de recursos em vez de especificar os valores reais da cadeia. Consulte as EventLogInstaller classes e EventSourceCreationData para mais informações sobre como configurar a sua fonte com ficheiros de recursos.

Se a sua aplicação escrever valores de cadeia diretamente no registo de eventos, não precisa de definir as propriedades do ficheiro de recurso para a fonte. A fonte deve ser configurada para escrever entradas localizadas ou para escrever strings diretas. Se a sua aplicação escrever entradas usando tanto identificadores de recursos como valores de cadeia, deve registar duas fontes separadas. Por exemplo, configure uma fonte com ficheiros de recursos e depois use essa fonte no WriteEvent método para escrever entradas usando identificadores de recurso no registo de eventos. Depois cria uma fonte diferente sem ficheiros de recurso e usa essa fonte no WriteEntry método para escrever strings diretamente no registo de eventos usando essa fonte.

Ao escrever eventos, deve pelo menos especificar uma cadeia de mensagens ou o identificador de recurso para uma cadeia de mensagem. Outras propriedades de eventos são opcionais. Exemplos de configurações opcionais de eventos incluem as seguintes:

• Podes definir o EventLogEntryType para especificar o ícone que o Visualizador de Eventos mostra para a entrada.

• Pode especificar um identificador de categoria para o evento, se a sua aplicação usar categorias para filtrar os eventos.

• Pode anexar dados binários à entrada do seu evento se quiser associar informação adicional a um determinado evento.

Para obter uma lista de valores das propriedades iniciais de uma instância de EventLog, consulte o construtor EventLog.

Ver também

• EventLogInstaller
• EventLogEntry
• EntryWrittenEventArgs
• ServiceBase