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

Esta explicação passo a passo o levará através das áreas principais recurso do evento efetuar registrar registrar registrar em login no seu Visual Studio aplicativo. Durante esta explicação passo a passo, você aprenderá a fazer o seguinte:

• criar an EventLog componente.

• gravar código para criar e excluir logs de eventos personalizado.

• Grave entradas de vários tipos para o log personalizado.

• Ler entradas de log personalizado.

• Verifique se os registros e fontes de evento existem.

• Entradas do log desmarcar.

• Use Gerenciador de servidores para verificar os resultados de seu evento log ações.

Observação:
Seu computador pode mostrar diferentes nomes ou localizações para alguns dos elementos de interface do usuário do Visual Studio nas instruções a seguir. A edição do Visual Studio que você possui e as configurações que você usa determinam esses elementos. Para obter mais informações, consulte Configurações do Visual Studio.

Criando a interface do usuário

Neste passo-a-passo, você irá criar um aplicativos do Windows e use uma série de controles nele para iniciar uma série de evento-registrar registrar registrar em log de ações.

Para criar o formulário e controles do aplicativo

1. From the New Project dialog box, create a Visual Basic or Visual C# Windows Application, and name it EventLogApp1.

2. Adicionar botões de oito para o formulário e conjunto as seguintes propriedades para elas:

   Controle	Propriedade de texto	Propriedade nome
   Button1	Criar log personalizado	CreateLog
   Button2	Excluir log	DeleteLog
   Button3	Entrada de gravar	WriteEntry
   Button4	desmarcar o registro	ClearLog
   Button5	Verifique se existe log	VerifyLog
   Button6	Verifique se a fonte existe	VerifySource
   Button7	Remover fonte do evento	RemoveSource
   Button8	Entrada de leitura	ReadEntry

3. Por sua vez, siga estas etapas para cada botão:

   1. No designer, clicar duas vezes no botão para criar um padrão evento manipulador para esse botão.O Editor de código é exibido e um stub do botão Click evento é exibido.

   2. Retornar ao Design exibir e clicar duas vezes no botão próximo.

   3. Continue até que você tenha criado um stub de manipulador de eventos padrão para cada botão.

4. From a Componentes Guia de do Caixa de ferramentas, arrastar an EventLog componente para o formulário.

   An EventLog instância do componente aparece na área de bandeja de componentes na parte inferior do formulário.

Criando e excluindo um log personalizado

Esse procedimento, você usará o SourceExists método para verificar se a fonte está usando já existe e, em seguida, você irá telefonar o CreateEventSource método com o nome de um log que não existe. Porque esse registro não existe, o sistema será criar um log personalizado para você quando esse código é executado.

Para criar o log personalizado

1. No Editor de código, localizar o CreateLog_Click procedimento.

2. Digite o seguinte código.O log de eventos e fonte são criados sistema autônomo um emparelhar e a fonte não pode existir antes do log de eventos é criado.Depois de criar o log de eventos, a EventLog componente está configurado para acessar o novo log de eventos.

   ' Source cannot already exist before creating the log.
   If EventLog.SourceExists("Source1") Then
      EventLog.DeleteEventSource("Source1")
   End If
   
   ' Logs and Sources are created as a pair.
   EventLog.CreateEventSource("Source1", "NewLog1")
   ' Associate the EventLog component with the new log.
   EventLog1.Log = "NewLog1"
   EventLog1.Source = "Source1"
   

   // Source cannot already exist before creating the log.
   if (System.Diagnostics.EventLog.SourceExists("Source1"))
   {
      System.Diagnostics.EventLog.DeleteEventSource("Source1");
   }
   
   // Logs and Sources are created as a pair.
   System.Diagnostics.EventLog.CreateEventSource("Source1", "NewLog1");
   // Associate the EventLog component with the new log.
   eventLog1.Log = "NewLog1";
   eventLog1.Source = "Source1";
   

   Observação de segurança:
   Quando você criar um log de eventos, você necessário Decida o que fazer se esse recurso já existe.Outro processo, talvez um mal-intencionado, talvez já criou o log de eventos e ter acesso a ele.Quando você coloca dados log de eventos, os dados estão disponível para o Outros processo.

