MessageQueueInstaller.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 fronty zpráv do registru. Tato metoda je určena k použití instalačními nástroji, které automaticky volají příslušné metody.
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 potvrzení, vrácení zpět nebo odinstalace.
Poznámky
Metoda Install zapíše informace fronty zpráv do registru a přidruží MessageQueue instanci k frontě, která se nachází v cestě určené Path vlastností. Pokud fronta ještě neexistuje, Install vytvoří transakční frontu. Install nastaví nové nebo existující vlastnosti fronty na ty, které jste zadali v souboru MessageQueueInstaller. Pokud již fronta existuje, její vlastnosti se resetují na ty z MessageQueueInstaller. Pokud existující fronta není transakční, odstraní se a pak se znovu vytvoří jako transakční fronta.
Upozornění
Pokud je nutné znovu vytvořit frontu, zprávy ve frontě budou ztraceny.
Obvykle nevoláte metody MessageQueueInstaller z kódu; obvykle jsou volána pouze instalačním nástrojem installutil.exe. Nástroj automaticky volá metodu Install během procesu instalace k zápisu informací registru, které jsou přidruženy k instalované frontě zpráv. 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 .
Po úspěšné instalaci všech komponent, které jsou přidružené k instalačnímu projektu, instalační nástroj potvrdí instalace. Commit dokončí instalaci nastavením MessageQueue fronty na odpovídající počáteční stav. Pokud fronta zadaná Path vlastností již existuje a obsahuje zprávy, Commit vymaže zprávy. Commit Installmísto toho zprávy vymaže, protože operace vymazání zpráv nelze vrátit zpět.
Instalační rutina aplikace používá instalační program Installer.Context projektu k automatické údržbě informací o komponentách, které už 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 každou MessageQueueInstaller instanci. Obvykle není nutné, aby kód explicitně upravil tyto informace o stavu.
