MessageQueueInstaller-Klasse
Ermöglicht das Installieren und Konfigurieren einer Warteschlange, die für das Ausführen einer Anwendung benötigt wird. Diese Klasse wird vom Installationsprogramm, z. B. InstallUtil.exe, beim Installieren einer MessageQueue aufgerufen.
Namespace: System.Messaging
Assembly: System.Messaging (in system.messaging.dll)
Syntax
'Declaration
Public Class MessageQueueInstaller
Inherits ComponentInstaller
'Usage
Dim instance As MessageQueueInstaller
public class MessageQueueInstaller : ComponentInstaller
public ref class MessageQueueInstaller : public ComponentInstaller
public class MessageQueueInstaller extends ComponentInstaller
public class MessageQueueInstaller extends ComponentInstaller
Hinweise
Der MessageQueueInstaller wird vom Installationsprogramm zum Schreiben von Registrierungswerten benötigt, die der Warteschlange zugeordnet sind. Weitere Informationen über Installationsprogramme finden Sie unter Installer-Tool (Installutil.exe).
Erstellen Sie zum Installieren einer Warteschlange eine Projektinstallationsprogramm-Klasse, die von Installer erbt, und legen Sie das RunInstallerAttribute der Klasse auf true fest. Erstellen Sie für jede Warteschlange in der Installation im Projekt eine MessageQueueInstaller-Instanz, und fügen Sie diese der Projektinstallationsprogramm-Klasse hinzu.
Beim Erstellen einer MessageQueueInstaller-Instanz können Sie dem MessageQueueInstaller-Konstruktor bei Bedarf eine vorhandene MessageQueue hinzufügen, z. B. von einem Testserver. Bei dieser Vorgehensweise werden die Konfigurationseinstellungen für die neue Warteschlange automatisch durch Spiegelung der übergebenen Warteschlange bereitgestellt. Sie können die Eigenschaften der MessageQueueInstaller-Instanz auch manuell auf die gewünschten Zustandswerte festlegen und den Standardkonstruktor aufrufen.
Nach dem Aufruf sucht das Installationsprogramm das RunInstallerAttribute. Wenn dieses true ist, installiert das Programm sämtliche Warteschlangen der Installers-Auflistung, die dem Projektinstallationsprogramm zugeordnet ist. Wenn RunInstallerAttribute den Wert false hat, ignoriert das Dienstprogramm das Projektinstallationsprogramm.
Weitere Eigenschaften des MessageQueueInstaller können vor oder nach dem Hinzufügen der Instanz zur Installers-Auflistung des Projektinstallationsprogramms geändert werden. Der Path einer Warteschlange muss z. B. vor dem Ausführen des Installationsdienstprogramms festgelegt werden.
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 Installationsvorgangs automatisch die Install-Methode auf und ruft Commit auf, wenn die Installation keine Ausnahme ausgelöst hat. Fehler werden ggf. behoben, indem Rollback für das Objekt aufgerufen wird, das die Ausnahme generiert hat.
Die Installationsroutine einer Anwendung verwendet den Installer.Context des Projektinstallationsprogramms für die automatische Verwaltung von Informationen über bereits installierte Komponenten. Während das Dienstprogramm die einzelnen MessageQueueInstaller-Instanzen installiert, werden die Zustandsinformationen fortlaufend aktualisiert. Normalerweise müssen diese Zustandsinformationen vom Code nicht explizit geändert werden.
Vererbungshierarchie
System.Object
System.MarshalByRefObject
System.ComponentModel.Component
System.Configuration.Install.Installer
System.Configuration.Install.ComponentInstaller
System.Messaging.MessageQueueInstaller
Threadsicherheit
Alle öffentlichen statischen (Shared in Visual Basic) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.
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-Member
System.Messaging-Namespace