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)
Sintaxis
Visual Basic (Declaración)
Public Overridable Sub Install ( _
stateSaver As IDictionary _
)
Dim instance As Installer
Dim stateSaver As IDictionary
instance.Install(stateSaver)
public virtual void Install (
IDictionary stateSaver
)
public:
virtual void Install (
IDictionary^ stateSaver
)
public void Install (
IDictionary stateSaver
)
public function Install (
stateSaver : IDictionary
)
Parámetros
- stateSaver
IDictionary que se utiliza con el fin de guardar la información necesaria para realizar una operación de confirmar, deshacer o desinstalar.
Excepciones
| Tipo de excepción | Condición |
|---|
ArgumentException | El parámetro stateSaver es referencia de objeto null (Nothing en Visual Basic). |
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. |
Comentarios
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.
Ejemplo
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 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
// 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:
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 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
Seguridad de .NET Framework
- Plena confianza para el llamador inmediato. Un código de confianza parcial no puede utilizar este miembro. Para obtener más información, vea .
Plataformas
Windows 98, Windows 2000 SP4, Windows Millennium, Windows Server 2003, Windows XP Media Center, Windows XP Professional x64, Windows XP SP2, Windows XP Starter Edition
.NET Framework no admite todas las versiones de cada plataforma. Para obtener una lista de las versiones admitidas, vea Requisitos del sistema.
Información de versión
.NET Framework
Compatible con: 2.0, 1.1, 1.0
Vea también