Esta documentación está archivada y no tiene mantenimiento.

Installer.Install (Método)

Actualización: noviembre 2007

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

Espacio de nombres:  System.Configuration.Install
Ensamblado:  System.Configuration.Install (en System.Configuration.Install.dll)

public virtual void Install(
	IDictionary stateSaver
)
public void Install(
	IDictionary stateSaver
)
public function Install(
	stateSaver : IDictionary
)

Parámetros

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

ExcepciónCondición
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.

Notas para los herederos:
  • Si se reemplaza el método Install en una clase derivada, hay que asegurarse de llamar primero al método Install de la clase base en el método derivado. El método Install llama al método Install de cada instalador que contiene la propiedad Installers de esta instancia. Tras ejecutarse los instaladores que contiene, este método actualiza el objeto IDictionary (especificado por el parámetro stateSaver) para reflejar el estado de la instalación. El objeto IDictionary debe estar vacío al pasarlo al método Install. Si se ejecutan correctamente todos los métodos Install, se llama al método Commit. De lo contrario, se llama al método Rollback.

  • Si es necesario agregar instancias del instalador a la colección Installers en el método Install, asegúrese de realizar las mismas adiciones a la colección en el método Uninstall. Sin embargo, puede evitar mantener la colección en ambos métodos si agrega instancias del instalador a la colección Installers en el constructor de clase para su instalador personalizado.

En el siguiente ejemplo se muestra el método Install de la clase Installer. Se deriva una clase de la clase base Installer y se reemplaza el método Install.

// 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 void Install(IDictionary mySavedState)
{
    super.Install(mySavedState);

    // Code maybe written for installation of an application.
    Console.WriteLine("The Install method of"
        +" 'MyInstallerSample' has been called");
} //Install


Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

.NET Framework y .NET Compact Framework no admiten todas las versiones de cada plataforma. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

.NET Framework

Compatible con: 3.5, 3.0, 2.0, 1.1, 1.0
Mostrar: