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) В противном случае вызывается метод.

• Если необходимо добавить экземпляры установщика в Installers коллекцию в Install(IDictionary) методе, обязательно выполните те же дополнения к коллекции в методе Uninstall(IDictionary) . Однако вы можете избежать сохранения коллекции в обоих методах, если добавить экземпляры установщика Installers в коллекцию в конструкторе классов для пользовательского установщика.

См. также раздел

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