Compartilhar via


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