Share via


Como gravar em um log de eventos do aplicativo (Visual Basic)

É possível usar os objetos My.Application.Log e My.Log para gravar informações sobre eventos que ocorrem em seu aplicativo. Este exemplo mostra como configurar um ouvinte de log de eventos. Assim, My.Application.Log grava informações de rastreamento no log de eventos do aplicativo.

Não é possível gravar no log de segurança. Para gravar no log do sistema, é necessário ser um membro do LocalSystem ou ter uma conta Administrador.

Para exibir um log de eventos, é possível usar o Gerenciador de Servidores ou o Visualizador de Eventos do Windows. Para obter mais informações, consulte Eventos ETW no .NET Framework.

Para adicionar e configurar o ouvinte de log de eventos

  1. Clique com o botão direito do mouse em app.config no Gerenciador de Soluções e escolha Abrir.

    - ou -

    Se não houver nenhum arquivo app.config,

    1. No menu Projeto, escolha Adicionar Novo Item.

    2. Na caixa de diálogo Adicionar novo item, escolha Arquivo de configuração de aplicativo.

    3. Clique em Adicionar.

  2. Localize a seção <listeners> no arquivo de configuração de aplicativo.

    Localize a seção <listeners> na seção <source> com o atributo de nome "DefaultSource", aninhado na seção <system.diagnostics>, aninhada na seção <configuration> superior.

  3. Adicione esse elemento a essa seção <listeners>:

    <add name="EventLog"/>
    
  4. Localize a seção <sharedListeners>, na seção <system.diagnostics>, na seção <configuration> superior.

  5. Adicione esse elemento a essa seção <sharedListeners>:

    <add name="EventLog"
        type="System.Diagnostics.EventLogTraceListener, System, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089"
         initializeData="APPLICATION_NAME"/>
    

    Substitua APPLICATION_NAME pelo nome do aplicativo.

    Observação

    Normalmente, um aplicativo grava somente erros no log de eventos. Para obter informações sobre filtragem de saída de log, consulte Instruções passo a passo: filtrando a saída de My.Application.Log.

Para gravar informações de evento em um log de eventos

Use o método My.Application.Log.WriteEntry ou My.Application.Log.WriteException para gravar informações no log de eventos. Para obter mais informações, consulte Como: Gravar mensagens de log e Como registrar em log as exceções.

Depois de configurar o ouvinte de log de eventos para um assembly, ele receberá todas as mensagens que My.Application.Log grava desse assembly.

Confira também