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 (средство установщика)