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 в коллекцию в конструкторе классов для настраиваемого установщика.

Применяется к