EventLogInstaller Classe

Definição

public ref class EventLogInstaller : System::Configuration::Install::ComponentInstaller

public class EventLogInstaller : System.Configuration.Install.ComponentInstaller

type EventLogInstaller = class
    inherit ComponentInstaller

Public Class EventLogInstaller
Inherits ComponentInstaller

Herança

Object

MarshalByRefObject

Component

Installer

ComponentInstaller

EventLogInstaller

Exemplos

O exemplo de código a seguir define as propriedades de instalação de uma nova origem do evento. O exemplo de código define o nome de origem e o nome do log de eventos e adiciona o EventLogInstaller à Installers coleção.

#using <System.dll>
#using <System.Configuration.Install.dll>

using namespace System;
using namespace System::Configuration::Install;
using namespace System::Diagnostics;
using namespace System::ComponentModel;

[RunInstaller(true)]
ref class MyEventLogInstaller: public Installer
{
private:
   EventLogInstaller^ myEventLogInstaller;

public:
   MyEventLogInstaller()
   {
      // Create an instance of an EventLogInstaller.
      myEventLogInstaller = gcnew EventLogInstaller;

      // Set the source name of the event log.
      myEventLogInstaller->Source = "NewLogSource";
         
      // Set the event log that the source writes entries to.
      myEventLogInstaller->Log = "MyNewLog";
         
      // Add myEventLogInstaller to the Installer collection.
      Installers->Add( myEventLogInstaller );
   }
};

using System;
using System.Configuration.Install;
using System.Diagnostics;
using System.ComponentModel;

[RunInstaller(true)]
public class MyEventLogInstaller: Installer
{
    private EventLogInstaller myEventLogInstaller;

    public MyEventLogInstaller()
    {
        // Create an instance of an EventLogInstaller.
        myEventLogInstaller = new EventLogInstaller();

        // Set the source name of the event log.
        myEventLogInstaller.Source = "NewLogSource";

        // Set the event log that the source writes entries to.
        myEventLogInstaller.Log = "MyNewLog";

        // Add myEventLogInstaller to the Installer collection.
        Installers.Add(myEventLogInstaller);
    }

    public static void Main()
    {
        MyEventLogInstaller myInstaller = new MyEventLogInstaller();
    }
}

   Imports System.Configuration.Install
Imports System.Diagnostics
Imports System.ComponentModel

<RunInstaller(True)>  _
Public Class MyEventLogInstaller
   Inherits Installer
   Private myEventLogInstaller As EventLogInstaller
   
   Public Sub New()

      ' Create an instance of an EventLogInstaller.
      myEventLogInstaller = New EventLogInstaller()

      ' Set the source name of the event log.
      myEventLogInstaller.Source = "NewLogSource"

      ' Set the event log that the source writes entries to.
      myEventLogInstaller.Log = "MyNewLog"

      ' Add myEventLogInstaller to the Installer collection.
      Installers.Add(myEventLogInstaller)
   End Sub

 Public Shared Sub Main()
 End Sub
 Dim myInstaller As New EventLogInstaller()
End Class

Comentários

O EventLogInstaller é usado pelo Installutil.exe (Ferramenta Instalador) ao instalar um log de eventos. A EventLogInstaller classe pode instalar logs de eventos somente no computador local.

Use a EventLogInstaller classe quando seu aplicativo gravar em um log de eventos; não é necessário usar um instalador de log de eventos para seu aplicativo ler de um log de eventos. Aplicativos e serviços devem gravar no log do aplicativo ou em um log personalizado. Os drivers de dispositivo devem gravar no log do sistema.

O instalador cria a origem do evento que você especifica na propriedade e a Source registra para o log de eventos especificado na Log propriedade . Esse comportamento é semelhante a chamar CreateEventSource no EventLog componente .

Use os WriteEvent métodos e WriteEntry para gravar eventos em um log de eventos. Você deve especificar uma origem do evento para gravar eventos; você deve criar e configurar a origem do evento antes de gravar a primeira entrada com a origem.

