Installer.Install(IDictionary) 方法

定义

命名空间:

System.Configuration.Install

程序集:

System.Configuration.Install.dll

在派生类中被重写时，执行安装。

public:
 virtual void Install(System::Collections::IDictionary ^ stateSaver);

public virtual void Install (System.Collections.IDictionary stateSaver);

abstract member Install : System.Collections.IDictionary -> unit
override this.Install : System.Collections.IDictionary -> unit

Public Overridable Sub Install (stateSaver As IDictionary)

参数

stateSaver

IDictionary

IDictionary 用于保存执行提交、回滚或卸载操作所需的信息。

例外

ArgumentException

stateSaver 参数为 null。

Exception

该集合的一个安装程序的 BeforeInstall 事件处理程序发生异常。

- 或 -

该集合的一个安装程序的 AfterInstall 事件处理程序发生异常。

示例

下面的示例演示 Install 类的 Installer 方法。 类派生自 Installer 基类， Install 方法将被重写。

   // Override the 'Install' method of the Installer class.
public:
   virtual void Install( IDictionary^ mySavedState ) override
   {
      Installer::Install( mySavedState );
      // Code maybe written for installation of an application.
      Console::WriteLine( "The Install method of 'MyInstallerSample' has been called" );
   }

// Override the 'Install' method of the Installer class.
public override void Install( IDictionary mySavedState )
{
   base.Install( mySavedState );
   // Code maybe written for installation of an application.
   Console.WriteLine( "The Install method of 'MyInstallerSample' has been called" );
}

' Override the 'Install' method of the Installer class.
Public Overrides Sub Install(mySavedState As IDictionary)
   MyBase.Install(mySavedState)
   ' Code maybe written for installation of an application.
   Console.WriteLine("The Install method of 'MyInstallerSample' has been called")
End Sub

继承者说明

• 如果重写 Install(IDictionary) 派生类中的 方法，请确保先在派生方法中调用基类 Install(IDictionary) 的 方法。 方法 Install(IDictionary) 调用 Install(IDictionary) 此实例的 属性中包含的 Installers 每个安装程序的 方法。 在包含的安装程序运行后，此方法更新 IDictionary 通过 stateSaver 参数) 指定的对象 (，以反映安装状态。 IDictionary传递给 方法时， Install(IDictionary) 应为空。 如果所有 Install(IDictionary) 方法都成功，则 Commit(IDictionary) 调用 方法。 否则，将 Rollback(IDictionary) 调用 方法。

• 如果需要将安装程序实例添加到 方法中的 InstallersInstall(IDictionary) 集合，请确保在 方法中 Uninstall(IDictionary) 对集合执行相同的添加。 但是，如果将安装程序实例添加到自定义安装程序的类构造函数中的 集合， Installers 则可以避免在两种方法中维护集合。

另请参阅

• Commit(IDictionary)
• IDictionary
• InstallerCollection
• Installers
• Rollback(IDictionary)
• Uninstall(IDictionary)