Allows you to install and configure a queue that your application needs in order to run. This class is called by the installation utility, for example, InstallUtil.exe, when installing a MessageQueue.
Assembly: System.Messaging (in System.Messaging.dll)
Gets or sets a value that indicates whether the queue to be installed accepts only authenticated messages.
Gets or sets the base priority that is used to route a public queue's messages over the network.
Gets a value indicating whether the component can raise an event.(Inherited from Component.)
Gets or sets an implementation-specific queue type.
Gets or sets information about the current installation.(Inherited from Installer.)
Gets or sets a value that indicates whether the queue accepts only private, or encrypted, messages.
Gets the help text for all the installers in the installer collection.(Inherited from Installer.)
Gets the collection of installers that this installer contains.(Inherited from Installer.)
Gets or sets a description of the queue.
Gets or sets the maximum size of the journal that is associated with the queue.
Gets or sets the maximum size of the queue.
Introduced in MSMQ 3.0. Gets or sets the multicast address associated with the queue.
Gets or sets the installer containing the collection that this installer belongs to.(Inherited from Installer.)
Gets or sets the location of the queue that is referenced by this object.
Gets or sets permissions associated with the queue.
Gets or sets a value that indicates whether the queue accepts only messages sent as part of a transaction.
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.
Gets or sets a value that indicates whether messages that are retrieved from the queue are also copied to the associated journal queue.
Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.(Inherited from MarshalByRefObject.)
Determines whether the specified object is equal to the current object.(Inherited from Object.)
Serves as the default hash function. (Inherited from Object.)
Retrieves the current lifetime service object that controls the lifetime policy for this instance.(Inherited from MarshalByRefObject.)
Obtains a lifetime service object to control the lifetime policy for this instance.(Inherited from MarshalByRefObject.)
Performs the installation and writes message queue information to the registry. This method is meant to be used by installation tools, which automatically call the appropriate methods.(Overrides Installer.Install(IDictionary).)
Determines whether the specified installer can handle the same kind of installation as this installer.(Overrides ComponentInstaller.IsEquivalentInstaller(ComponentInstaller).)
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. This method is meant to be used by installation tools, which automatically call the appropriate methods.(Overrides Installer.Rollback(IDictionary).)
Removes an installation by removing queue information from the registry. This method is meant to be used by uninstallation tools, which automatically call the appropriate methods.(Overrides Installer.Uninstall(IDictionary).)
To install a queue, create a project installer class that inherits from the Installer, and set the RunInstallerAttribute for the class to true. Within your project, create a instance for each queue in the installation and add the instance to your project installer class.
When creating a MessageQueue (for example, from a test server) to the MessageQueueInstaller constructor. This approach automatically provides the configuration settings for the new queue by mirroring the settings of the queue passed in. Alternatively, you can manually set the properties in the instance to the states you want and call the default constructor.instance, you can optionally pass an existing
When the install utility is called, it looks for the RunInstallerAttribute. If it is true, the utility installs all the queues in the Installers collection associated with your project installer. If RunInstallerAttribute is false, the utility ignores the project installer.
Typically, you do not call the methods of the Install method during the installation process and calls Commit if the installation did not throw an exception. It backs out failures, if necessary, by calling Rollback for the object that generated the exception.from within your code; they are generally called only by the installutil.exe installation utility. The utility automatically calls the
An application's install routine uses the project installer's Installer.Context to automatically maintain information about the components that have already been installed. This state information is continuously updated as each instance is installed by the utility. It is not usually necessary for your code to explicitly modify the state information.
Available since 1.1
Any public static ( Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.