Installer.Install(IDictionary) Método

Referencia

Definición

Espacio de nombres:: System.Configuration.Install

Ensamblado:: System.Configuration.Install.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Cuando se reemplaza en una clase derivada, se lleva a cabo la instalación.

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

IDictionary que se utiliza con el fin de guardar la información necesaria para realizar una operación de confirmar, deshacer o desinstalar.

Excepciones

ArgumentException

El parámetro stateSaver es null.

Exception

Se ha producido una excepción en el controlador de eventos BeforeInstall de uno de los instaladores de la colección.

o bien

Se ha producido una excepción en el controlador de eventos AfterInstall de uno de los instaladores de la colección.

Ejemplos

En el ejemplo siguiente se muestra el Install método de la Installer clase . Una clase se deriva de la Installer clase base y el Install método se invalida.

   // 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 a los desarrolladores de herederos

Si invalida el Install(IDictionary) método en una clase derivada, asegúrese de llamar primero al método de Install(IDictionary) la clase base en el método derivado. El Install(IDictionary) método llama al Install(IDictionary) método de cada instalador contenido en la Installers propiedad de esta instancia. Una vez ejecutados los instaladores contenidos, este método actualiza el IDictionary objeto (especificado a través del stateSaver parámetro ) para reflejar el estado de la instalación. IDictionary debe estar vacío cuando se pasa al Install(IDictionary) método . Si todos los Install(IDictionary) métodos se realizan correctamente, se llama al Commit(IDictionary) método . De lo contrario, se llama al Rollback(IDictionary) método .
Si necesita agregar instancias de instalador a la Installers colección en el Install(IDictionary) método , asegúrese de realizar las mismas adiciones a la colección en el Uninstall(IDictionary) método . Sin embargo, puede evitar mantener la colección en ambos métodos si agrega instancias del instalador a la Installers colección en el constructor de clase para el instalador personalizado.

Se aplica a