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 ukládání informací potřebných k provedení operace vrácení zpět nebo odinstalace.
Výjimky
Název zadaný ve Source vlastnosti je již registrován pro jiný protokol událostí.
Poznámky
Metoda Install zapíše informace protokolu událostí do registru a přidruží protokol událostí k protokolu určenému Log vlastností. Pokud protokol ještě neexistuje (a je zadaný zdroj), Install vytvoří protokol a přidruží k němu nový zdroj.
Obvykle nevoláte metody EventLogInstaller z kódu; obvykle se volají pouze Installutil.exe (instalačním nástrojem). Nástroj během procesu instalace automaticky volá metodu Install pro zápis informací registru přidružených k instalovanému protokolu událostí. Instalace je transakční, takže pokud během instalace dojde k selhání jakékoli součásti instalačního projektu, všechny dříve nainstalované komponenty se vrátí zpět do stavu předinstalace. Toho se dosahuje voláním metody jednotlivých komponent 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 vlastnostem instalace. Metoda Install vyvolá výjimku, pokud Source vlastnost odpovídá zdrojovému názvu, 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ž registrován pro stejný protokol událostí zadaný ve Log vlastnosti.
Instalační rutina aplikace používá vlastnost instalačního programu Installer.Context 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í při instalaci každého EventLogInstallernástroje . Obvykle není nutné, aby kód explicitně upravil tyto informace o stavu.
