EventLogInstaller.Install(IDictionary) 方法
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
执行安装并将事件日志信息写入注册表。
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，用于保存执行回滚或卸载操作所需的信息。
例外
已经为另一个事件日志注册了 Source 属性中指定的名称。
注解
方法 Install 将事件日志信息写入注册表，并将事件日志与 由 Log 属性指定的日志相关联。 如果日志 (尚不存在，并且) 指定了源， Install 则创建一个日志并将新源与其关联。
通常，不会从代码中调用 的方法 EventLogInstaller ;通常仅由 Installutil.exe (Installer Tool) 调用它们。 该工具在安装过程中自动调用 Install 方法，以写入与所安装的事件日志关联的注册表信息。 安装是事务性的，因此，如果在安装过程中有任何安装项目组件失败，所有以前安装的组件都会回滚到其安装前状态。 这是通过调用每个组件的 方法实现的 Rollback 。
使用 EventLogInstaller 为新的或现有的事件日志注册新源;请勿使用 EventLogInstaller 更改现有源。 类 EventLogInstaller 不会修改现有源的配置属性以匹配指定的安装属性。 如果 Source 属性与计算机上为其他事件日志注册的源名称匹配，则 Install 方法将引发异常。 Install如果 Source 属性与已为 属性中指定的相同事件日志注册的源名称匹配，则 方法将跳过注册源Log。
应用程序的安装例程使用项目安装程序的 Installer.Context 属性自动维护有关已安装的组件的信息。 此状态信息作为 stateSaver 参数传递给 Install ，在工具安装每个 EventLogInstaller时会持续更新。 通常，代码不需要显式修改此状态信息。
