EventLogInstaller.Install(IDictionary) Metoda

Definicja

Wykonuje instalację i zapisuje informacje dziennika zdarzeń do rejestru.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)

Parametry

stateSaver
IDictionary

IDictionarySłuży do zapisywania informacji niezbędnych do wykonania operacji wycofywania lub odinstalowania.An IDictionary used to save information needed to perform a rollback or uninstall operation.

Wyjątki

Nazwa określona we Source właściwości jest już zarejestrowana dla innego dziennika zdarzeń.The name specified in the Source property is already registered for a different event log.

Uwagi

InstallMetoda zapisuje informacje dziennika zdarzeń w rejestrze i kojarzy dziennik zdarzeń z dziennikiem określonym przez Log Właściwość.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. Jeśli dziennik jeszcze nie istnieje (i określono Źródło), program Install tworzy dziennik i kojarzy z nim nowe źródło.If the log does not already exist (and a source is specified), Install creates a log and associates the new source with it.

Zazwyczaj nie są wywoływane metody EventLogInstaller z poziomu kodu; są one zwykle wywoływane tylko przez Installutil.exe (Narzędzie instalatora).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). Narzędzie automatycznie wywołuje Install metodę podczas instalacji, aby napisać informacje rejestru, które są skojarzone z instalowanym dziennikiem zdarzeń.The tool automatically calls the Install method during the installation process to write registry information that is associated with the event log being installed. Instalacja jest transakcyjna, dlatego jeśli podczas instalacji wystąpi awaria dowolnego składnika projektu instalacji, wszystkie wcześniej zainstalowane składniki zostaną wycofane w Stanach sprzed instalacji.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. Jest to realizowane przez wywołanie metody każdego składnika Rollback .This is accomplished by calling each component's Rollback method.

Służy EventLogInstaller do rejestrowania nowego źródła dla nowego lub istniejącego dziennika zdarzeń; nie należy używać EventLogInstaller do zmiany istniejącego źródła.Use EventLogInstaller to register a new source for a new or existing event log; do not use EventLogInstaller to change an existing source. EventLogInstallerKlasa nie modyfikuje właściwości konfiguracji istniejącego źródła, aby pasowały do określonych właściwości instalacji.The EventLogInstaller class does not modify the configuration properties of an existing source to match the specified installation properties. InstallMetoda zgłasza wyjątek, jeśli Source Właściwość jest zgodna z nazwą źródła, która jest zarejestrowana dla innego dziennika zdarzeń na komputerze.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. InstallMetoda pomija rejestrowanie źródła, jeśli Source Właściwość jest zgodna z nazwą źródłową, która jest już zarejestrowana dla tego samego dziennika zdarzeń określonego we Log właściwości.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.

Procedura instalacji aplikacji używa właściwości Instalatora projektu Installer.Context do automatycznego przechowywania informacji o składnikach, które zostały już zainstalowane.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. Informacje o stanie, które są przesyłane do programu Install jako stateSaver parametr, są stale aktualizowane, gdy narzędzie instaluje każdy EventLogInstaller .This state information, which is passed to Install as the stateSaver parameter, is continuously updated as the tool installs each EventLogInstaller. Zwykle nie jest konieczne, aby kod jawnie modyfikował te informacje o stanie.Usually, it is not necessary for your code to explicitly modify this state information.

Dotyczy

Zobacz też