MessageQueueInstaller MessageQueueInstaller MessageQueueInstaller MessageQueueInstaller Class

Definition

Ermöglicht das Installieren und Konfigurieren einer Warteschlange, die für das Ausführen einer Anwendung benötigt wird.Allows you to install and configure a queue that your application needs in order to run. Diese Klasse wird vom Installationsprogramm, z. B. InstallUtil.exe, beim Installieren einer MessageQueue aufgerufen.This class is called by the installation utility, for example, InstallUtil.exe, when installing a 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

Hinweise

Der MessageQueueInstaller wird vom Installationsprogramm zum Schreiben von Registrierungs Werten verwendet, die der Warteschlange zugeordnet sind.The MessageQueueInstaller is used by the installation utility to write registry values that are associated with the queue. Weitere Informationen zu Installations Dienstprogrammen finden Sie unter " installutil. exe" (Installationstool).For more information about installation utilities, see Installutil.exe (Installer Tool).

Erstellen Sie zum Installieren einer Warteschlange eine projektinstallerklasse, die von Installererbt, und RunInstallerAttribute legen Sie für die true-Klasse auf fest.To install a queue, create a project installer class that inherits from the Installer, and set the RunInstallerAttribute for the class to true. Erstellen Sie in Ihrem Projekt eine MessageQueueInstaller -Instanz für jede Warteschlange in der-Installation, und fügen Sie die-Instanz Ihrer projektinstallerklasse hinzu.Within your project, create a MessageQueueInstaller instance for each queue in the installation and add the instance to your project installer class.

Wenn Sie eine MessageQueueInstaller -Instanz erstellen, können Sie optional ein MessageQueue vorhandenes (z. b. von einem Testserver MessageQueueInstaller ) an den-Konstruktor übergeben.When creating a MessageQueueInstaller instance, you can optionally pass an existing MessageQueue (for example, from a test server) to the MessageQueueInstaller constructor. Bei diesem Ansatz werden die Konfigurationseinstellungen für die neue Warteschlange automatisch durch Spiegelung der Einstellungen der in der Warteschlange über gebenden Warteschlange angezeigt.This approach automatically provides the configuration settings for the new queue by mirroring the settings of the queue passed in. Alternativ können Sie die Eigenschaften in der MessageQueueInstaller -Instanz manuell auf die gewünschten Zustände festlegen und den Parameter losen Konstruktor aufzurufen.Alternatively, you can manually set the properties in the MessageQueueInstaller instance to the states you want and call the parameterless constructor.

Wenn das Installations Hilfsprogramm aufgerufen wird, sucht es nach RunInstallerAttribute.When the install utility is called, it looks for the RunInstallerAttribute. Wenn dies der trueFall ist, werden mit dem-Hilfsprogramm Installers alle Warteschlangen in der Sammlung installiert, die dem Projekt Installationsprogramm zugeordnet istIf it is true, the utility installs all the queues in the Installers collection associated with your project installer. Wenn RunInstallerAttributeden Wert hat,wirddasProjektInstallationsprogrammignoriert.falseIf RunInstallerAttribute is false, the utility ignores the project installer.

Sie ändern andere Eigenschaften einer MessageQueueInstaller -Instanz entweder vor oder nach dem Hinzufügen der Instanz Installers zur-Auflistung Ihres projektinstallers.You modify other properties of a MessageQueueInstaller instance either before or after adding the instance to the Installers collection of your project installer. Beispielsweise Path muss eine Warteschlange festgelegt werden, bevor das Installationsprogramm ausgeführt wird.For example, a queue's Path must be set before the install utility executes.

In der Regel wird die-Methode MessageQueueInstaller von nicht innerhalb Ihres Codes aufgerufen. Sie werden in der Regel nur durch das Installationsprogramm InstallUtil. exe aufgerufen.Typically, you do not call the methods of the MessageQueueInstaller from within your code; they are generally called only by the installutil.exe installation utility. Das Hilfsprogramm ruft während Install des Installationsvorgangs automatisch die-Methode Commit auf und ruft auf, wenn die Installation keine Ausnahme ausgelöst hat.The utility automatically calls the Install method during the installation process and calls Commit if the installation did not throw an exception. Es sichert ggf. Fehler, indem für das Rollback Objekt aufgerufen wird, das die Ausnahme generiert hat.It backs out failures, if necessary, by calling Rollback for the object that generated the exception.

