MessageQueueInstaller Klasse

Definition

Namespace:
System.Messaging
Assembly:
System.Messaging.dll

Ermöglicht ihnen, eine Warteschlange zu installieren und zu konfigurieren, die Ihre Anwendung benötigt, um sie auszuführen. Diese Klasse wird vom Installationshilfsprogramm aufgerufen, z. B. InstallUtil.exe, bei der Installation einer MessageQueue.

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

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

Um eine Warteschlange zu installieren, erstellen Sie eine Projektinstallationsklasse, die von der InstallerKlasse erbt, und legen Sie die RunInstallerAttribute Klasse auf true. Erstellen Sie in Ihrem Projekt eine MessageQueueInstaller Instanz für jede Warteschlange in der Installation, und fügen Sie der Projektinstallationsklasse die Instanz hinzu.

Beim Erstellen einer MessageQueueInstaller Instanz können Sie optional einen vorhandenen 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 in der MessageQueueInstaller Instanz manuell auf die gewünschten Zustände festlegen und den parameterlosen Konstruktor aufrufen.

Wenn das Installationshilfsprogramm aufgerufen wird, sucht es nach dem RunInstallerAttribute. Wenn dies der Grund ist, installiert das Hilfsprogramm alle Warteschlangen in der Auflistung, die Installers Ihrem Projektinstallationsprogramm zugeordnet isttrue. Wenn RunInstallerAttribute ja false, ignoriert das Hilfsprogramm das Projektinstallationsprogramm.

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

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

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 werden kontinuierlich aktualisiert, da jede MessageQueueInstaller Instanz vom Hilfsprogramm installiert wird. Es ist in der Regel nicht erforderlich, dass Ihr Code die Statusinformationen explizit ändert.

Konstruktoren

Name Beschreibung
MessageQueueInstaller()

Initialisiert eine neue Instanz der MessageQueueInstaller-Klasse. Legt keine Instanzeigenschaften fest.
MessageQueueInstaller(MessageQueue)

Initialisiert eine neue Instanz der MessageQueueInstaller Klasse, wobei die Installationseinstellungen für die einer vorhandenen MessageQueue Instanz initialisiert werden.

Eigenschaften

Name Beschreibung
Authenticate

Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob die zu installierende Warteschlange nur authentifizierte Nachrichten akzeptiert.
BasePriority

Dient zum Abrufen oder Festlegen der Basispriorität, die zum Weiterleiten der Nachrichten einer öffentlichen Warteschlange über das Netzwerk verwendet wird.
CanRaiseEvents

Ruft einen Wert ab, der angibt, ob die Komponente ein Ereignis auslösen kann.

(Geerbt von Component)
Category

Dient zum Abrufen oder Festlegen eines implementierungsspezifischen Warteschlangentyps.
Container

Ruft das, das IContainer die Component.

(Geerbt von Component)
Context

Ruft Informationen zur aktuellen Installation ab oder legt diese fest.

(Geerbt von Installer)
DesignMode

Ruft einen Wert ab, der angibt, ob sich der Component Entwurfsmodus derzeit befindet.

(Geerbt von Component)
EncryptionRequired

Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob die Warteschlange nur private oder verschlüsselte Nachrichten akzeptiert.
Events

Ruft die Liste der Ereignishandler ab, die an diese Componentangefügt sind.

(Geerbt von Component)
HelpText

Ruft den Hilfetext für alle Installationsprogramme in der Installer-Auflistung ab.

(Geerbt von Installer)
Installers

Ruft die Auflistung der Installationsprogramme ab, die dieses Installationsprogramm enthält.

(Geerbt von Installer)
Label

Dient zum Abrufen oder Festlegen einer Beschreibung der Warteschlange.
MaximumJournalSize

Ruft die maximale Größe des Journals ab, das der Warteschlange zugeordnet ist, oder legt diese fest.
MaximumQueueSize

Ruft die maximale Größe der Warteschlange ab oder legt sie fest.
MulticastAddress

Eingeführt in MSMQ 3.0. Dient zum Abrufen oder Festlegen der Multicastadresse, die der Warteschlange zugeordnet ist.
Parent

Ruft das Installationsprogramm ab, das die Auflistung enthält, zu der dieses Installationsprogramm gehört, oder legt diesen fest.

(Geerbt von Installer)
Path

Dient zum Abrufen oder Festlegen der Position der Warteschlange, auf die von diesem Objekt verwiesen wird.
Permissions

Dient zum Abrufen oder Festlegen von Berechtigungen, die der Warteschlange zugeordnet sind.
Site

Ruft den ISite von Component ab oder legt ihn fest.

(Geerbt von Component)
Transactional

Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob die Warteschlange nur Nachrichten akzeptiert, die als Teil einer Transaktion gesendet werden.
UninstallAction

Dient zum Abrufen oder Festlegen eines Werts, der angibt, was das Installationsprogramm zur Deinstallationszeit mit der Warteschlange ausführt: Entfernen, Wiederherstellen des Installationszustands oder Verlassen des Installationsstatus.
UseJournalQueue

Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob Nachrichten, die aus der Warteschlange abgerufen werden, auch in die zugeordnete Journalwarteschlange kopiert werden.

