MessageQueueInstaller.Install-Methode

Artikel
08/20/2007

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

Namespace: System.Messaging
Assembly: System.Messaging (in system.messaging.dll)

Syntax

'Declaration
Public Overrides Sub Install ( _
    stateSaver As IDictionary _
)
'Usage
Dim instance As MessageQueueInstaller
Dim stateSaver As IDictionary

instance.Install(stateSaver)

public override void Install (
    IDictionary stateSaver
)

public:
virtual void Install (
    IDictionary^ stateSaver
) override

public void Install (
    IDictionary stateSaver
)

public override function Install (
    stateSaver : IDictionary
)

Parameter

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

Hinweise

Die Install-Methode schreibt Meldungswarteschlangeninformationen in die Registrierung und ordnet der MessageQueue-Instanz eine Warteschlange zu. Die Position der Warteschlange wird durch die Path-Eigenschaft angegeben. Wenn die Warteschlange noch nicht vorhanden ist, erstellt Install eine transaktionale Warteschlange. Install legt die Eigenschaften der neuen oder vorhandenen Warteschlange auf die im MessageQueueInstaller angegebenen Eigenschaften fest. Wenn die Warteschlange bereits vorhanden ist, werden ihre Eigenschaften auf die des MessageQueueInstaller zurückgesetzt. Wenn die vorhandene Warteschlange nicht transaktional ist, wird sie gelöscht und anschließend als transaktionale Warteschlange neu erstellt.

Warnung

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

Normalerweise rufen Sie die Methoden des MessageQueueInstaller nicht im Code auf. Diese werden i. d. R. nur vom Installationsprogramm installutil.exe aufgerufen. Das Dienstprogramm ruft während des Installationsprozesses automatisch die Install-Methode zum Schreiben von Registrierungsinformationen auf, die der zu installierenden Meldungswarteschlange zugeordnet sind. Die Installation ist transaktional, d. h. bei einem Fehler bei der Installation einer beliebigen Komponente des Installationsprojekts werden alle bereits installierten Komponenten in ihren Zustand vor der Installation zurückversetzt. Dies geschieht durch den Aufruf der Rollback-Methode für die jeweilige Komponente.

Nach erfolgreicher Installation aller dem Installationsprojekt zugeordneten Komponenten übernimmt das Installationsprogramm die Installationen. Das Commit schließt die Installation der MessageQueue ab, indem die Warteschlange in den entsprechenden Ausgangszustand versetzt wird. Wenn die durch die Path-Eigenschaft angegebene Warteschlange bereits vorhanden ist und Meldungen enthält, löscht Commit alle Meldungen. Die Meldungen werden von Commit und nicht von Install gelöscht, da das endgültige Löschen der Meldungen nicht zurückgenommen werden kann.

Die Installationsroutine einer Anwendung verwendet den Installer.Context des Projektinstallationsprogramms für die automatische Verwaltung von Informationen über bereits installierte Komponenten. Während das Installationsprogramm die einzelnen MessageQueueInstaller-Instanzen installiert, werden diese Zustandsinformationen, die als stateSaver-Parameter an Install übergeben werden, fortlaufend aktualisiert. Normalerweise müssen diese Zustandsinformationen vom Code nicht explizit geändert werden.

.NET Framework-Sicherheit

Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter .

Plattformen

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

MessageQueueInstaller-Klasse
MessageQueueInstaller-Member
System.Messaging-Namespace
Commit
Rollback
Uninstall
IDictionary

Freigeben über