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