MessageQueueInstaller Klasse

Definition

Namespace:

System.Messaging

Assembly:

System.Messaging.dll

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.

public ref class MessageQueueInstaller : System::Configuration::Install::ComponentInstaller

public class MessageQueueInstaller : System.Configuration.Install.ComponentInstaller

type MessageQueueInstaller = class
    inherit ComponentInstaller

Public Class MessageQueueInstaller
Inherits ComponentInstaller

Vererbung

Object

MarshalByRefObject

Component

Installer

ComponentInstaller

MessageQueueInstaller

Hinweise

Wird MessageQueueInstaller vom Installationshilfsprogramm verwendet, um Registrierungswerte zu schreiben, die der Warteschlange zugeordnet sind. Weitere Informationen zu Installationsprogrammen finden Sie unter Installutil.exe (Installationstool).

Um eine Warteschlange zu installieren, erstellen Sie eine Projektinstallationsprogrammklasse, die Installervon erbt, und legen Sie für RunInstallerAttribute die -Klasse auf truefest. Erstellen Sie innerhalb Ihres Projekts eine MessageQueueInstaller instance für jede Warteschlange in der Installation, und fügen Sie die instance Ihrer Projektinstallationsklasse hinzu.

Beim Erstellen eines MessageQueueInstaller instance können Sie optional ein vorhandenes MessageQueue (z. B. von einem Testserver) an den MessageQueueInstaller Konstruktor übergeben. Dieser Ansatz stellt automatisch die Konfigurationseinstellungen für die neue Warteschlange bereit, indem die Einstellungen der übergebenen Warteschlange gespiegelt werden. Alternativ können Sie die Eigenschaften im MessageQueueInstaller instance manuell auf die gewünschten Zustände festlegen und den parameterlosen Konstruktor aufrufen.

Wenn das Installationshilfsprogramm aufgerufen wird, wird nach gesucht RunInstallerAttribute. Wenn dies der Wert ist true, installiert das Hilfsprogramm alle Warteschlangen in der Auflistung, die Installers Ihrem Projektinstallationsprogramm zugeordnet sind. Wenn RunInstallerAttribute der Wert ist false, ignoriert das Hilfsprogramm das Projektinstallationsprogramm.

Sie ändern andere Eigenschaften eines MessageQueueInstaller instance entweder vor oder nach dem Hinzufügen des instance zur Installers Auflistung Ihres Projektinstallationsprogramms. Beispielsweise muss eine Warteschlange Path festgelegt werden, bevor das Installationshilfsprogramm ausgeführt wird.

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 und ruft auf Commit , wenn die Installation keine Ausnahme ausgelöst hat. Fehler werden bei Bedarf durch Aufrufen Rollback des Objekts, das die Ausnahme generiert hat, gesichert.

Die Installationsroutine einer Anwendung verwendet die des Projektinstallationsprogramms Installer.Context , um Informationen zu den bereits installierten Komponenten automatisch zu verwalten. Diese Zustandsinformationen werden kontinuierlich aktualisiert, wenn jede MessageQueueInstaller instance vom Hilfsprogramm installiert wird. In der Regel ist es nicht erforderlich, dass Ihr Code die Zustandsinformationen explizit ändert.

Konstruktoren

MessageQueueInstaller()	Initialisiert eine neue Instanz der MessageQueueInstaller-Klasse. Legt keine Instanzeigenschaften fest.
MessageQueueInstaller(MessageQueue)	Initialisiert eine neue Instanz der MessageQueueInstaller-Klasse. Dabei werden die Installationseinstellungen mit denen einer vorhandenen MessageQueue-Instanz initialisiert.

Eigenschaften