Die Installationsroutine einer Anwendung verwendet die Installationsroutine des Installer.Context Projekts, um automatisch Informationen zu den Komponenten zu verwalten, die bereits installiert wurden.An application's install routine uses the project installer's Installer.Context to automatically maintain information about the components that have already been installed. Diese Zustandsinformationen werden fortlaufend aktualisiert, MessageQueueInstaller wenn jede Instanz vom-Hilfsprogramm installiert wird.This state information is continuously updated as each MessageQueueInstaller instance is installed by the utility. Es ist in der Regel nicht erforderlich, dass der Code die Zustandsinformationen explizit ändert.It is not usually necessary for your code to explicitly modify the state information.

Konstruktoren

MessageQueueInstaller() MessageQueueInstaller() MessageQueueInstaller() MessageQueueInstaller()

Initialisiert eine neue Instanz der MessageQueueInstaller-Klasse.Initializes a new instance of the MessageQueueInstaller class. Legt keine Instanzeigenschaften fest.Does not set any instance properties.

MessageQueueInstaller(MessageQueue) MessageQueueInstaller(MessageQueue) MessageQueueInstaller(MessageQueue) MessageQueueInstaller(MessageQueue)

Initialisiert eine neue Instanz der MessageQueueInstaller-Klasse. Dabei werden die Installationseinstellungen mit denen einer vorhandenen MessageQueue-Instanz initialisiert.Initializes a new instance of the MessageQueueInstaller class, initializing the installation settings to those of an existing MessageQueue instance.

Eigenschaften

Authenticate Authenticate Authenticate Authenticate

Ruft einen Wert ab, der angibt, ob die zu installierende Warteschlange nur authentifizierte Meldungen akzeptiert, oder legt diesen fest.Gets or sets a value that indicates whether the queue to be installed accepts only authenticated messages.

BasePriority BasePriority BasePriority BasePriority

Gibt die Basispriorität an, die beim Weiterleiten von Meldungen einer öffentlichen Warteschlange über das Netzwerk verwendet wird, oder legt diese fest.Gets or sets the base priority that is used to route a public queue's messages over the network.

CanRaiseEvents CanRaiseEvents CanRaiseEvents CanRaiseEvents

Ruft einen Wert ab, der angibt, ob die Komponente ein Ereignis auslösen kann.Gets a value indicating whether the component can raise an event.

(Inherited from Component)
Category Category Category Category

Ruft einen implementierungsspezifischen Warteschlangentyp ab oder legt diesen fest.Gets or sets an implementation-specific queue type.

Container Container Container Container

Ruft den IContainer ab, der die Component enthält.Gets the IContainer that contains the Component.

(Inherited from Component)
Context Context Context Context

Ruft Informationen über die derzeitige Installation ab oder legt diese fest.Gets or sets information about the current installation.

(Inherited from Installer)
DesignMode DesignMode DesignMode DesignMode

Ruft einen Wert ab, der angibt, ob sich Component gegenwärtig im Entwurfsmodus befindet.Gets a value that indicates whether the Component is currently in design mode.

(Inherited from Component)
EncryptionRequired EncryptionRequired EncryptionRequired EncryptionRequired

Ruft einen Wert ab, der angibt, ob die Warteschlange nur private, d. h. verschlüsselte Meldungen akzeptiert, oder legt diesen fest.Gets or sets a value that indicates whether the queue accepts only private, or encrypted, messages.

Events Events Events Events

Ruft die Liste der Ereignishandler ab, die dieser Component angefügt sind.Gets the list of event handlers that are attached to this Component.

(Inherited from Component)
HelpText HelpText HelpText HelpText

Ruft den Hilfetext für alle in der entsprechenden Auflistung enthaltenen Installationsprogramme ab.Gets the help text for all the installers in the installer collection.

