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 o frontě zpráv do registru. Tuto metodu mají používat instalační nástroje, 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 uložení informací potřebných k provedení operace potvrzení, vrácení zpět nebo odinstalace.
Poznámky
Metoda Install zapisuje informace o frontě 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 vlastnosti, které jste zadali v MessageQueueInstaller. Pokud už fronta existuje, její vlastnosti se resetují na vlastnosti objektu MessageQueueInstaller. Pokud existující fronta není transakční, odstraní se a pak se znovu vytvoří jako transakční fronta.
Upozornění
Pokud je nutné frontu znovu vytvořit, zprávy ve frontě budou ztraceny.
Obvykle nevoláte metody objektu MessageQueueInstaller z kódu; jsou obecně volána pouze instalačním nástrojem installutil.exe. Nástroj během procesu instalace automaticky volá metodu Install pro zápis 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í některé součásti projektu instalace, vrátí se všechny dříve nainstalované součásti zpět do svých předinstalačních stavů. Toho se dosahuje voláním metody každé komponenty Rollback .
Po úspěšné instalaci všech komponent, které jsou přidruženy k instalačnímu projektu, instalační nástroj potvrdí instalace. Commit dokončí instalaci objektu MessageQueue nastavením fronty do odpovídajícího počátečního stavu. Pokud fronta určená Path vlastností již existuje a obsahuje zprávy, Commit vymaže zprávy. CommitInstallmísto , vymaže zprávy, protože akt vymazání zpráv nelze vrátit zpět.
Rutina instalace 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 váš kód explicitně měnil tyto informace o stavu.