Para excluir um log personalizado

1. No Editor de código, localizar o DeleteLog_Click procedimento.

2. Digite o código a seguir:

   If EventLog.Exists("NewLog1") Then
      EventLog.Delete("NewLog1")
   End If
   

   if (System.Diagnostics.EventLog.Exists("NewLog1"))
   {
      System.Diagnostics.EventLog.Delete("NewLog1");
   }
   

Gravar entradas no log de

Esse procedimento, você usará o EventLog instância do componente que você criou para gravar entradas no log. Para fazer isso, primeiro você irá configurar o componente para usar a seqüência de fonte que recém-criado.Em seguida, você especificará duas entradas para gravar: um evento informativo e um evento de erro.

Para gravar entradas de log

1. No Editor de código, localizar o WriteEntry_Click procedimento.

2. Digite o seguinte código.Esse código usa o sobrecarregado WriteEntry método para gravar o log de eventos. O segundo formulário mostrado permite que você especifique o tipo de mensagem.Se você exibir as entradas usando o Explorer servidor na seção "Testando código O", posteriormente neste tópico, os diferentes tipos de entradas são indicados por ícones diferentes.

   EventLog1.WriteEntry("This is an informational message")
   EventLog1.WriteEntry("This is an error message", _
      Diagnostics.EventLogEntryType.Error)
   

   eventLog1.WriteEntry("This is an informational message");
   eventLog1.WriteEntry("This is an error message", 
      System.Diagnostics.EventLogEntryType.Error);
   

Limpando entradas de log

Esse procedimento, você usará o Clear método para remover as entradas existentes do log personalizado.

Para desmarcar as entradas do log

1. No Editor de código, localizar o ClearLog_Click procedimento.

2. telefonar the Clear método na EventLog ocorrência de componente:

   EventLog1.Clear()
   

   eventLog1.Clear();
   

Verificando logs e fontes

Esse procedimento, você irá criar dois procedimentos: uma que verifica a existência de log personalizado e outra que verifica se existe a seqüência de caracteres de fonte.Esses procedimentos serão usados para teste os resultados das várias ações executadas quando você executa o projeto.

Verificar a existência de log personalizado

1. No Editor de código, localizar o VerifyLog_Click procedimento.

2. Criar uma caixa de mensagem avalia se o especificado log de eventos existe e exibe true ou false de acordo.Use este código:

   Dim logExists As Boolean = EventLog.Exists("NewLog1")
   MessageBox.Show("Does the log exist? " & logExists.ToString())
   

   bool logExists = System.Diagnostics.EventLog.Exists("NewLog1");
   MessageBox.Show("Does the log exist? " + logExists.ToString());
   

Para verificar se a fonte existe

1. No Editor de código, localizar o VerifySource_Click procedimento.

2. Crie uma caixa de mensagem avalia se a fonte especificada existe e exibe true ou false de acordo.Use este código:

   Dim sourceExists As Boolean = EventLog.SourceExists("Source1")
   MessageBox.Show("Does the source exist? " + sourceExists.ToString())
   

   bool sourceExists = 
      System.Diagnostics.EventLog.SourceExists("Source1");
   MessageBox.Show("Does the source exist? " + sourceExists.ToString());
   

Removendo fontes

Esse procedimento, você irá gravar código para excluir uma seqüência de caracteres de fonte.Para fazer isso, você primeiro verificará que a fonte em questão (Source1) existe e, em seguida, chame o DeleteEventSource método para removê-lo.

Para remover fonte do evento criado

1. No Editor de código, localizar o RemoveSource_Click procedimento.

2. Adicione o seguinte código:

   If EventLog.SourceExists("Source1") Then
      EventLog.DeleteEventSource("Source1")
   End If
   

   if (System.Diagnostics.EventLog.SourceExists("Source1"))
   {
      System.Diagnostics.EventLog.DeleteEventSource("Source1");
   }
   

Ler entradas

Neste procedimento, você irá escrever um código para iterar por meio do evento coleta de entradas do log e a exibição existente mensagens no log.

Ler entradas de log personalizado criado

1. No Editor de código, localizar o ReadEntry_Click procedimento.

