Classe Installer

Esta é a classe base para todos os instaladores personalizados na.NET Framework. Instaladores são componentes que ajudam a instalar aplicativos em um computador.

Há várias etapas que devem ser seguidas para usar um Installer:

• Herdar de Installer classe.

• Override the Install, Commit, Rollback, and Uninstall methods.

• Adicionar o RunInstallerAttribute a derivada da classe e defina-o como true.

• Coloque sua classe derivada no assembly com o seu aplicativo para instalar.

• Invoca os instaladores. Por exemplo, use o InstallUtil para invocar os instaladores.

O Installers propriedade contém uma coleção de instaladores. Se esta instância do Installer faz parte de uma coleção de instalador, o Parent propriedade é definida como o Installer instância que contém a coleção. Para obter um exemplo do uso de Installers coleção, consulte o AssemblyInstaller classe.

O Install, Commit, Rollback, e Uninstall métodos para o Installer classe percorrer a coleção de instaladores armazenado na Installers propriedade e chama o método correspondente de cada instalador.

O Install, Commit, Rollback, e Uninstall métodos não são sempre chamados no mesmo Installer instância. Por exemplo, um Installer instância pode ser usada durante a instalação e o comprometimento de um aplicativo e, em seguida, em que a referência a essa instância é liberada. Posteriormente, a desinstalação do aplicativo cria uma referência a um novo Installer instância, o que significa que o Uninstall método é chamado por uma instância diferente de Installer. Por esse motivo, em sua classe derivada, salva o estado de um computador em um instalador. Em vez disso, use um IDictionary que é preservado em chamadas e passado para seu Install, Commit, Rollback, e Uninstall métodos.

Duas situações ilustram a necessidade de salvar informações na proteção de estado IDictionary. Primeiro, vamos supor que o seu instalador define uma chave do registro. Ele deve salvar o valor de original da chave na IDictionary. Se a instalação é revertida, o valor original pode ser restaurado. Em segundo lugar, vamos supor que o instalador substitui um arquivo existente. Salvar o arquivo em um diretório temporário e o local do novo local do arquivo de IDictionary. Se a instalação é revertida, o arquivo mais recente é excluído e substituído por original do local temporário.

O Installer.Context propriedade contém informações sobre a instalação. Por exemplo, informações sobre o local do arquivo de log para a instalação, o local do arquivo para salvar as informações necessárias para o Uninstall método e linha de comando que foi inserida quando a instalação executável foi executada.

O exemplo a seguir demonstra o uso da Installer classe. Ele cria uma classe que herda de Installer. Quando Commit está prestes a concluir, Committing evento ocorre e uma mensagem é exibida.

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 occured.");
      Console.WriteLine("");
   }
   // Event handler for 'Committed' event.
   private void MyInstaller_Committed(object sender, InstallEventArgs e)
   {
      Console.WriteLine("");
      Console.WriteLine("Committed Event occured.");
      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 ");
   }
}

.NET Framework

.NET Framework Client Profile

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Função Server Core sem suporte), Windows Server 2008 R2 (Função Server Core com suporte com o SP1 ou posterior, Itanium sem suporte)

Referência

Outros recursos