Installer Clase

Definición

public ref class Installer : System::ComponentModel::Component

public class Installer : System.ComponentModel.Component

type Installer = class
    inherit Component

Public Class Installer
Inherits Component

Herencia

Object

MarshalByRefObject

Component

Installer

Derivado

System.Configuration.Install.AssemblyInstaller

System.Configuration.Install.ComponentInstaller

System.Configuration.Install.TransactedInstaller

System.Management.Instrumentation.DefaultManagementInstaller

System.Management.Instrumentation.DefaultManagementProjectInstaller

Más…

Ejemplos

En el ejemplo siguiente se muestra el uso de la Installer clase . Crea una clase que hereda de Installer. Cuando Commit está a punto de completarse, Committing se produce un evento y se muestra un mensaje. Para usar la Installer clase , debe hacer referencia al ensamblado System.Configuration.Install del proyecto.

#using <System.dll>
#using <System.Configuration.Install.dll>

using namespace System;
using namespace System::Collections;
using namespace System::ComponentModel;
using namespace System::Configuration::Install;

// Set 'RunInstaller' attribute to true.

[RunInstaller(true)]
ref class MyInstallerClass: public Installer
{
private:

   // Event handler for 'Committing' event.
   void MyInstaller_Committing( Object^ sender, InstallEventArgs^ e )
   {
      Console::WriteLine( "" );
      Console::WriteLine( "Committing Event occurred." );
      Console::WriteLine( "" );
   }


   // Event handler for 'Committed' event.
   void MyInstaller_Committed( Object^ sender, InstallEventArgs^ e )
   {
      Console::WriteLine( "" );
      Console::WriteLine( "Committed Event occurred." );
      Console::WriteLine( "" );
   }


public:
   MyInstallerClass()
   {
      
      // Attach the 'Committed' event.
      this->Committed += gcnew InstallEventHandler( this, &MyInstallerClass::MyInstaller_Committed );
      
      // Attach the 'Committing' event.
      this->Committing += gcnew InstallEventHandler( this, &MyInstallerClass::MyInstaller_Committing );
   }


   // Override the 'Install' method.
   virtual void Install( IDictionary^ savedState ) override
   {
      Installer::Install( savedState );
   }


   // Override the 'Commit' method.
   virtual void Commit( IDictionary^ savedState ) override
   {
      Installer::Commit( savedState );
   }


   // Override the 'Rollback' method.
   virtual void Rollback( IDictionary^ savedState ) override
   {
      Installer::Rollback( savedState );
   }

};

int main()
{
   Console::WriteLine( "Usage : installutil.exe Installer.exe " );
}

using System;
using System.Collections;
using System.ComponentModel;
using System.Configuration.Install;

// Set 'RunInstaller' attribute to true.
[RunInstaller(true)]
public class MyInstallerClass: Installer
{
   public MyInstallerClass() :base()
   {
      // Attach the 'Committed' event.
      this.Committed += new InstallEventHandler(MyInstaller_Committed);
      // Attach the 'Committing' event.
      this.Committing += new InstallEventHandler(MyInstaller_Committing);
   }
   // Event handler for 'Committing' event.
   private void MyInstaller_Committing(object sender, InstallEventArgs e)
   {
      Console.WriteLine("");
      Console.WriteLine("Committing Event occurred.");
      Console.WriteLine("");
   }
   // Event handler for 'Committed' event.
   private void MyInstaller_Committed(object sender, InstallEventArgs e)
   {
      Console.WriteLine("");
      Console.WriteLine("Committed Event occurred.");
      Console.WriteLine("");
   }
   // Override the 'Install' method.
   public override void Install(IDictionary savedState)
   {
      base.Install(savedState);
   }
   // Override the 'Commit' method.
   public override void Commit(IDictionary savedState)
   {
      base.Commit(savedState);
   }
   // Override the 'Rollback' method.
   public override void Rollback(IDictionary savedState)
   {
      base.Rollback(savedState);
   }
   public static void Main()
   {
      Console.WriteLine("Usage : installutil.exe Installer.exe ");
   }
}

Imports System.Collections
Imports System.ComponentModel
Imports System.Configuration.Install

