MessageQueueInstaller.Install(IDictionary) Метод

  • Ссылка

Определение

Пространство имен:
System.Messaging
Сборка:
System.Messaging.dll

Выполняет установку и записывает сведения об очереди сообщений в реестр. Этот метод предназначен для использования средствами установки, которые автоматически вызывают соответствующие методы.

public:
 override void Install(System::Collections::IDictionary ^ stateSaver);
public override void Install (System.Collections.IDictionary stateSaver);
override this.Install : System.Collections.IDictionary -> unit
Public Overrides Sub Install (stateSaver As IDictionary)

Параметры

stateSaver
IDictionary

Объект IDictionary, используемый в целях сохранения информации, необходимой для выполнения фиксации, отката к предыдущей точке или операции деинсталляции.

Комментарии

Метод Install записывает сведения об очереди сообщений в реестр и связывает MessageQueue экземпляр с очередью, расположенной по пути, указанному свойством Path . Если очередь еще не существует, Install создается транзакционная очередь. Install Задает для новых или существующих свойств очереди те, которые вы указали MessageQueueInstallerв . Если очередь уже существует, ее свойства сбрасываются на свойства MessageQueueInstaller. Если существующая очередь не является транзакционной, она удаляется и повторно создается как транзакционная очередь.

Внимание!

Если необходимо повторно создать очередь, сообщения в очереди будут потеряны.

Как правило, методы MessageQueueInstaller не вызываются из кода; они обычно вызываются только программой установки installutil.exe. Служебная программа автоматически вызывает Install метод в процессе установки для записи сведений реестра, связанных с устанавливаемой очередью сообщений. Установка выполняется по транзакциям, поэтому при сбое какого-либо компонента проекта установки во время установки все ранее установленные компоненты откатываются до состояния перед установкой. Это достигается путем вызова метода каждого компонента Rollback .

После успешной установки всех компонентов, связанных с проектом установки, программа установки фиксирует установку. Commit завершает установку MessageQueue , задав для очереди соответствующее начальное состояние. Если очередь, указанная свойством Path , уже существует и содержит сообщения, Commit очищает сообщения. Commit, а не Installочищает сообщения, так как процесс очистки сообщений не может быть откатен.

Подпрограмма установки приложения использует установщик Installer.Context проекта для автоматического хранения сведений об уже установленных компонентах. Эта информация о состоянии, передаваемая Install в качестве stateSaver параметра, постоянно обновляется по мере установки каждого MessageQueueInstaller экземпляра служебной программой. Как правило, нет необходимости явно изменять эти сведения о состоянии в коде.

Применяется к

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