MessageQueueInstaller.Install(IDictionary) Methode

Definition

Namespace:

System.Messaging

Assembly:

System.Messaging.dll

Führt die Installation durch und schreibt Meldungswarteschlangeninformationen in die Registrierung. Diese Methode ist für Installationstools vorgesehen, die die entsprechenden Methoden automatisch aufrufen.

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)

Parameter

stateSaver

IDictionary

Ein IDictionary, in dem die zum Ausführen eines Commit-, Rollback- oder Deinstallationsvorgangs erforderlichen Daten gespeichert werden.

Hinweise

Die Install -Methode schreibt Nachrichtenwarteschlangeninformationen in die Registrierung und ordnet die MessageQueue instance einer Warteschlange zu, die sich unter dem von der Path -Eigenschaft angegebenen Pfad befindet. Wenn die Warteschlange noch nicht vorhanden ist, Install wird eine Transaktionswarteschlange erstellt. Install legt die neuen oder vorhandenen Warteschlangeneigenschaften auf die eigenschaften fest, die Sie in MessageQueueInstallerangegeben haben. Wenn die Warteschlange bereits vorhanden ist, werden ihre Eigenschaften auf die von MessageQueueInstallerzurückgesetzt. Wenn die vorhandene Warteschlange nicht transaktional ist, wird sie gelöscht und dann als Transaktionswarteschlange neu erstellt.

Achtung

Wenn die Warteschlange neu erstellt werden muss, gehen Nachrichten in der Warteschlange verloren.

In der Regel rufen Sie die Methoden des MessageQueueInstaller nicht in Ihrem Code auf. Sie werden in der Regel nur vom installutil.exe Installationshilfsprogramm aufgerufen. Das Hilfsprogramm ruft die Install -Methode während des Installationsvorgangs automatisch auf, um Registrierungsinformationen zu schreiben, die der installierten Nachrichtenwarteschlange zugeordnet sind. Die Installation ist transaktional. Wenn also während der Installation ein Fehler einer Installationsprojektkomponente auftritt, werden alle zuvor installierten Komponenten in den Vorinstallationsstatus zurückgesetzt. Dies wird durch Aufrufen der Rollback Methode jeder Komponente erreicht.

Nachdem eine erfolgreiche Installation aller Komponenten, die dem Installationsprojekt zugeordnet sind, erfolgt ist, committet das Installationshilfsprogramm die Installationen. Commit schließt die Installation von MessageQueue ab, indem die Warteschlange auf den entsprechenden Anfangszustand festgelegt wird. Wenn die durch die Path -Eigenschaft angegebene Warteschlange bereits vorhanden ist und Nachrichten enthält, Commit löscht die Nachrichten. Commit, löscht die Nachrichten, Installda das Löschen der Nachrichten nicht zurückgesetzt werden kann.

Die Installationsroutine einer Anwendung verwendet die des Projektinstallationsprogramms Installer.Context , um Informationen zu den bereits installierten Komponenten automatisch zu verwalten. Diese Zustandsinformationen, die als stateSaver Parameter übergeben Install werden, werden kontinuierlich aktualisiert, während das Hilfsprogramm jedes MessageQueueInstaller instance installiert. In der Regel ist es nicht erforderlich, dass Ihr Code diese Zustandsinformationen explizit ändert.

Weitere Informationen

• Commit(IDictionary)
• Rollback(IDictionary)
• Uninstall(IDictionary)
• IDictionary