Installer.Install(IDictionary) Método
Definição
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
O parâmetro stateSaver
é null
.
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.