Partilhar via


Como: Gravar um Log de eventos do aplicativo (Visual Basic)

Você pode usar os objetos My.Application.Log e My.Log para criar um log de informações sobre eventos que ocorrem em seu aplicativo. Este exemplo mostra como configurar um ouvinte de log de eventos de forma que My.Application.Log escreva informações de trastreamento no log de eventos do aplicativo.

Você não pode gravar no log de segurança. Para gravar no log do sistema, você deve ser um membro da conta LocalSystem ou administrador

Para exibir um log de eventos, você pode usar Server Explorer ou Windows Event Viewer. Para obter mais informações, consulte Eventos ETW o.NET Framework.

ObservaçãoObservação

Não há suporte para logs de eventos no Windows 95, Windows 98 ou Windows Millennium Edition.

Para adicionar e configurar o ouvinte de log evento

  1. Clique com o botão direito do mouse em app.config no Solution Explorer e escolha Open.

    - ou -

    Se não houver nenhum arquivo App.config,

    1. No menu Project, escolha Add New Item.

    2. No caixa de diálogo Add New Item escolha Application Configuration File.

    3. Clique em Adicionar.

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

    Você encontrará a seção <listeners> na seção <source> com o atributo nome "DefaultSource", que está aninhado sob a seção <system.diagnostics>,que está aninhada sob a seção em nível superior <configuration>.

  3. Adicione esse elemento à seção <listeners>.

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

  5. Adicione esse elemento à 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 seu aplicativo.

    ObservaçãoObservação

    Normalmente, um aplicativo grava somente erros em um log de eventos. Para obter informações sobre a filtragem de saída de log, consulte Demonstra Passo a passo: Filtragem de saída do My.Application.Log (Visual Basic).

Para gravar informações de evento para o log de eventos

  • Use o método My.Application.Log.WriteEntry ou o método My.Application.Log.WriteException para gravar informações sobre o log de eventos. Para obter mais informações, consulte Como: Gravar mensagens de Log (Visual Basic) e Como: Log Exceptions in Visual Basic.

    Depois que você configura o ouvinte de log evento para um assembly, ele recebe todas as mensagens que My.Applcation.Log grava para esse assembly.

Consulte também

Tarefas

Como: Log Exceptions in Visual Basic

Demonstra Passo a passo: Determinar onde My.Application.Log grava informações (Visual Basic)

Referência

Microsoft.VisualBasic.Logging.Log

WriteEntry

WriteException

Conceitos

Trabalhando com logs de aplicativos em Visual Basic