MessageQueueInstaller.Install(IDictionary) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Führt die Installations- und Schreibvorgangswarteschlangeninformationen in die Registrierung durch. Diese Methode soll von Installationstools verwendet werden, die automatisch die entsprechenden Methoden aufrufen.
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)Parameter
- stateSaver
- IDictionary
Dient IDictionary zum Speichern von Informationen, die zum Ausführen eines Commit-, Rollback- oder Deinstallationsvorgangs erforderlich sind.
Hinweise
Die Install Methode schreibt Nachrichtenwarteschlangeninformationen in die Registrierung und ordnet die MessageQueue Instanz einer Warteschlange zu, die sich im durch die 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 diejenigen fest, die Sie in der MessageQueueInstaller. Wenn die Warteschlange bereits vorhanden ist, werden die Eigenschaften auf die eigenschaften der MessageQueueInstallerWarteschlange zurückgesetzt. Wenn die vorhandene Warteschlange nicht transaktional ist, wird sie gelöscht und dann als Transaktionswarteschlange neu erstellt.
Vorsicht
Wenn die Warteschlange neu erstellt werden muss, gehen Nachrichten in der Warteschlange verloren.
In der MessageQueueInstaller Regel rufen Sie die Methoden des Codes nicht 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 auf ihre Vorinstallationszustände zurückgesetzt. Dazu wird die Methode der einzelnen Komponenten Rollback aufgerufen.
Nach einer erfolgreichen Installation aller Komponenten, die dem Installationsprojekt zugeordnet sind, wird das Installationshilfsprogramm für die Installationen übernommen. Commit schließt die Installation ab MessageQueue , 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 werden die Nachrichten gelöscht. Commit, anstatt Installdie Nachrichten zu löschen, wird die Nachricht gelöscht, da die Löschvorgang der Nachrichten nicht rückgängig gemacht werden kann.
Die Installationsroutine einer Anwendung verwendet die Installationsprogramme des Projekts Installer.Context , um automatisch Informationen zu den Komponenten zu verwalten, die bereits installiert wurden. Diese Statusinformationen, die als stateSaver Parameter übergeben Install werden, werden kontinuierlich aktualisiert, wenn das Hilfsprogramm jede MessageQueueInstaller Instanz installiert. In der Regel ist es für Ihren Code nicht erforderlich, diese Statusinformationen explizit zu ändern.
