MessageQueueInstaller.Install(IDictionary) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Выполняет установку и записывает сведения о очереди сообщений в реестр. Этот метод предназначен для использования средствами установки, которые автоматически вызывают соответствующие методы.
public:
override void Install(System::Collections::IDictionary ^ stateSaver);public override void Install(System.Collections.IDictionary stateSaver);override this.Install : System.Collections.IDictionary -> unitPublic 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 экземпляр. Как правило, коду не требуется явно изменять эти сведения о состоянии.