(Inherited from Installer)
Installers Installers Installers Installers

Ruft die Auflistung von Installationsprogrammen ab, die dieses Installationsprogramm enthält.Gets the collection of installers that this installer contains.

(Inherited from Installer)
Label Label Label Label

Ruft die Beschreibung der Warteschlange ab oder legt diese fest.Gets or sets a description of the queue.

MaximumJournalSize MaximumJournalSize MaximumJournalSize MaximumJournalSize

Ruft die maximale Größe des der Warteschlange zugeordneten Journals ab oder legt diese fest.Gets or sets the maximum size of the journal that is associated with the queue.

MaximumQueueSize MaximumQueueSize MaximumQueueSize MaximumQueueSize

Ruft die maximale Größe der Warteschlange ab oder legt diese fest.Gets or sets the maximum size of the queue.

MulticastAddress MulticastAddress MulticastAddress MulticastAddress

Eingeführt in MSMQ 3.0.Introduced in MSMQ 3.0. Ruft die der Warteschlange zugeordnete Multicastadresse ab oder oder legt diese fest.Gets or sets the multicast address associated with the queue.

Parent Parent Parent Parent

Ruft das Installationsprogramm ab, das die Auflistung mit diesem Installationsprogramm enthält, oder legt dieses fest.Gets or sets the installer containing the collection that this installer belongs to.

(Inherited from Installer)
Path Path Path Path

Ruft die Position der Warteschlange ab, auf die dieses Objekt verweist, oder legt diese fest.Gets or sets the location of the queue that is referenced by this object.

Permissions Permissions Permissions Permissions

Ruft Berechtigungen ab, die der Warteschlange zugeordnet sind, oder legt diese fest.Gets or sets permissions associated with the queue.

Site Site Site Site

Ruft den ISite von Component ab oder legt ihn fest.Gets or sets the ISite of the Component.

(Inherited from Component)
Transactional Transactional Transactional Transactional

Ruft einen Wert ab, der angibt, ob die Warteschlange nur Meldungen akzeptiert, die als Teil einer Transaktion gesendet wurden, oder legt diesen fest.Gets or sets a value that indicates whether the queue accepts only messages sent as part of a transaction.

UninstallAction UninstallAction UninstallAction 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.Gets or sets a value that indicates what the installer does with the queue at uninstall time: remove it, restore it to its pre-installation state, or leave it in its current installed state.

UseJournalQueue UseJournalQueue UseJournalQueue UseJournalQueue

Ruft einen Wert ab, der angibt, ob aus der Warteschlange abgerufene Meldungen auch in die zugeordnete Journalwarteschlange kopiert werden, oder legt diesen fest.Gets or sets a value that indicates whether messages that are retrieved from the queue are also copied to the associated journal queue.

Methoden

Commit(IDictionary) Commit(IDictionary) Commit(IDictionary) Commit(IDictionary)

Schließt den Installationsprozess durch Übernehmen der MessageQueue-Installationsinformationen ab, die von der Install(IDictionary)-Methode in die Registrierung geschrieben wurden.Completes the installation process by committing the MessageQueue installation information that the Install(IDictionary) method wrote to the registry. Diese Methode ist für Installationstools vorgesehen, die die entsprechenden Methoden automatisch aufrufen.This method is meant to be used by installation tools, which automatically call the appropriate methods.

CopyFromComponent(IComponent) CopyFromComponent(IComponent) CopyFromComponent(IComponent) CopyFromComponent(IComponent)

Kopiert die Eigenschaftswerte einer MessageQueue-Komponente, die bei der Installation einer Meldungswarteschlange benötigt werden.Copies the property values of a MessageQueue component that are required at install time for a message queue.

CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type)

Erstellt ein Objekt mit allen relevanten Informationen, die zum Generieren eines Proxys für die Kommunikation mit einem Remoteobjekt erforderlich sind.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Inherited from MarshalByRefObject)
Dispose() Dispose() Dispose() Dispose()