2. Adicione o seguinte código:

   Dim entry As EventLogEntry
   If EventLog1.Entries.Count > 0 Then
      For Each entry In EventLog1.Entries
         System.Windows.Forms.MessageBox.Show(entry.Message)
      Next
   Else
      MessageBox.Show("There are no entries in the log.")
   End If
   

   if (eventLog1.Entries.Count > 0) 
   {
      foreach (System.Diagnostics.EventLogEntry entry 
         in eventLog1.Entries)
      {
         MessageBox.Show(entry.Message);
      }
   }
   else 
   {
      MessageBox.Show("There are no entries in the log.");
   }
   

Teste seu código

Nesta seção, você usará servidor Explorer para verificar os resultados do seu código.

Para iniciar o servidor Explorer

1. From a Modo de exibição menu, acesso servidor Explorer.

2. expandir o nó do servidor corrente e, em seguida, expandir o evento Logs nó abaixo dele.

Para compilação e executar o aplicativo

1. Salvar os arquivos e pressione F5 para compilar e iniciar o seu projeto.O formulário é exibido com os oito botões que você criou.

2. clicar no Criar log personalizado botão.

   Observação:
   Você deve ter apropriado permissões para o servidor no qual seu aplicativo é executado para criar Windows evento logs.Se você receber um erro de segurança neste momento, consulte o sistema administrador.

3. Voltar para o produto, enquanto ainda está no modo de execução e clicar com o botão direito do mouse o Logs de eventos nó in servidor Explorer.

4. Clique em Atualizar.

5. Verifique se o NewLog1 log agora aparece no Logs de eventos nó.

Para teste criar, excluir e verificar logs personalizado

1. Volte ao seu formulário que está sendo executado e clicar no Verifique se existe log botão.

   Deve aparecer um aviso com o conjunto de texto como "True".

2. clicar no Excluir log botão e, em seguida, clicar no Verifique se existe log botão novamente.

   Neste momento, o aviso deve dizer "False".

3. clicar no Criar log personalizado botão novamente para recriar o log.

Para testar a entradas de escrita e ler entradas de log personalizado

1. No formulário, clicar no Entrada de gravar botão.

2. Acesso Gerenciador de servidorese expandir o NewLog1 log.

3. expandir o Source1 nó abaixo dele.

   Agora você deve ver que foram adicionadas duas entradas no log.Um terá um ícone indicando que é um Informativo entrada e um será ter um ícone indica que é um erro.

4. Volte ao formulário e clicar no Entrada de leitura botão.

   Você receberá dois prompts: uma que contenha a entrada informativa e uma que contenha a entrada de erro.

   Observação:
   Se você clicou na Entrada de gravar botão várias vezes, você irá recebeu o more solicita.

Para limpar o log de teste

1. No formulário, clicar no desmarcar o registro botão.

2. In Gerenciador de servidores, clicar com o botão direito do mouse o NewLog1 nó e, em seguida, clique em Atualizar.

   Agora você deve ver o log não contém entradas.

Para testar removendo a seqüência de caracteres de fonte

1. No formulário, clicar no Remover fonte do evento botão.

2. clicar no Verifique se a fonte existe botão.Você deverá receber uma mensagem que diz "False" para indicar que a fonteSource1 não existe mais.

3. clicar no Entrada de gravar botão.

   Observação:
   Esta ação irá Ativar gravar entradas no log, porque o WriteEntry método irá conjunto a fonte se ela não existir no momento.

4. In Gerenciador de servidores, clicar com o botão direito do mouse o NewLog1 nó e, em seguida, clique em Atualizar.Você deverá ver duas entradas no log.

5. clicar no Verifique se a fonte existe botão novamente.Você deverá receber uma mensagem que diz "True" para indicar que a fonteSource1 existe.

6. Opcionalmente, talvez você queira clicar a DeleteLog botão quando você estiver por meio de testes.Isso removerá o log de NewLog1 e a fonte Source1 para que não haja nenhuma alteração permanente a configuração do sistema.

Consulte também

Outros recursos

Sistema de monitoramento explicações passo a passo

Registrando eventos do aplicativo, do servidor e de segurança