Methoden

Name Beschreibung
Commit(IDictionary)

Schließt den Installationsprozess ab, indem die MessageQueue Installationsinformationen, die die Methode in die Install(IDictionary) Registrierung geschrieben hat, commiten. Diese Methode soll von Installationstools verwendet werden, die automatisch die entsprechenden Methoden aufrufen.
CopyFromComponent(IComponent)

Kopiert die Eigenschaftswerte einer MessageQueue Komponente, die zur Installationszeit für eine Nachrichtenwarteschlange erforderlich sind.
CreateObjRef(Type)

Erstellt ein Objekt, das alle relevanten Informationen enthält, die zum Generieren eines Proxys erforderlich sind, der für die Kommunikation mit einem Remoteobjekt verwendet wird.

(Geerbt von MarshalByRefObject)
Dispose()

Veröffentlicht alle ressourcen, die von der Component.

(Geerbt von Component)
Dispose(Boolean)

Gibt die nicht verwalteten Ressourcen frei, die von den Component verwalteten Ressourcen verwendet werden, und gibt optional die verwalteten Ressourcen frei.

(Geerbt von Component)
Equals(Object)

Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist.

(Geerbt von Object)
GetHashCode()

Dient als Standardhashfunktion.

(Geerbt von Object)
GetLifetimeService()

Ruft das aktuelle Lebensdauerdienstobjekt ab, das die Lebensdauerrichtlinie für diese Instanz steuert.

(Geerbt von MarshalByRefObject)
GetService(Type)

Gibt ein Objekt zurück, das einen Dienst darstellt, der von der Component oder dem zugehörigen ContainerDienst bereitgestellt wird.

(Geerbt von Component)
GetType()

Ruft die Type der aktuellen Instanz ab.

(Geerbt von Object)
InitializeLifetimeService()

Ruft ein Lebensdauerdienstobjekt ab, um die Lebensdauerrichtlinie für diese Instanz zu steuern.

(Geerbt von MarshalByRefObject)
Install(IDictionary)

Führt die Installations- und Schreibvorgangswarteschlangeninformationen in die Registrierung durch. Diese Methode soll von Installationstools verwendet werden, die automatisch die entsprechenden Methoden aufrufen.
IsEquivalentInstaller(ComponentInstaller)

Bestimmt, ob das angegebene Installationsprogramm dieselbe Art von Installation wie dieses Installationsprogramm verarbeiten kann.
MemberwiseClone()

Erstellt eine flache Kopie der 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)

Stellt den Computer in den Zustand zurück, in dem er sich vor der Installation befand, indem die Warteschlangeninformationen zurückgespielt werden, die vom Installationsvorgang in die Registrierung geschrieben wurden. Diese Methode soll von Installationstools verwendet werden, die automatisch die entsprechenden Methoden aufrufen.
ToString()

Gibt einen String mit dem Namen des Component, falls vorhanden, zurück. Diese Methode sollte nicht außer Kraft gesetzt werden.

(Geerbt von Component)
Uninstall(IDictionary)

Entfernt eine Installation, indem Warteschlangeninformationen aus der Registrierung entfernt werden. Diese Methode soll von Deinstallationstools verwendet werden, die automatisch die entsprechenden Methoden aufrufen.

Ereignisse

Name Beschreibung
AfterInstall

Tritt ein, nachdem die Install(IDictionary) Methoden aller Installationsprogramme in der Installers Eigenschaft ausgeführt wurden.

(Geerbt von Installer)
AfterRollback

Tritt ein, nachdem die Installationen aller Installationsprogramme in der Installers Eigenschaft zurückgesetzt wurden.

(Geerbt von Installer)
AfterUninstall

Tritt ein, nachdem alle Installationsprogramme in der Installers Eigenschaft ihre Deinstallationsvorgänge ausgeführt haben.

(Geerbt von Installer)
BeforeInstall

Tritt auf, bevor die Install(IDictionary) Methode der einzelnen Installationsprogramme in der Installer-Auflistung ausgeführt wurde.

(Geerbt von Installer)
BeforeRollback

Tritt auf, bevor die Installationsprogramme in der Installers Eigenschaft zurückgesetzt werden.

(Geerbt von Installer)
BeforeUninstall

Tritt auf, bevor die Installationsprogramme in der Installers Eigenschaft ihre Deinstallationsvorgänge ausführen.

(Geerbt von Installer)
Committed

Tritt auf, nachdem alle Installationsprogramme in der Installers Eigenschaft ihre Installationen zugesichert haben.

(Geerbt von Installer)
Committing

Tritt auf, bevor die Installationsprogramme in der Installers Eigenschaft ihre Installationen übernehmen.

(Geerbt von Installer)
Disposed

Tritt auf, wenn die Komponente durch einen Aufruf der Dispose() Methode verworfen wird.

(Geerbt von Component)

Gilt für:

Weitere Informationen