MessageQueueInstaller Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Позволяет установить и настроить очередь, требующуюся для работы приложения. Этот класс вызывается программой установки, например служебной программой InstallUtil.exe, при установке MessageQueue.
public ref class MessageQueueInstaller : System::Configuration::Install::ComponentInstallerpublic class MessageQueueInstaller : System.Configuration.Install.ComponentInstallertype MessageQueueInstaller = class
inherit ComponentInstallerPublic Class MessageQueueInstaller
Inherits ComponentInstaller- Наследование
Комментарии
MessageQueueInstaller используется программой установки для записи значений реестра, связанных с очередью. Дополнительные сведения о служебных программах установки см . в разделеInstallutil.exe (установщик).
Чтобы установить очередь, создайте класс установщика проекта, который наследуется от Installer, и задайте RunInstallerAttribute для класса значение true. В проекте создайте экземпляр для каждой MessageQueueInstaller очереди в установке и добавьте экземпляр в класс установщика проекта.
При создании экземпляра MessageQueueInstaller при необходимости можно передать существующий MessageQueue (например, с тестового сервера) в MessageQueueInstaller конструктор. Этот подход автоматически предоставляет параметры конфигурации для новой очереди путем зеркального отображения параметров переданной очереди. Кроме того, можно вручную задать для свойств экземпляра MessageQueueInstaller нужные состояния и вызвать конструктор без параметров.
Когда вызывается служебная программа установки, она ищет RunInstallerAttribute. Если это true, служебная программа устанавливает все очереди в коллекции, связанной Installers с установщиком проекта. Если RunInstallerAttribute имеет значение false, служебная программа игнорирует установщик проекта.
Другие свойства экземпляра MessageQueueInstaller можно изменить до или после добавления экземпляра в коллекцию Installers установщика проекта. Например, очередь должна быть задана Path перед выполнением программы установки.
Как правило, методы MessageQueueInstaller не вызываются из кода; они обычно вызываются только программой установки installutil.exe. Служебная программа автоматически вызывает Install метод в процессе установки и вызывает , Commit если при установке не было создано исключение. При необходимости он выполняет резервное завершение сбоев путем вызова Rollback объекта, создающего исключение.
Подпрограмма установки приложения использует установщик Installer.Context проекта для автоматического хранения сведений об уже установленных компонентах. Эти сведения о состоянии постоянно обновляются по мере установки каждого MessageQueueInstaller экземпляра служебной программой. Обычно коду не требуется явно изменять сведения о состоянии.
Конструкторы
| MessageQueueInstaller() |
Инициализирует новый экземпляр класса MessageQueueInstaller. Не устанавливает никаких свойств экземпляра. |
| MessageQueueInstaller(MessageQueue) |
Инициализирует новый экземпляр класса MessageQueueInstaller, задавая параметры установки равными значениям существующего экземпляра MessageQueue. |
Свойства
| Authenticate |
Получает или задает значение, показывающее, будет ли установленная очередь принимать только сообщения, прошедшие проверку подлинности. |
| BasePriority |
Получает или устанавливает базовый приоритет, используемый для маршрутизации сообщений общей очереди в сети. |
| CanRaiseEvents |
Возвращает значение, показывающее, может ли компонент вызывать событие. (Унаследовано от Component) |
| Category |
Получает или устанавливает тип очереди, зависящий от реализации. |
| Container |
Возвращает объект IContainer, который содержит коллекцию Component. (Унаследовано от Component) |
| Context |
Получает или задает сведения о текущей установке. (Унаследовано от Installer) |
| DesignMode |
Возвращает значение, указывающее, находится ли данный компонент Component в режиме конструктора в настоящее время. (Унаследовано от Component) |
| EncryptionRequired |
Получает или задает значение, указывающее, будет ли очередь принимать только конфиденциальные, или зашифрованные сообщения. |
| Events |
Возвращает список обработчиков событий, которые прикреплены к этому объекту Component. (Унаследовано от Component) |
| HelpText |
Получает текст справки для всех установщиков из коллекции установщиков. (Унаследовано от Installer) |
| Installers |
Получает коллекцию установщиков, содержащуюся в данном установщике. (Унаследовано от Installer) |
| Label |
Получает или задает описание очереди. |
| MaximumJournalSize |
Получает или задает максимальный размер журнала, связанного с данной очередью. |
| MaximumQueueSize |
Получает или задает максимальный размер очереди. |
| MulticastAddress |
Представлено в MSMQ 3.0. Получает или задает адрес многоадресной рассылки, связанный с данной очередью. |
| Parent |
Получает или задает установщик, содержащий коллекцию, к которой принадлежит данный установщик. (Унаследовано от Installer) |
| Path |
Получает или задает местоположение очереди, на которую ссылается данный объект. |
| Permissions |
Получает или задает разрешения, связанные с очередью. |
| Site |
Получает или задает ISite объекта Component. (Унаследовано от Component) |
| Transactional |
Получает или задает значение, указывающее, принимает ли очередь только сообщения, отправляемые как часть транзакции. |
| UninstallAction |
Получает или задает значение, указывающее, что установщик делает с очередью во время деинсталляции: удаляет ее, восстанавливает до состояния, предшествовавшего установке, или же оставляет ее в текущем состоянии. |
| UseJournalQueue |
Получает или задает значение, указывающее, будут ли сообщения, извлекаемые из очереди, копироваться в связанную очередь журнала. |
Методы
| Commit(IDictionary) |
Завершает процесс установки, фиксируя сведения об установке MessageQueue, записанные в реестр методом Install(IDictionary). Этот метод предназначен для использования средствами установки, которые автоматически вызывают соответствующие методы. |
| CopyFromComponent(IComponent) |
Копирует значения свойств компонента MessageQueue, которые требуются во время установки для очереди сообщений. |
| CreateObjRef(Type) |
Создает объект, который содержит всю необходимую информацию для создания прокси-сервера, используемого для взаимодействия с удаленным объектом. (Унаследовано от MarshalByRefObject) |
| Dispose() |
Освобождает все ресурсы, занятые модулем Component. (Унаследовано от Component) |
| Dispose(Boolean) |
Освобождает неуправляемые ресурсы, используемые объектом Component, а при необходимости освобождает также управляемые ресурсы. (Унаследовано от Component) |
| Equals(Object) |
Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object) |
| GetHashCode() |
Служит хэш-функцией по умолчанию. (Унаследовано от Object) |
| GetLifetimeService() |
Устаревшие..
Извлекает объект обслуживания во время существования, который управляет политикой времени существования данного экземпляра. (Унаследовано от MarshalByRefObject) |
| GetService(Type) |
Возвращает объект, представляющий службу, предоставляемую классом Component или классом Container. (Унаследовано от Component) |
| GetType() |
Возвращает объект Type для текущего экземпляра. (Унаследовано от Object) |
| InitializeLifetimeService() |
Устаревшие..
Получает объект службы времени существования для управления политикой времени существования для этого экземпляра. (Унаследовано от MarshalByRefObject) |
| Install(IDictionary) |
Выполняет установку и записывает сведения об очереди сообщений в реестр. Этот метод предназначен для использования средствами установки, которые автоматически вызывают соответствующие методы. |
| IsEquivalentInstaller(ComponentInstaller) |
Определяет, может ли указанный установщик обрабатывать тот же тип установки, что и данный установщик. |
| MemberwiseClone() |
Создает неполную копию текущего объекта Object. (Унаследовано от Object) |
| MemberwiseClone(Boolean) |
Создает неполную копию текущего объекта MarshalByRefObject. (Унаследовано от MarshalByRefObject) |
| OnAfterInstall(IDictionary) |
Вызывает событие AfterInstall. (Унаследовано от Installer) |
| OnAfterRollback(IDictionary) |
Вызывает событие AfterRollback. (Унаследовано от Installer) |
| OnAfterUninstall(IDictionary) |
Вызывает событие AfterUninstall. (Унаследовано от Installer) |
| OnBeforeInstall(IDictionary) |
Вызывает событие BeforeInstall. (Унаследовано от Installer) |
| OnBeforeRollback(IDictionary) |
Вызывает событие BeforeRollback. (Унаследовано от Installer) |
| OnBeforeUninstall(IDictionary) |
Вызывает событие BeforeUninstall. (Унаследовано от Installer) |
| OnCommitted(IDictionary) |
Вызывает событие Committed. (Унаследовано от Installer) |
| OnCommitting(IDictionary) |
Вызывает событие Committing. (Унаследовано от Installer) |
| Rollback(IDictionary) |
Восстанавливает компьютер в состояние, в котором он находился до установки, путем отката сведений об очереди, записанных в реестр процедурой установки. Этот метод предназначен для использования средствами установки, которые автоматически вызывают соответствующие методы. |
| ToString() |
Возвращает объект String, содержащий имя Component, если оно есть. Этот метод не следует переопределять. (Унаследовано от Component) |
| Uninstall(IDictionary) |
Удаляет установку путем удаления из реестра сведений об очереди. Этот метод предназначен для использования средствами удаления установки, которые автоматически вызывают соответствующие методы. |
События
| AfterInstall |
Происходит после выполнения методов Install(IDictionary) всех установщиков из свойства Installers. (Унаследовано от Installer) |
| AfterRollback |
Происходит после отката установок всех установщиков из свойства Installers. (Унаследовано от Installer) |
| AfterUninstall |
Происходит после выполнения операций удаления всеми установщиками из свойства Installers. (Унаследовано от Installer) |
| BeforeInstall |
Происходит до того, как был запущен метод Install(IDictionary) каждого установщика из коллекции установщиков. (Унаследовано от Installer) |
| BeforeRollback |
Происходит до отката установщиков из свойства Installers. (Унаследовано от Installer) |
| BeforeUninstall |
Происходит до выполнения операций удаления установщиками из свойства Installers. (Унаследовано от Installer) |
| Committed |
Происходит после фиксации установки всеми установщиками из свойства Installers. (Унаследовано от Installer) |
| Committing |
Происходит до фиксации установок установщиками из свойства Installers. (Унаследовано от Installer) |
| Disposed |
Возникает при удалении компонента путем вызова метода Dispose(). (Унаследовано от Component) |
