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 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);
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