MessageQueueInstaller Класс

Определение

Пространство имен:

System.Messaging

Сборка:

System.Messaging.dll

Позволяет установить и настроить очередь, требующуюся для работы приложения. Этот класс вызывается программой установки, например служебной программой InstallUtil.exe, при установке 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

Наследование

Object

MarshalByRefObject

Component

Installer

ComponentInstaller

MessageQueueInstaller

Комментарии

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)

См. также раздел

• Installutil.exe (инструмент для установки)