EventLogInstaller.Install(IDictionary) EventLogInstaller.Install(IDictionary) EventLogInstaller.Install(IDictionary) EventLogInstaller.Install(IDictionary) Method

Definizione

Esegue l'installazione e inserisce nel Registro di sistema le informazioni relative al log eventi.Performs the installation and writes event log information to the registry.

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 IDictionary IDictionary

IDictionary utilizzato per salvare le informazioni necessarie per eseguire un'operazione di ripristino o di disinstallazione.An IDictionary used to save information needed to perform a rollback or uninstall operation.

Eccezioni

Il nome specificato nella proprietà Source è già registrato per un altro log eventi.The name specified in the Source property is already registered for a different event log.

Commenti

Il Install metodo scrive le informazioni del registro eventi nel registro di sistema e associa il registro eventi a un log specificato Log dalla proprietà.The Install method writes event log information to the registry, and associates the event log with a log that is specified by the Log property. Se il log non esiste già (e viene specificata un'origine), Install crea un log e lo associa al nuovo codice sorgente.If the log does not already exist (and a source is specified), Install creates a log and associates the new source with it.

In genere, non si chiamano i metodi di EventLogInstaller dall'interno del codice. vengono in genere chiamati solo da installutil. exe (utilità di installazione).Typically, you do not call the methods of the EventLogInstaller from within your code; they are generally called only by the Installutil.exe (Installer Tool). Lo strumento chiama automaticamente il Install metodo durante il processo di installazione per scrivere le informazioni del registro di sistema associate al registro eventi in fase di installazione.The tool automatically calls the Install method during the installation process to write registry information that is associated with the event log being installed. L'installazione è transazionale, pertanto 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 agli Stati di preinstallazione.Installation is transactional, so if there is a failure of any installation project component during the installation, all the previously-installed components are rolled back to their pre-installation states. Questa operazione viene eseguita chiamando il Rollback metodo di ogni componente.This is accomplished by calling each component's Rollback method.

Utilizzare EventLogInstaller per registrare una nuova origine per un registro eventi nuovo o esistente. non utilizzare EventLogInstaller per modificare un'origine esistente.Use EventLogInstaller to register a new source for a new or existing event log; do not use EventLogInstaller to change an existing source. La EventLogInstaller classe non modifica le proprietà di configurazione di un'origine esistente in modo che corrispondano alle proprietà di installazione specificate.The EventLogInstaller class does not modify the configuration properties of an existing source to match the specified installation properties. Il Install metodo genera un'eccezione se la Source proprietà corrisponde a un nome di origine registrato per un registro eventi diverso nel computer.The Install method throws an exception if the Source property matches a source name that is registered for a different event log on the 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 Log eventi specificato nella proprietà.The Install method skips registering the source if the Source property matches a source name that is already registered for the same event log specified in the Log property.

La routine di installazione di un'applicazione usa la Installer.Context proprietà del programma di installazione del progetto per gestire automaticamente le informazioni sui componenti che sono già stati installati.An application's install routine uses the project installer's Installer.Context property to automatically maintain information about the components that have already been installed. Queste informazioni sullo stato, che vengono passate Install a stateSaver come parametro, vengono aggiornate continuamente EventLogInstallerdurante l'installazione dello strumento.This state information, which is passed to Install as the stateSaver parameter, is continuously updated as the tool installs each EventLogInstaller. In genere, non è necessario che il codice modifichi in modo esplicito queste informazioni sullo stato.Usually, it is not necessary for your code to explicitly modify this state information.

Si applica a

Vedi anche