Authenticate	Ruft einen Wert ab, der angibt, ob die zu installierende Warteschlange nur authentifizierte Meldungen akzeptiert, oder legt diesen fest.
BasePriority	Gibt die Basispriorität an, die beim Weiterleiten von Meldungen einer öffentlichen Warteschlange über das Netzwerk verwendet wird, oder legt diese fest.
CanRaiseEvents	Ruft einen Wert ab, der angibt, ob die Komponente ein Ereignis auslösen kann. (Geerbt von Component)
Category	Ruft einen implementierungsspezifischen Warteschlangentyp ab oder legt diesen fest.
Container	Ruft die IContainer ab, die in der Component enthalten ist. (Geerbt von Component)
Context	Ruft Informationen über die derzeitige Installation ab oder legt diese fest. (Geerbt von Installer)
DesignMode	Ruft einen Wert ab, der angibt, ob sich Component gegenwärtig im Entwurfsmodus befindet. (Geerbt von Component)
EncryptionRequired	Ruft einen Wert ab, der angibt, ob die Warteschlange nur private, d. h. verschlüsselte Meldungen akzeptiert, oder legt diesen fest.
Events	Ruft die Liste der Ereignishandler ab, die dieser Component angefügt sind. (Geerbt von Component)
HelpText	Ruft den Hilfetext für alle in der entsprechenden Auflistung enthaltenen Installationsprogramme ab. (Geerbt von Installer)
Installers	Ruft die Auflistung von Installationsprogrammen ab, die dieses Installationsprogramm enthält. (Geerbt von Installer)
Label	Ruft die Beschreibung der Warteschlange ab oder legt diese fest.
MaximumJournalSize	Ruft die maximale Größe des der Warteschlange zugeordneten Journals ab oder legt diese fest.
MaximumQueueSize	Ruft die maximale Größe der Warteschlange ab oder legt diese fest.
MulticastAddress	Eingeführt in MSMQ 3.0. Ruft die der Warteschlange zugeordnete Multicastadresse ab oder oder legt diese fest.
Parent	Ruft das Installationsprogramm ab, das die Auflistung mit diesem Installationsprogramm enthält, oder legt dieses fest. (Geerbt von Installer)
Path	Ruft die Position der Warteschlange ab, auf die dieses Objekt verweist, oder legt diese fest.
Permissions	Ruft Berechtigungen ab, die der Warteschlange zugeordnet sind, oder legt diese fest.
Site	Ruft den ISite von Component ab oder legt ihn fest. (Geerbt von Component)
Transactional	Ruft einen Wert ab, der angibt, ob die Warteschlange nur Meldungen akzeptiert, die als Teil einer Transaktion gesendet wurden, oder legt diesen fest.
UninstallAction	Ruft einen Wert ab oder legt einen Wert fest, der angibt, wie das Installationsprogramm beim Deinstallieren mit der Warteschlange verfahren soll: entfernen, den Zustand vor der Installation wiederherstellen oder sie in dem gegenwärtigen Zustand belassen.
UseJournalQueue	Ruft einen Wert ab, der angibt, ob aus der Warteschlange abgerufene Meldungen auch in die zugeordnete Journalwarteschlange kopiert werden, oder legt diesen fest.

Methoden

