EventLogInstaller.Install(IDictionary) Metodo

  • Riferimento

Definizione

Spazio dei nomi:
System.Diagnostics
Assembly:
System.Configuration.Install.dll

Esegue l'installazione e inserisce nel Registro di sistema le informazioni relative al log eventi.

public:
 override void Install(System::Collections::IDictionary ^ stateSaver);
public override void Install (System.Collections.IDictionary stateSaver);
override this.Install : System.Collections.IDictionary -> unit
Public Overrides Sub Install (stateSaver As IDictionary)

Parametri

stateSaver
IDictionary

IDictionary utilizzato per salvare le informazioni necessarie per eseguire un'operazione di ripristino o di disinstallazione.

Eccezioni

ArgumentException

Il nome specificato nella proprietà Source è già registrato per un altro log eventi.

Commenti

Il Install metodo scrive le informazioni del registro eventi nel Registro di sistema e associa il log eventi a un log specificato dalla Log proprietà. Se il log non esiste già (e viene specificata un'origine), Install crea un log e associa la nuova origine.

In genere, non si chiamano i metodi dell'oggetto EventLogInstaller dall'interno del codice. In genere vengono chiamati solo dalla Installutil.exe (Strumento di installazione). Lo strumento chiama automaticamente il Install metodo durante il processo di installazione per scrivere informazioni del Registro di sistema associate al registro eventi da installare. L'installazione è transazionale, quindi, se si verifica un errore di qualsiasi componente del progetto di installazione durante l'installazione, tutti i componenti installati in precedenza vengono eseguito il rollback agli stati di pre-installazione. Questa operazione viene eseguita chiamando il metodo di Rollback ogni componente.

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 ignora la registrazione dell'origine se la Source proprietà corrisponde a un nome di origine già registrato per lo stesso registro eventi specificato nella Log proprietà.

La routine di installazione di un'applicazione usa la proprietà del programma di installazione del Installer.Context progetto per mantenere automaticamente le informazioni sui componenti già installati. Queste informazioni sullo stato, passate a Install come stateSaver parametro, vengono aggiornate continuamente quando lo strumento installa ogni EventLogInstalleroggetto . In genere, non è necessario che il codice modifichi in modo esplicito queste informazioni sullo stato.

Si applica a

Vedi anche