Sdílet prostřednictvím

MessageQueueInstaller.Install(IDictionary) Metoda

  • Reference

Definice

Obor názvů:
System.Messaging
Sestavení:
System.Messaging.dll

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 -> unit
Public 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.

Platí pro

Viz také