Compartilhar via


Como: Adicionar o aplicativo sistema autônomo uma fonte de log de eventos entradas

Antes de seu componente pode gravar uma entrada em um log de eventos, você deve registrá-lo com o log de eventos sistema autônomo uma fonte válida de eventos.Você pode fazer isso usando o CreateEventSource método e especificar uma seqüência de caracteres que identifica exclusivamente o seu componente para o log de eventos. Ao escrever uma entrada de log, o sistema usa a fonte identificados para localizar o log apropriado colocar sua entrada.O EventLog instância do componente pode gravar apenas um único log ao mesmo time.

Observação:

Por padrão, se você tentar gravar uma entrada sem primeiro ter registrado seu componente sistema autônomo uma fonte válida, o sistema automaticamente registra fonte w i a log de eventos, usando o valor das Source propriedade sistema autônomo a seqüência de caracteres de fonte. Em geral, criar nova fonte do evento durante a instalação do seu aplicativo.Isso dá time para o sistema operacional atualizar sua lista de fontes de evento registrados e suas configurações.Se o sistema operacional não tenha atualizado sua lista de fontes de eventos e você tentar gravar um evento com a nova fonte, que haverá falha na operação de gravação.Se criar a fonte durante a instalação não for uma opção, tente criar a fonte bem antes da primeira operação de gravar, talvez, durante a inicialização do aplicativo.Se você escolher essa abordagem, certifique-se de que seu código de inicialização está sendo executado com direitos de administrador no computador.Esses direitos são necessários para a criação de novas fontes de evento.

Se você especificar o nome de um log que não existe quando você usa o CreateEventSource método, o sistema cria um novo e personalizado evento log para você com a primeira vez que você tenta gravar uma entrada no log desse nome. Para obter mais informações, consulte Como: Criar e Remove Custom evento Logs.

Você pode registrar-se a fonte de eventos com recursos localizados para suas seqüências de categoria e a mensagem de evento.O aplicativo pode gravar entradas do log de eventos usando identificadores de recurso, em vez de especificar os valores de seqüência real.Consulte o EventLogInstaller e EventSourceCreationData classes para obter mais informações sobre como configurar sua fonte com arquivos de recurso.

Para estabelecer seu componente sistema autônomo uma fonte do evento

  • Para criar entradas no computador local, chame o CreateEventSource método e especifique o nome de seqüência e o log de fonte sistema autônomo parâmetros.

    Observação:

    Se você especificar nulo ("") para o nome do log, o padrão será Application.

    O exemplo a seguir mostra sistema autônomo registrar seu componente MyApp1 sistema autônomo uma fonte para o log do aplicativo. Esse código supõe que um Imports ou using demonstrativo existe para o System.Diagnostics namespace:

    EventLog.CreateEventSource("MyApp1", "Application")
    
         System.Diagnostics.EventLog.CreateEventSource("MyApp1", "Application");
    
    Dica:

    Para criar uma fonte do evento em um computador remoto, use EventSourceCreationData.O código a seguir mostra um exemplo:

    Dim creationData As New EventSourceCreationData("ApplicationName", "Application")
    creationData.MachineName = "ServerName"
    EventLog.CreateEventSource(creationData)
    
         System.Diagnostics.EventSourceCreationData creationData = new
                System.Diagnostics.EventSourceCreationData("ApplicationName", "Application");
            creationData.MachineName = "ServerName";
            EventLog.CreateEventSource(creationData);
    

Consulte também

Tarefas

Como: Determinar se existe uma fonte do evento

Como: Remover uma fonte do evento

Como: Criar e Remove Custom evento Logs

Demonstra Passo a passo: Explorando os logs de eventos, fontes de evento e entradas

Conceitos

Introdução ao componente EventLog

Referência

EventLog