EventLogInstaller Classe

Definizione

Spazio dei nomi:

System.Diagnostics

Assembly:

System.Configuration.Install.dll

Consente di installare e configurare un registro eventi da cui l'applicazione legge o 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 all'insieme EventLogInstallerInstallers .

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.

Annotazioni

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.

Utilizzare 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 delle origini eventi registrate e delle 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 finché 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 oggetto EventLogInstaller per ogni registro eventi in cui l'applicazione scriverà e aggiungere l'istanza alla classe del programma di installazione del progetto.

Quando viene chiamato ilInstallutil.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 oggetto EventLogInstaller prima o dopo l'aggiunta dell'istanza alla Installers raccolta del programma di installazione del progetto, ma prima dell'esecuzione dello strumento di installazione. È necessario impostare la Source proprietà se l'applicazione 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, invece di specificare la stringa effettiva. Il Visualizzatore eventi usa l'identificatore della 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à , MessageResourceFileCategoryResourceFile, e ParameterResourceFile per configurare l'origine per scrivere voci localizzate nel registro eventi. Se l'applicazione scrive valori di 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. Restituisce gli errori, se necessario, chiamando il Rollback metodo per l'oggetto che ha generato l'eccezione.

Costruttori

Nome	Descrizione
EventLogInstaller()	Inizializza una nuova istanza della classe EventLogInstaller.

Proprietà

Nome	Descrizione
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 stringhe di categoria per l'origine.
Container	Ottiene l'oggetto IContainer contenente l'oggetto Component. (Ereditato da Component)
Context	Ottiene o imposta informazioni sull'installazione corrente. (Ereditato da Installer)
DesignMode	Ottiene un valore che indica se è Component attualmente in modalità progettazione. (Ereditato da Component)
Events	Ottiene l'elenco dei gestori eventi associati a questo Componentoggetto . (Ereditato da Component)
HelpText	Ottiene il testo della Guida per tutti i programmi di installazione nella raccolta del programma di installazione. (Ereditato da Installer)
Installers	Ottiene la raccolta di programmi di installazione contenuti nel programma di installazione. (Ereditato da Installer)
Log	Ottiene o imposta il nome del log su cui impostare l'origine.
MessageResourceFile	Ottiene o imposta il percorso del file di risorse che contiene stringhe di formattazione dei messaggi per l'origine.
ParameterResourceFile	Ottiene o imposta il percorso del file di risorse che contiene stringhe di parametri del messaggio per l'origine.
Parent	Ottiene o imposta il programma di installazione contenente la raccolta a cui appartiene il programma di installazione. (Ereditato da Installer)
Site	Ottiene o imposta l'oggetto ISite dell'oggetto Component. (Ereditato da Component)
Source	Ottiene o imposta il nome di origine da registrare con il log.
UninstallAction	Ottiene o imposta un valore che indica se il Installutil.exe (strumento di installazione) deve rimuovere il registro eventi o lasciarlo nello stato installato in fase di disinstallazione.

Metodi

Nome	Descrizione
Commit(IDictionary)	Quando sottoposto a override in una classe derivata, completa la transazione di installazione. (Ereditato da Installer)
CopyFromComponent(IComponent)	Copia i valori delle proprietà di un EventLog componente necessari in fase di installazione per un registro eventi.
CreateObjRef(Type)	Crea un oggetto che contiene tutte le informazioni pertinenti necessarie per generare un proxy utilizzato per comunicare 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, rilascia 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()	Recupera l'oggetto servizio di durata corrente che controlla i criteri di durata per questa istanza. (Ereditato da MarshalByRefObject)
GetService(Type)	Restituisce un oggetto che rappresenta un servizio fornito da Component o da Container. (Ereditato da Component)
GetType()	Ottiene il 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 scrive le informazioni del registro eventi nel Registro di sistema.
IsEquivalentInstaller(ComponentInstaller)	Determina se un programma di installazione e un altro programma di installazione specificato fanno riferimento alla stessa origine.
MemberwiseClone()	Crea una copia superficiale del Objectcorrente. (Ereditato da Object)
MemberwiseClone(Boolean)	Crea una copia superficiale dell'oggetto corrente MarshalByRefObject . (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 in cui si trovava prima dell'installazione eseguendo il rollback delle informazioni del registro eventi scritte nel Registro di sistema dalla procedura di installazione.
ToString()	Restituisce un oggetto String contenente il nome dell'oggetto Component, se presente. Questo metodo non deve essere sottoposto a override. (Ereditato da Component)
Uninstall(IDictionary)	Rimuove un'installazione rimuovendo le informazioni del registro eventi dal Registro di sistema.

Eventi

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

Vedi anche

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