Crie a nova origem do evento durante a instalação do aplicativo. Isso permite que o sistema operacional atualize sua lista de fontes de eventos registradas e suas configurações. Se o sistema operacional não tiver atualizado sua lista de fontes de eventos e você tentar gravar um evento com a nova origem, a operação de gravação falhará. Você pode configurar uma nova fonte usando um EventLogInstallerou usando o CreateEventSource método . Você deve ter direitos administrativos no computador para criar uma nova origem do evento.

Você pode criar uma origem de evento para um log de eventos existente ou um novo log de eventos. Quando você cria uma nova fonte para um novo log de eventos, o sistema registra a origem desse log, mas o log não é criado até que a primeira entrada seja gravada nele.

Para instalar um log de eventos, crie uma classe de instalador de projeto que herda de Installere defina o RunInstallerAttribute para a classe como true. Em seu projeto, crie um EventLogInstaller para cada log de eventos no qual seu aplicativo gravará e adicione a instância à classe do instalador do projeto.

Quando o Installutil.exe (Ferramenta Instalador) é chamado, ele examina o RunInstallerAttribute. Se for true, a ferramenta instalará todos os itens da Installers coleção associados ao instalador do projeto. Se RunInstallerAttribute for false, a ferramenta ignorará o instalador do projeto.

Modifique outras propriedades de um EventLogInstaller antes ou depois de adicionar a instância à Installers coleção do instalador do projeto, mas antes da execução da ferramenta do instalador. Você deve definir a Source propriedade se o aplicativo estiver gravando no log de eventos.

Use EventLogInstaller para registrar uma nova fonte para um log de eventos novo ou existente; não use EventLogInstaller para alterar uma fonte existente. A EventLogInstaller classe não modifica as propriedades de configuração de uma origem existente para corresponder às propriedades de instalação especificadas. O Install método gerará uma exceção se a propriedade corresponder a Source um nome de origem registrado para um log de eventos diferente no computador. O Install método não registrará a origem se a propriedade corresponder a Source um nome de origem que já esteja registrado para o mesmo log de eventos especificado na Log propriedade .

Você pode registrar a origem do evento com arquivos de recurso localizados para sua categoria de evento e cadeias de caracteres de mensagem. Seu aplicativo pode gravar entradas de log de eventos usando identificadores de recurso, em vez de especificar a cadeia de caracteres real. O Visualizador de Eventos usa o identificador de recurso para localizar e exibir a cadeia de caracteres correspondente do arquivo de recurso localizado com base nas configurações de idioma atuais. Você pode registrar um arquivo separado para categorias de eventos, mensagens e cadeias de caracteres de inserção de parâmetros ou pode registrar o mesmo arquivo de recurso para todos os três tipos de cadeias de caracteres. Use as CategoryCountpropriedades , CategoryResourceFile, MessageResourceFilee ParameterResourceFile para configurar a origem para gravar entradas localizadas no log de eventos. Se o aplicativo gravar valores de cadeias de caracteres diretamente no log de eventos, você não precisará definir essas propriedades.

A origem deve ser configurada para gravar entradas localizadas ou para gravar cadeias de caracteres diretas. Se o aplicativo gravar entradas usando identificadores de recurso e valores de cadeia de caracteres, você deverá registrar duas fontes separadas. Por exemplo, configure uma fonte com arquivos de recurso e, em seguida, use essa origem WriteEvent no método para gravar entradas usando identificadores de recurso no log de eventos. Crie uma fonte diferente sem arquivos de recurso e use essa origem WriteEntry no método para gravar cadeias de caracteres diretamente no log de eventos usando essa origem.

Normalmente, você não chama os métodos da classe de EventLogInstaller dentro de seu código; eles geralmente são chamados apenas por Installutil.exe. A ferramenta chama automaticamente o Install método durante o processo de instalação. Ele recua falhas, se necessário, chamando o Rollback método para o objeto que gerou a exceção.

Construtores

Propriedades

Métodos

Eventos

Aplica-se a

Confira também

• EventLog
• CreateEventSource
• Installutil.exe (Ferramenta de Instalação)