Sdílet prostřednictvím


EventLogInstaller.Install(IDictionary) Metoda

Definice

Provede instalaci a zapíše informace protokolu událostí do registru.

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

Slouží IDictionary k uložení informací potřebných k provedení operace vrácení zpět nebo odinstalace.

Výjimky

Název zadaný ve Source vlastnosti je již zaregistrovaný pro jiný protokol událostí.

Poznámky

Metoda Install zapisuje informace protokolu událostí do registru a přidruží protokol událostí k protokolu, který je určen Log vlastností. Pokud protokol ještě neexistuje (a zdroj je zadaný), Install vytvoří protokol a přidruží k němu nový zdroj.

Obvykle nevoláte metody EventLogInstaller z kódu; jsou obecně volána pouze Installutil.exe (instalační nástroj). Nástroj během procesu instalace automaticky volá metodu Install pro zápis informací registru, které jsou přidruženy k instalovanému protokolu událostí. Instalace je transakční, takže pokud během instalace dojde k selhání některé součásti projektu instalace, všechny dříve nainstalované komponenty se vrátí zpět do stavu před instalací. Toho se dosahuje voláním metody každé komponenty Rollback .

Slouží EventLogInstaller k registraci nového zdroje pro nový nebo existující protokol událostí. Nepoužívejte EventLogInstaller ke změně existujícího zdroje. Třída EventLogInstaller neupravuje vlastnosti konfigurace existujícího zdroje tak, aby odpovídaly zadaným instalačním vlastnostem. Metoda Install vyvolá výjimku, pokud Source vlastnost odpovídá názvu zdroje, který je registrován pro jiný protokol událostí v počítači. Metoda Install přeskočí registraci zdroje, pokud Source vlastnost odpovídá názvu zdroje, který je již zaregistrován pro stejný protokol událostí zadaný ve Log vlastnosti.

Rutina instalace aplikace používá vlastnost instalačního Installer.Context programu projektu k automatické údržbě informací o komponentách, které již byly nainstalovány. Tyto informace o stavu, které se předávají Install jako stateSaver parametr, se průběžně aktualizují, protože nástroj nainstaluje jednotlivé EventLogInstaller. Obvykle není nutné, aby váš kód explicitně měnil tyto informace o stavu.

Platí pro

Viz také