Commit(IDictionary)	Schließt den Installationsprozess durch Übernehmen der MessageQueue-Installationsinformationen ab, die von der Install(IDictionary)-Methode in die Registrierung geschrieben wurden. Diese Methode ist für Installationstools vorgesehen, die die entsprechenden Methoden automatisch aufrufen.
CopyFromComponent(IComponent)	Kopiert die Eigenschaftswerte einer MessageQueue-Komponente, die bei der Installation einer Meldungswarteschlange benötigt werden.
CreateObjRef(Type)	Erstellt ein Objekt mit allen relevanten Informationen, die zum Generieren eines Proxys für die Kommunikation mit einem Remoteobjekt erforderlich sind. (Geerbt von MarshalByRefObject)
Dispose()	Gibt alle vom Component verwendeten Ressourcen frei. (Geerbt von Component)
Dispose(Boolean)	Gibt die von Component verwendeten nicht verwalteten Ressourcen und optional die verwalteten Ressourcen frei. (Geerbt von Component)
Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetLifetimeService()	Ruft das aktuelle Lebensdauerdienstobjekt ab, das die Lebensdauerrichtlinien für diese Instanz steuert. (Geerbt von MarshalByRefObject)
GetService(Type)	Gibt ein Objekt zurück, das einen von der Component oder von deren Container bereitgestellten Dienst darstellt. (Geerbt von Component)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
InitializeLifetimeService()	Ruft ein Lebensdauerdienstobjekt zur Steuerung der Lebensdauerrichtlinie für diese Instanz ab. (Geerbt von MarshalByRefObject)
Install(IDictionary)	Führt die Installation durch und schreibt Meldungswarteschlangeninformationen in die Registrierung. Diese Methode ist für Installationstools vorgesehen, die die entsprechenden Methoden automatisch aufrufen.
IsEquivalentInstaller(ComponentInstaller)	Bestimmt, ob das angegebene Installationsprogramm die gleiche Art von Installation wie dieses Installationsprogramm durchführen kann.
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
MemberwiseClone(Boolean)	Erstellt eine flache Kopie des aktuellen MarshalByRefObject-Objekts. (Geerbt von MarshalByRefObject)
OnAfterInstall(IDictionary)	Löst das AfterInstall-Ereignis aus. (Geerbt von Installer)
OnAfterRollback(IDictionary)	Löst das AfterRollback-Ereignis aus. (Geerbt von Installer)
OnAfterUninstall(IDictionary)	Löst das AfterUninstall-Ereignis aus. (Geerbt von Installer)
OnBeforeInstall(IDictionary)	Löst das BeforeInstall-Ereignis aus. (Geerbt von Installer)
OnBeforeRollback(IDictionary)	Löst das BeforeRollback-Ereignis aus. (Geerbt von Installer)
OnBeforeUninstall(IDictionary)	Löst das BeforeUninstall-Ereignis aus. (Geerbt von Installer)
OnCommitted(IDictionary)	Löst das Committed-Ereignis aus. (Geerbt von Installer)
OnCommitting(IDictionary)	Löst das Committing-Ereignis aus. (Geerbt von Installer)
Rollback(IDictionary)	Versetzt den Computer durch Rollback der Warteschlangeninformationen, die von der Installationsprozedur in die Registrierung geschrieben wurden, in den Zustand vor der Installation zurück. Diese Methode ist für Installationstools vorgesehen, die die entsprechenden Methoden automatisch aufrufen.
ToString()	Gibt einen String zurück, der den Namen der Component enthält (sofern vorhanden). Diese Methode darf nicht überschrieben werden. (Geerbt von Component)
Uninstall(IDictionary)	Entfernt eine Installation durch Entfernen der Warteschlangeninformationen aus der Registrierung. Diese Methode ist für Deinstallationstools vorgesehen, die die entsprechenden Methoden automatisch aufrufen.

Ereignisse

AfterInstall	Tritt ein, nachdem die Install(IDictionary)-Methoden aller in der Installers-Eigenschaft enthaltenen Installationsprogramme ausgeführt wurden. (Geerbt von Installer)
AfterRollback	Tritt ein, nachdem ein Rollback aller Installationen der Installationsprogramme in der Installers-Eigenschaft ausgeführt wurde. (Geerbt von Installer)
AfterUninstall	Tritt ein, nachdem alle Installationsprogramme in der Installers-Eigenschaft ihre jeweiligen Deinstallationsvorgänge ausgeführt haben. (Geerbt von Installer)
BeforeInstall	Tritt ein, bevor die Install(IDictionary)-Methode aller in der Auflistung der Installationsprogramme enthaltenen Installationsprogramme ausgeführt worden ist. (Geerbt von Installer)
BeforeRollback	Tritt ein, bevor ein Rollback der Installationsprogramme in der Installers-Eigenschaft ausgeführt wird. (Geerbt von Installer)
BeforeUninstall	Tritt ein, bevor die Installationsprogramme in der Installers-Eigenschaft ihre jeweiligen Deinstallationsvorgänge ausführen. (Geerbt von Installer)
Committed	Tritt ein, nachdem alle Installationsprogramme in der Installers-Eigenschaft ein Commit für ihre Installationen ausgeführt haben. (Geerbt von Installer)
Committing	Tritt ein, bevor die Installationsprogramme in der Installers-Eigenschaft ein Commit für ihre Installationen ausführen. (Geerbt von Installer)
Disposed	Tritt auf, wenn die Komponente von einem Aufruf der Dispose()-Methode verworfen wird. (Geerbt von Component)

Weitere Informationen

• Installutil.exe (Installer-Tool)