EventLogInstaller Classe

Definizione

Spazio dei nomi:

System.Diagnostics

Assembly:

System.Configuration.Install.dll

Consente di installare e configurare un log eventi che l'applicazione legge o nel quale scrive durante l'esecuzione.

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.

Nota

Il log di sicurezza è di sola lettura.

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.

Create 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 WriteEvent con i file di risorse e quindi usare tale origine nel metodo per scrivere voci usando identificatori di risorsa nel registro eventi. Create 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 metodo durante il Install processo di installazione. Esegue il backout degli errori, se necessario, chiamando il Rollback metodo per l'oggetto che ha generato l'eccezione.

Costruttori

EventLogInstaller()

Inizializza una nuova istanza della classe EventLogInstaller.

Proprietà

CanRaiseEvents	Ottiene un valore che indica se il componente può generare un evento. (Ereditato da Component)
CategoryCount	Ottiene o imposta il numero di categorie nel file di risorse di categoria.
CategoryResourceFile	Ottiene o imposta il percorso del file di risorse che contiene le stringhe di categoria per l'origine.
Container	Ottiene l'oggetto IContainer che contiene Component. (Ereditato da Component)
Context	Ottiene o imposta le informazioni sull'installazione corrente. (Ereditato da Installer)
DesignMode	Ottiene un valore che indica se il Component si trova in modalità progettazione. (Ereditato da Component)
Events	Ottiene l'elenco dei gestori eventi allegati a questo Component. (Ereditato da Component)
HelpText	Ottiene il testo della Guida per tutti i programmi di installazione della raccolta Installer. (Ereditato da Installer)
Installers	Ottiene la raccolta dei programmi di installazione contenuti nel programma. (Ereditato da Installer)
Log	Ottiene o imposta il nome del log sul quale impostare l'origine.
MessageResourceFile	Ottiene o imposta il percorso del file di risorse che contiene le stringhe di formattazione del messaggio per l'origine.
ParameterResourceFile	Ottiene o imposta il percorso del file di risorse che contiene le stringhe dei parametri di messaggio per l'origine.
Parent	Ottiene o imposta il programma di installazione contenente la raccolta cui appartiene questo programma di installazione. (Ereditato da Installer)
Site	Ottiene o imposta l'oggetto ISite di Component. (Ereditato da Component)
Source	Ottiene o imposta il nome origine da registrare con il log.
UninstallAction	Ottiene o imposta un valore che indica se lo Installutil.exe (Strumento Programma di installazione) deve rimuovere il log eventi o lasciarlo installato al momento della disinstallazione.

Metodi

Commit(IDictionary)	Quando ne viene eseguito l'override in una classe derivata, completa la transazione di installazione. (Ereditato da Installer)
CopyFromComponent(IComponent)	Copia i valori di proprietà di un componente EventLog necessari in fase di installazione per un log eventi.
CreateObjRef(Type)	Consente di creare un oggetto che contiene tutte le informazioni rilevanti necessarie per la generazione del proxy utilizzato per effettuare la comunicazione con un oggetto remoto. (Ereditato da MarshalByRefObject)
Dispose()	Rilascia tutte le risorse usate da Component. (Ereditato da Component)
Dispose(Boolean)	Rilascia le risorse non gestite usate da Component e, facoltativamente, le risorse gestite. (Ereditato da Component)
Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetLifetimeService()	Consente di recuperare l'oggetto servizio di durata corrente per controllare i criteri di durata per l'istanza. (Ereditato da MarshalByRefObject)
GetService(Type)	Consente di restituire un oggetto che rappresenta un servizio fornito da Component o dal relativo Container. (Ereditato da Component)
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
InitializeLifetimeService()	Ottiene un oggetto servizio di durata per controllare i criteri di durata per questa istanza. (Ereditato da MarshalByRefObject)
Install(IDictionary)	Esegue l'installazione e inserisce nel Registro di sistema le informazioni relative al log eventi.
IsEquivalentInstaller(ComponentInstaller)	Stabilisce se un programma di installazione e un altro programma di installazione specificato fanno riferimento alla stessa origine.
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
MemberwiseClone(Boolean)	Crea una copia dei riferimenti dell'oggetto MarshalByRefObject corrente. (Ereditato da MarshalByRefObject)
OnAfterInstall(IDictionary)	Genera l'evento AfterInstall. (Ereditato da Installer)
OnAfterRollback(IDictionary)	Genera l'evento AfterRollback. (Ereditato da Installer)
OnAfterUninstall(IDictionary)	Genera l'evento AfterUninstall. (Ereditato da Installer)
OnBeforeInstall(IDictionary)	Genera l'evento BeforeInstall. (Ereditato da Installer)
OnBeforeRollback(IDictionary)	Genera l'evento BeforeRollback. (Ereditato da Installer)
OnBeforeUninstall(IDictionary)	Genera l'evento BeforeUninstall. (Ereditato da Installer)
OnCommitted(IDictionary)	Genera l'evento Committed. (Ereditato da Installer)
OnCommitting(IDictionary)	Genera l'evento Committing. (Ereditato da Installer)
Rollback(IDictionary)	Ripristina lo stato del computer precedente l'installazione, ripristinando le informazioni del log eventi scritte nel Registro di sistema durante la procedura di installazione.
ToString()	Restituisce un oggetto String che contiene il nome dell'eventuale oggetto Component. Questo metodo non deve essere sottoposto a override. (Ereditato da Component)
Uninstall(IDictionary)	Rimuove un'installazione eliminando le informazioni sul log eventi dal Registro di sistema.

Eventi

AfterInstall	Si verifica dopo l'esecuzione dei metodi Install(IDictionary) di tutti i programmi di installazione contenuti nella proprietà Installers. (Ereditato da Installer)
AfterRollback	Si verifica dopo il rollback delle installazioni di tutti i programmi di installazione contenuti nella proprietà Installers. (Ereditato da Installer)
AfterUninstall	Si verifica dopo l'esecuzione delle operazioni di disinstallazione di tutti i programmi di installazione contenuti nella proprietà Installers. (Ereditato da Installer)
BeforeInstall	Si verifica dopo l'esecuzione del metodo Install(IDictionary) di ogni programma di installazione contenuto nella raccolta Installer. (Ereditato da Installer)
BeforeRollback	Si verifica prima del rollback dei programmi di installazione contenuti nella proprietà Installers. (Ereditato da Installer)
BeforeUninstall	Si verifica prima dell'esecuzione delle operazioni di disinstallazione dei programmi di installazione contenuti nella proprietà Installers. (Ereditato da Installer)
Committed	Si verifica dopo l'esecuzione del commit delle installazioni di tutti i programmi di installazione contenuti nella proprietà Installers. (Ereditato da Installer)
Committing	Si verifica prima dell'esecuzione del commit delle installazioni dei programmi di installazione contenuti nella proprietà Installers. (Ereditato da Installer)
Disposed	Si verifica quando il componente viene eliminato da una chiamata al metodo Dispose(). (Ereditato da Component)

Vedi anche

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