EventLogInstaller.Install(IDictionary) Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Esegue l'installazione e scrive le informazioni del registro eventi nel Registro di sistema.
public:
override void Install(System::Collections::IDictionary ^ stateSaver);public override void Install(System.Collections.IDictionary stateSaver);override this.Install : System.Collections.IDictionary -> unitPublic Overrides Sub Install (stateSaver As IDictionary)Parametri
- stateSaver
- IDictionary
Oggetto IDictionary utilizzato per salvare le informazioni necessarie per eseguire un'operazione di rollback o disinstallazione.
Eccezioni
Il nome specificato nella Source proprietà è già registrato per un registro eventi diverso.
Commenti
Il Install metodo scrive le informazioni del registro eventi nel Registro di sistema e associa il registro 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, ma 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 in fase di installazione. L'installazione è transazionale, quindi se si verifica un errore di un componente del progetto di installazione durante l'installazione, viene eseguito il rollback di tutti i componenti installati in precedenza ai relativi stati di preinstallazione. A tale scopo, chiamare 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, che vengono passate come InstallstateSaver parametro, vengono aggiornate continuamente quando lo strumento installa ogni EventLogInstaller. In genere, non è necessario che il codice modifichi in modo esplicito queste informazioni sullo stato.
