EventLogInstaller.Install(IDictionary) 方法

定义

命名空间:

System.Diagnostics

程序集:

System.Configuration.Install.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，用于保存执行回滚或卸载操作所需的信息。

例外

ArgumentException

已经为另一个事件日志注册了 Source 属性中指定的名称。

注解

方法 Install 将事件日志信息写入注册表，并将事件日志与 由 Log 属性指定的日志相关联。 如果日志 (尚不存在，并且) 指定了源， Install 则创建一个日志并将新源与其关联。

通常，不会从代码中调用 的方法 EventLogInstaller ;通常仅由 Installutil.exe (Installer Tool) 调用它们。 该工具在安装过程中自动调用 Install 方法，以写入与所安装的事件日志关联的注册表信息。 安装是事务性的，因此，如果在安装过程中有任何安装项目组件失败，所有以前安装的组件都会回滚到其安装前状态。 这是通过调用每个组件的 方法实现的 Rollback 。

使用 EventLogInstaller 为新的或现有的事件日志注册新源;请勿使用 EventLogInstaller 更改现有源。 类 EventLogInstaller 不会修改现有源的配置属性以匹配指定的安装属性。 如果 Source 属性与计算机上为其他事件日志注册的源名称匹配，则 Install 方法将引发异常。 Install如果 Source 属性与已为 属性中指定的相同事件日志注册的源名称匹配，则 方法将跳过注册源Log。

应用程序的安装例程使用项目安装程序的 Installer.Context 属性自动维护有关已安装的组件的信息。 此状态信息作为 stateSaver 参数传递给 Install ，在工具安装每个 EventLogInstaller时会持续更新。 通常，代码不需要显式修改此状态信息。

另请参阅

• Rollback(IDictionary)
• Uninstall(IDictionary)
• IDictionary