MessageQueueInstaller.Install(IDictionary) Metódus
Definíció
Fontos
Egyes információk olyan, kiadás előtti termékekre vonatkoznak, amelyek a kiadásig még jelentősen módosulhatnak. A Microsoft nem vállal kifejezett vagy törvényi garanciát az itt megjelenő információért.
Elvégzi a telepítést, és üzenetsoradatokat ír a beállításjegyzékbe. Ezt a módszert a telepítési eszközöknek kell használniuk, amelyek automatikusan meghívják a megfelelő módszereket.
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)Paraméterek
- stateSaver
- IDictionary
A IDictionary véglegesítési, visszaállítási vagy eltávolítási művelet végrehajtásához szükséges adatok mentésére szolgál.
Megjegyzések
A Install metódus üzenetsoradatokat ír a beállításjegyzékbe, és társítja a MessageQueue példányt a tulajdonság által Path megadott útvonalon található üzenetsorhoz. Ha az üzenetsor még nem létezik, Install létrehoz egy tranzakciós üzenetsort. Install az új vagy meglévő üzenetsor-tulajdonságokat azokra állítja be, amelyeket a MessageQueueInstaller. Ha az üzenetsor már létezik, a tulajdonsága visszaáll az MessageQueueInstalleradott üzenetsoréra. Ha a meglévő üzenetsor nem tranzakciós, akkor a rendszer törli, majd újra létrehozza tranzakciós üzenetsorként.
Figyelmeztetés
Ha újra létre kell hozni az üzenetsort, az üzenetsor üzenetei elvesznek.
Általában nem a kódból hívja meg a MessageQueueInstaller metódusokat, általában csak a installutil.exe telepítési segédprogram hívja meg őket. A segédprogram automatikusan meghívja a metódust a Install telepítési folyamat során, hogy megírja a telepített üzenetsorhoz társított beállításjegyzék-adatokat. A telepítés tranzakciós, ezért ha a telepítés során valamelyik telepítési projektösszetevő meghibásodik, a rendszer az összes korábban telepített összetevőt visszaállítja a telepítés előtti állapotba. Ez az egyes összetevők metódusának meghívásával Rollback érhető el.
A telepítési projekthez társított összes összetevő sikeres telepítése után a telepítési segédprogram véglegesíti a telepítéseket. Commit befejezi a telepítést úgy, hogy az MessageQueue üzenetsort a megfelelő kezdeti állapotra állítja. Ha a tulajdonság által Path megadott üzenetsor már létezik, és üzeneteket tartalmaz, Commit törli az üzeneteket. Commitahelyett Install, hogy törli az üzeneteket, mert az üzenetek törlési művelete nem állítható vissza.
Az alkalmazás telepítési rutinja a projekttelepítő Installer.Context használatával automatikusan fenntartja a már telepített összetevőkkel kapcsolatos információkat. A paraméterként Install átadott stateSaver állapotinformációk folyamatosan frissülnek, ahogy a segédprogram telepíti az egyes MessageQueueInstaller példányokat. Általában nem szükséges, hogy a kód explicit módon módosítsa ezt az állapotinformációt.