Gibt alle vom Component verwendeten Ressourcen frei.Releases all resources used by the Component.

(Inherited from Component)
Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) Dispose(Boolean)

Gibt die von Component verwendeten nicht verwalteten Ressourcen und optional die verwalteten Ressourcen frei.Releases the unmanaged resources used by the Component and optionally releases the managed resources.

(Inherited from Component)
Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Fungiert als Standardhashfunktion.Serves as the default hash function.

(Inherited from Object)
GetLifetimeService() GetLifetimeService() GetLifetimeService() GetLifetimeService()

Ruft das aktuelle Lebensdauerdienstobjekt ab, das die Lebensdauerrichtlinien für diese Instanz steuert.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
GetService(Type) GetService(Type) GetService(Type) GetService(Type)

Gibt ein Objekt zurück, das einen von der Component oder von deren Container bereitgestellten Dienst darstellt.Returns an object that represents a service provided by the Component or by its Container.

(Inherited from Component)
GetType() GetType() GetType() GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Inherited from Object)
InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService()

Ruft ein Lebensdauerdienstobjekt zur Steuerung der Lebensdauerrichtlinie für diese Instanz ab.Obtains a lifetime service object to control the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
Install(IDictionary) Install(IDictionary) Install(IDictionary) Install(IDictionary)

Führt die Installation durch und schreibt Meldungswarteschlangeninformationen in die Registrierung.Performs the installation and writes message queue information to the registry. Diese Methode ist für Installationstools vorgesehen, die die entsprechenden Methoden automatisch aufrufen.This method is meant to be used by installation tools, which automatically call the appropriate methods.

IsEquivalentInstaller(ComponentInstaller) IsEquivalentInstaller(ComponentInstaller) IsEquivalentInstaller(ComponentInstaller) IsEquivalentInstaller(ComponentInstaller)

Bestimmt, ob das angegebene Installationsprogramm die gleiche Art von Installation wie dieses Installationsprogramm durchführen kann.Determines whether the specified installer can handle the same kind of installation as this installer.

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Inherited from Object)
MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean)

Erstellt eine flache Kopie des aktuellen MarshalByRefObject-Objekts.Creates a shallow copy of the current MarshalByRefObject object.

(Inherited from MarshalByRefObject)
OnAfterInstall(IDictionary) OnAfterInstall(IDictionary) OnAfterInstall(IDictionary) OnAfterInstall(IDictionary)

Löst das AfterInstall-Ereignis aus.Raises the AfterInstall event.

(Inherited from Installer)
OnAfterRollback(IDictionary) OnAfterRollback(IDictionary) OnAfterRollback(IDictionary) OnAfterRollback(IDictionary)

Löst das AfterRollback-Ereignis aus.Raises the AfterRollback event.

(Inherited from Installer)
OnAfterUninstall(IDictionary) OnAfterUninstall(IDictionary) OnAfterUninstall(IDictionary) OnAfterUninstall(IDictionary)

Löst das AfterUninstall-Ereignis aus.Raises the AfterUninstall event.

(Inherited from Installer)
OnBeforeInstall(IDictionary) OnBeforeInstall(IDictionary) OnBeforeInstall(IDictionary) OnBeforeInstall(IDictionary)

Löst das BeforeInstall-Ereignis aus.Raises the BeforeInstall event.

(Inherited from Installer)
OnBeforeRollback(IDictionary) OnBeforeRollback(IDictionary) OnBeforeRollback(IDictionary) OnBeforeRollback(IDictionary)

Löst das BeforeRollback-Ereignis aus.Raises the BeforeRollback event.

(Inherited from Installer)
OnBeforeUninstall(IDictionary) OnBeforeUninstall(IDictionary) OnBeforeUninstall(IDictionary) OnBeforeUninstall(IDictionary)

Löst das BeforeUninstall-Ereignis aus.Raises the BeforeUninstall event.

(Inherited from Installer)
OnCommitted(IDictionary) OnCommitted(IDictionary) OnCommitted(IDictionary) OnCommitted(IDictionary)

Löst das Committed-Ereignis aus.Raises the Committed event.

