Installer.Install(IDictionary) Método

Referência

Definição

Namespace:: System.Configuration.Install

Assembly:: System.Configuration.Install.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Quando substituído em uma classe derivada, executa a instalação.

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)

Parâmetros

stateSaver: IDictionary

Um IDictionary usado para salvar as informações necessárias para realizar uma confirmação, reversão ou operação de desinstalação.

Exceções

ArgumentException

O parâmetro stateSaver é null.

Exception

Ocorreu uma exceção no manipulador de evento BeforeInstall de um dos instaladores na coleção.

- ou -

Ocorreu uma exceção no manipulador de evento AfterInstall de um dos instaladores na coleção.

Exemplos

O exemplo a seguir demonstra o Install método da Installer classe . Uma classe é derivada da Installer classe base e o Install método é substituído.

   // 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

Notas aos Herdeiros

Se você substituir o Install(IDictionary) método em uma classe derivada, chame o método da Install(IDictionary) classe base primeiro em seu método derivado. O Install(IDictionary) método chama o Install(IDictionary) método de cada instalador contido na Installers propriedade dessa instância. Depois que os instaladores contidos são executados, esse método atualiza o IDictionary objeto (especificado por meio do stateSaver parâmetro) para refletir o status da instalação. O IDictionary deve estar vazio quando passado para o Install(IDictionary) método . Se todos os Install(IDictionary) métodos forem bem-sucedidos, o Commit(IDictionary) método será chamado. Caso contrário, o Rollback(IDictionary) método será chamado.
Se você precisar adicionar instâncias do instalador à Installers coleção no Install(IDictionary) método , execute as mesmas adições à coleção no Uninstall(IDictionary) método . No entanto, você poderá evitar manter a coleção em ambos os métodos se adicionar instâncias do instalador à Installers coleção no construtor de classe do instalador personalizado.

Aplica-se a