MessageQueueInstaller.Commit-Methode

Artikel
08/20/2007

Schließt den Installationsprozess durch Übernehmen der MessageQueue-Installationsinformationen ab, die von der Install-Methode in die Registrierung geschrieben wurden. 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 Commit ( _
    savedState As IDictionary _
)
'Usage
Dim instance As MessageQueueInstaller
Dim savedState As IDictionary

instance.Commit(savedState)

public override void Commit (
    IDictionary savedState
)

public:
virtual void Commit (
    IDictionary^ savedState
) override

public void Commit (
    IDictionary savedState
)

public override function Commit (
    savedState : IDictionary
)

Parameter

savedState
Ein IDictionary, das den Zustand des Computers nach der Installation enthält.

Hinweise

Normalerweise rufen Sie die Methoden von MessageQueueInstaller nicht im Code auf. Diese werden i. d. R. nur vom Installationsprogramm installutil.exe aufgerufen. Das Installationsprogramm ruft bei der Installation automatisch die Install-Methode auf. 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 übernimmt, werden die Zustandsinformationen, die Commit als savedState-Parameter übergeben werden, fortlaufend aktualisiert. Normalerweise müssen diese Zustandsinformationen vom Code nicht explizit geändert werden. Nach dem Leeren der Warteschlange sendet Commit an den der Installation zugeordneten savedState einen Protokolleintrag.

.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

Freigeben über