(Inherited from Installer)
OnCommitting(IDictionary) OnCommitting(IDictionary) OnCommitting(IDictionary) OnCommitting(IDictionary)

Löst das Committing-Ereignis aus.Raises the Committing event.

(Inherited from Installer)
Rollback(IDictionary) Rollback(IDictionary) Rollback(IDictionary) 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.Restores the computer to the state it was in before the installation, by rolling back the queue information that the installation procedure wrote to the registry. Diese Methode ist für Installationstools vorgesehen, die die entsprechenden Methoden automatisch aufrufen.This method is meant to be used by installation tools, which automatically call the appropriate methods.

ToString() ToString() ToString() ToString()

Gibt einen String zurück, der den Namen der Component enthält (sofern vorhanden).Returns a String containing the name of the Component, if any. Diese Methode darf nicht überschrieben werden.This method should not be overridden.

(Inherited from Component)
Uninstall(IDictionary) Uninstall(IDictionary) Uninstall(IDictionary) Uninstall(IDictionary)

Entfernt eine Installation durch Entfernen der Warteschlangeninformationen aus der Registrierung.Removes an installation by removing queue information from the registry. Diese Methode ist für Deinstallationstools vorgesehen, die die entsprechenden Methoden automatisch aufrufen.This method is meant to be used by uninstallation tools, which automatically call the appropriate methods.

Ereignisse

AfterInstall AfterInstall AfterInstall AfterInstall

Tritt ein, nachdem die Install(IDictionary)-Methoden aller in der Installers-Eigenschaft enthaltenen Installationsprogramme ausgeführt wurden.Occurs after the Install(IDictionary) methods of all the installers in the Installers property have run.

(Inherited from Installer)
AfterRollback AfterRollback AfterRollback AfterRollback

Tritt ein, nachdem ein Rollback aller Installationen der Installationsprogramme in der Installers-Eigenschaft ausgeführt wurde.Occurs after the installations of all the installers in the Installers property are rolled back.

(Inherited from Installer)
AfterUninstall AfterUninstall AfterUninstall AfterUninstall

Tritt ein, nachdem alle Installationsprogramme in der Installers-Eigenschaft ihre jeweiligen Deinstallationsvorgänge ausgeführt haben.Occurs after all the installers in the Installers property perform their uninstallation operations.

(Inherited from Installer)
BeforeInstall BeforeInstall BeforeInstall BeforeInstall

Tritt ein, bevor die Install(IDictionary)-Methode aller in der Auflistung der Installationsprogramme enthaltenen Installationsprogramme ausgeführt worden ist.Occurs before the Install(IDictionary) method of each installer in the installer collection has run.

(Inherited from Installer)
BeforeRollback BeforeRollback BeforeRollback BeforeRollback

Tritt ein, bevor ein Rollback der Installationsprogramme in der Installers-Eigenschaft ausgeführt wird.Occurs before the installers in the Installers property are rolled back.

(Inherited from Installer)
BeforeUninstall BeforeUninstall BeforeUninstall BeforeUninstall

Tritt ein, bevor die Installationsprogramme in der Installers-Eigenschaft ihre jeweiligen Deinstallationsvorgänge ausführen.Occurs before the installers in the Installers property perform their uninstall operations.

(Inherited from Installer)
Committed Committed Committed Committed

Tritt ein, nachdem alle Installationsprogramme in der Installers-Eigenschaft ein Commit für ihre Installationen ausgeführt haben.Occurs after all the installers in the Installers property have committed their installations.

(Inherited from Installer)
Committing Committing Committing Committing

Tritt ein, bevor die Installationsprogramme in der Installers-Eigenschaft ein Commit für ihre Installationen ausführen.Occurs before the installers in the Installers property commit their installations.

(Inherited from Installer)
Disposed Disposed Disposed Disposed

Tritt ein, wenn die Komponente durch einen Aufruf der Dispose()-Methode freigegeben wird.Occurs when the component is disposed by a call to the Dispose() method.

(Inherited from Component)

Gilt für:

Siehe auch