Compartilhar via


Como: Configurar EventLog componente Instances

Há três propriedades principais envolvidos na configuração de uma instância do EventLog componente:

  • The Log propriedade indica o log com o qual deseja interagir.

  • The MachineName propriedade indica o computador no qual reside o log que você está trabalhando com.

  • The Source propriedade indica a seqüência de caracteres de fonte que será usada para identificar seu componente quando ele grava entradas em um log.

A forma como você configura seu EventLog ocorrência de componente depende de como você pretende usá-lo:

  • Se você estiver planejando gravar entradas para um log, faça uma das duas coisas.Ou você deve registrar uma fonte usando o CreateEventSource método e um conjunto de EventLog componente Source a propriedade para a mesma fonte, ou configure o MachineName, Log, e Source Propriedades do componente.

    Observação:

    Você pode conjunto o Log propriedade em seu componente diretamente ou você pode conjunto-la no código que registra seu componente sistema autônomo uma origem do evento. Após registrar o componente sistema autônomo uma fonte, uma conexão é já conjunto no registro do servidor vinculando o componente a um log específico.

  • Se você planeja ler entradas de log ou monitor um log, você deve conjunto o MachineName e Log propriedades para indicar o log que você está assistindo. Não é necessário conjunto o Source propriedade nesse caso.

  • Se você desejar que seu componente para poder receber notificação de EntryWritten eventos, você deve conjunto EnableRaisingEvents para true. Para obter mais informações, consulte Como: Manipular o EntryWritten evento.

    O exemplo a seguir mostra como configurar o seu componente para que você grave entradas no log do aplicativo.Nesse caso, a fonte não já foi registrada com o log, para que você deve especificar a seqüência de caracteres de origem, o log e o nome do computador.Você não precisa chamar explicitamente o CreateEventSource método porque o WriteEntry telefonar registrará a fonte com o log se ele já não tiver sido registrado.

    Dim EventLog1 As New EventLog("Application", "myserver", "newsource")
    EventLog1.WriteEntry("Test")
    
         System.Diagnostics.EventLog EventLog1 = new
               System.Diagnostics.EventLog("Application", "myserver", "newsource");
            EventLog1.WriteEntry("Test");
    

    Se fonte já foi registrada, você pode simplesmente conjunto o Source propriedade e gravar a entrada. Por exemplo, o código a seguir mostra como gravar uma entrada em um log usando uma fonte que já foi registrada.

    If Not EventLog.SourceExists("ExistingSourceString") Then
        EventLog.CreateEventSource("ExistingSourceString", "Application")
    End If
    Dim EventLog1 As New EventLog()
    EventLog1.Source = "ExistingSourceString"
    EventLog1.WriteEntry("TestEntry2")
    
         if (!System.Diagnostics.EventLog.SourceExists("ExistingSourceString"))
                System.Diagnostics.EventLog.CreateEventSource(
                   "ExistingSourceString", "Application");
    
            System.Diagnostics.EventLog EventLog1 =
               new System.Diagnostics.EventLog();
            EventLog1.Source = "ExistingSourceString";
            EventLog1.WriteEntry("TestEntry2");
    
    Observação:

    Se Você não conjunto o MachineName propriedade, sistema autônomo mostrado nesses exemplos, o computador local será considerado.

    Para obter mais informações sobre essas propriedades, consulte Referências evento log.

    As entradas que você recuperar de um evento log são categorizados por várias propriedades.Para obter informações sobre essas propriedades, consulte EventLog.

Para configurar uma instância de componente EventLog

  1. Criar uma instância do EventLog componente. Para obter mais informações, consulte Como: Criar EventLog componente Instances.

  2. conjunto a combinação apropriada do Log, MachineName, e Source propriedades:

    Se você for

    Faça isso

    Lendo ou monitorar logs de eventos

    conjunto Log e MachineName

    Gravar entradas de um log usando um novo Source seqüência de caracteres

    conjunto Source, Log, e MachineName

    Gravar entradas de um log para um existente Source

    conjunto o Source propriedade para fonte existente; as outras propriedades serão definidas automaticamente

  3. Para ativar a instância do componente receber notificações do EntryWritten evento, defina o EnableRaisingEvents propriedade para true.

Consulte também

Tarefas

Como: Criar EventLog componente Instances

Como: Adicionar o aplicativo sistema autônomo uma fonte de log de eventos entradas

Como: Gravar entradas evento logs

Conceitos

Referências evento log