EventLogInstaller.Install(IDictionary) Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
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 -> unitPublic 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.
