MessageQueueInstaller.Commit(IDictionary) 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
通过提交方法写入注册表的 MessageQueue 安装信息 Install(IDictionary) 来完成安装过程。 此方法旨在由安装工具使用,这些工具会自动调用相应的方法。
public:
override void Commit(System::Collections::IDictionary ^ savedState);
public override void Commit(System.Collections.IDictionary savedState);
override this.Commit : System.Collections.IDictionary -> unit
Public Overrides Sub Commit (savedState As IDictionary)
参数
- savedState
- IDictionary
包含计算机的安装后状态的 A IDictionary 。
注解
通常,你不会从代码中调用方法 MessageQueueInstaller ;它们通常仅由 installutil.exe 安装实用工具调用。 该实用工具在安装过程中自动调用 Install 该方法。 安装是事务性的,因此,如果在安装过程中出现任何安装项目组件的故障,所有以前安装的组件都会回滚到其预安装状态。 这是通过调用每个组件的方法来实现的 Rollback 。
成功安装与安装项目关联的所有组件后,安装实用工具将提交安装。 Commit 通过将队列设置为适当的初始状态来完成安装 MessageQueue 。 如果属性指定的 Path 队列已存在并包含消息, Commit 则清除消息。 Commit,而不是 Install清除消息,因为无法回滚清除消息的行为。
应用程序的安装例程使用项目安装程序 Installer.Context 自动维护有关已安装的组件的信息。 当实用工具提交每个MessageQueueInstaller实例时,此状态信息作为参数传递到CommitsavedState该状态信息会持续更新。 通常,代码不需要显式修改此状态信息。 清除队列后,将 Commit 日志条目发布到与安装关联的项 savedState 。