EventLogInstaller Classe

Definizione

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

Ereditarietà

Object

MarshalByRefObject

Component

Installer

ComponentInstaller

EventLogInstaller

Esempio

Nell'esempio di codice seguente vengono impostate le proprietà di installazione per una nuova origine evento. Nell'esempio di codice vengono impostati il nome di origine e il nome del registro eventi e viene aggiunto alla EventLogInstallerInstallers raccolta.

#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

Commenti

L'oggetto EventLogInstaller viene utilizzato dal Installutil.exe (strumento di installazione) durante l'installazione di un registro eventi. La EventLogInstaller classe può installare i registri eventi solo nel computer locale.

Usare la classe quando l'applicazione EventLogInstaller scrive in un registro eventi. Non è necessario usare un programma di installazione del registro eventi per consentire all'applicazione di leggere da un registro eventi. Le applicazioni e i servizi devono scrivere nel log applicazioni o in un log personalizzato. I driver di dispositivo devono scrivere nel log di sistema.

Il programma di installazione crea l'origine evento specificata nella Source proprietà e la registra per il registro eventi specificato nella Log proprietà . Questo comportamento è simile alla chiamata CreateEventSource al EventLog componente.

Usare i WriteEvent metodi e WriteEntry per scrivere eventi in un registro eventi. È necessario specificare un'origine evento per scrivere eventi; è necessario creare e configurare l'origine evento prima di scrivere la prima voce con l'origine.

Creare la nuova origine evento durante l'installazione dell'applicazione. Ciò consente al sistema operativo di aggiornare l'elenco di origini eventi registrate e le relative configurazioni. Se il sistema operativo non ha aggiornato l'elenco delle origini eventi e si tenta di scrivere un evento con la nuova origine, l'operazione di scrittura avrà esito negativo. È possibile configurare una nuova origine usando un EventLogInstalleroggetto o usando il CreateEventSource metodo . Per creare una nuova origine evento, è necessario disporre dei diritti amministrativi nel computer.

È possibile creare un'origine evento per un registro eventi esistente o un nuovo registro eventi. Quando si crea una nuova origine per un nuovo registro eventi, il sistema registra l'origine per tale log, ma il log non viene creato fino a quando non viene scritta la prima voce.

Per installare un registro eventi, creare una classe del programma di installazione del progetto che eredita da Installere impostare per RunInstallerAttribute la classe su true. All'interno del progetto creare un EventLogInstaller oggetto per ogni registro eventi in cui l'applicazione scriverà e aggiungerà l'istanza alla classe del programma di installazione del progetto.

Quando viene chiamato il Installutil.exe (strumento di installazione), esamina .RunInstallerAttribute Se è true, lo strumento installa tutti gli elementi della Installers raccolta associati al programma di installazione del progetto. Se RunInstallerAttribute è false, lo strumento ignora il programma di installazione del progetto.

È possibile modificare altre proprietà di un EventLogInstaller oggetto prima o dopo aver aggiunto l'istanza alla Installers raccolta del programma di installazione del progetto, ma prima dell'esecuzione dello strumento di installazione. È necessario impostare la proprietà se l'applicazione Source scriverà nel registro eventi.

Usare EventLogInstaller per registrare una nuova origine per un registro eventi nuovo o esistente. Non usare EventLogInstaller per modificare un'origine esistente. La EventLogInstaller classe non modifica le proprietà di configurazione di un'origine esistente in modo che corrispondano alle proprietà di installazione specificate. Il Install metodo genera un'eccezione se la Source proprietà corrisponde a un nome di origine registrato per un registro eventi diverso nel computer. Il Install metodo non registra l'origine se la Source proprietà corrisponde a un nome di origine già registrato per lo stesso registro eventi specificato nella Log proprietà .

È possibile registrare l'origine evento con i file di risorse localizzati per la categoria di eventi e le stringhe di messaggio. L'applicazione può scrivere voci del registro eventi usando identificatori di risorsa, anziché specificare la stringa effettiva. Il Visualizzatore eventi usa l'identificatore di risorsa per trovare e visualizzare la stringa corrispondente dal file di risorse localizzato in base alle impostazioni della lingua correnti. È possibile registrare un file separato per categorie di eventi, messaggi e stringhe di inserimento di parametri oppure è possibile registrare lo stesso file di risorse per tutti e tre i tipi di stringhe. Usare le CategoryCountproprietà , CategoryResourceFile, MessageResourceFilee ParameterResourceFile per configurare l'origine per scrivere voci localizzate nel registro eventi. Se l'applicazione scrive i valori delle stringhe direttamente nel registro eventi, non è necessario impostare queste proprietà.

L'origine deve essere configurata per la scrittura di voci localizzate o per la scrittura di stringhe dirette. Se l'applicazione scrive voci usando sia identificatori di risorsa che valori stringa, è necessario registrare due origini separate. Ad esempio, configurare un'origine con i file di risorse e quindi usare tale origine nel WriteEvent metodo per scrivere voci usando gli identificatori di risorsa nel registro eventi. Creare un'origine diversa senza file di risorse e quindi usare tale origine nel WriteEntry metodo per scrivere stringhe direttamente nel registro eventi usando tale origine.

In genere, non si chiamano i metodi della classe dall'interno del EventLogInstaller codice. In genere vengono chiamati solo da Installutil.exe. Lo strumento chiama automaticamente il Install metodo durante il processo di installazione. Esegue il backup degli errori, se necessario, chiamando il Rollback metodo per l'oggetto che ha generato l'eccezione.

Costruttori

Proprietà

Metodi

Eventi

Si applica a

Vedi anche

• EventLog
• CreateEventSource
• Installutil.exe (strumento di installazione)