' Set 'RunInstaller' attribute to true.
<RunInstaller(True)> _
Public Class MyInstallerClass
   Inherits Installer

   Public Sub New()
       MyBase.New()
      ' Attach the 'Committed' event.
      AddHandler Me.Committed, AddressOf MyInstaller_Committed
      ' Attach the 'Committing' event.
      AddHandler Me.Committing, AddressOf MyInstaller_Committing
   End Sub

   ' Event handler for 'Committing' event.
   Private Sub MyInstaller_Committing(ByVal sender As Object, _
                                      ByVal e As InstallEventArgs)
      Console.WriteLine("")
      Console.WriteLine("Committing Event occurred.")
      Console.WriteLine("")
   End Sub

   ' Event handler for 'Committed' event.
   Private Sub MyInstaller_Committed(ByVal sender As Object, _
                                     ByVal e As InstallEventArgs)
      Console.WriteLine("")
      Console.WriteLine("Committed Event occurred.")
      Console.WriteLine("")
   End Sub

   ' Override the 'Install' method.
   Public Overrides Sub Install(ByVal savedState As IDictionary)
      MyBase.Install(savedState)
   End Sub

   ' Override the 'Commit' method.
   Public Overrides Sub Commit(ByVal savedState As IDictionary)
      MyBase.Commit(savedState)
   End Sub

   ' Override the 'Rollback' method.
   Public Overrides Sub Rollback(ByVal savedState As IDictionary)
      MyBase.Rollback(savedState)
   End Sub
   Public Shared Sub Main()
      Console.WriteLine("Usage : installutil.exe Installer.exe ")
   End Sub
End Class

Comentarios

Esta es la clase base para todos los instaladores personalizados de .NET Framework. Los instaladores son componentes que ayudan a instalar aplicaciones en un equipo.

Hay varios pasos que debe seguir para usar un Installer:

• Hereda la Installer clase .

• Invalide los Installmétodos , Commit, Rollbacky Uninstall .

• Agregue a la RunInstallerAttribute clase derivada y establézcalo en true.

• Coloque la clase derivada en el ensamblado con la aplicación que se va a instalar.

• Invoque los instaladores. Por ejemplo, use el InstallUtil.exe para invocar los instaladores.

La Installers propiedad contiene una colección de instaladores. Si esta instancia de Installer forma parte de una colección de instaladores, la Parent propiedad se establece en la Installer instancia que contiene la colección. Para obtener un ejemplo del uso de la Installers colección, vea la AssemblyInstaller clase .

Los Installmétodos , Commit, Rollbacky Uninstall de la Installer clase pasan por la colección de instaladores almacenados en la Installers propiedad e invoca el método correspondiente de cada instalador.

Los Installmétodos , Commit, Rollbacky Uninstall no siempre se llaman a en la misma Installer instancia. Por ejemplo, se puede usar una Installer instancia al instalar y confirmar una aplicación y, a continuación, se libera la referencia a esa instancia. Más adelante, al desinstalar la aplicación se crea una referencia a una nueva Installer instancia, lo que significa que una instancia diferente de Installerllama al Uninstall método . Por este motivo, en la clase derivada, no guarde el estado de un equipo en un instalador. En su lugar, use un IDictionary objeto que se conserva entre las llamadas y se pasa a los Installmétodos , Commit, Rollbacky Uninstall .

Dos situaciones muestran la necesidad de guardar información en el protector IDictionaryde estado . En primer lugar, supongamos que el instalador establece una clave del Registro. Debe guardar el valor original de la clave en .IDictionary Si la instalación se revierte, se puede restaurar el valor original. En segundo lugar, supongamos que el instalador reemplaza un archivo existente. Guarde el archivo existente en un directorio temporal y la ubicación de la nueva ubicación del archivo en .IDictionary Si la instalación se revierte, el archivo más reciente se elimina y se reemplaza por el original de la ubicación temporal.

La Installer.Context propiedad contiene información sobre la instalación. Por ejemplo, información sobre la ubicación del archivo de registro para la instalación, la ubicación del archivo para guardar la información requerida por el Uninstall método y la línea de comandos que se especificó cuando se ejecutó el ejecutable de instalación.

Constructores

Propiedades

Métodos

Eventos

Se aplica a

Consulte también

• AssemblyInstaller
• ComponentInstaller
• InstallerCollection
• TransactedInstaller
• Installutil.exe (Herramienta Installer)