Exportar (0) Imprimir
Expandir Tudo
Este artigo foi traduzido por máquina. Coloque o ponteiro do mouse sobre as frases do artigo para ver o texto original. Mais informações.
Tradução
Original

Classe Installer

Fornece a base para instalações personalizadas.

Namespace:  System.Configuration.Install
Assembly:  System.Configuration.Install (em System.Configuration.Install.dll)

public class Installer : Component

O tipo Installer expõe os membros a seguir.

  NomeDescrição
Método públicoInstallerInicializa uma nova instância da classe Installer.
Superior

  NomeDescrição
Propriedade protegidaCanRaiseEventsObtém um valor indicando se o componente pode disparar um evento. (Herdado de Component.)
Propriedade públicaContainerObtém o IContainer que contém o Component. (Herdado de Component.)
Propriedade públicaContextObtém ou define informações sobre a instalação atual.
Propriedade protegidaDesignMode Obtém um valor que indica se o Component está em modo de design. (Herdado de Component.)
Propriedade protegidaEvents Obtém a lista de manipuladores de eventos que estão conectados a este Component. (Herdado de Component.)
Propriedade públicaHelpTextObtém o texto de ajuda para todos os instaladores na coleção de instalador.
Propriedade públicaInstallersObtém a coleção de instaladores que esse instalador contém.
Propriedade públicaParentObtém ou define o instalador que contém a coleção à qual pertence este instalador.
Propriedade públicaSite Obtém ou define o ISite do Component. (Herdado de Component.)
Superior

  NomeDescrição
Método públicoCommitQuando substituído em uma classe derivada, conclui a transação de instalação.
Método públicoCreateObjRefCria um objeto que contém todas as informações relevantes necessárias para gerar um proxy usado para se comunicar com um objeto remoto. (Herdado de MarshalByRefObject.)
Método públicoDispose() Libera todos os recursos usados pelo Component. (Herdado de Component.)
Método protegidoDispose(Boolean) Libera os recursos não gerenciados usados pelo Component e, opcionalmente, libera os recursos gerenciados. (Herdado de Component.)
Método públicoEquals(Object) Verifica se o objeto especificado é igual ao objeto atual. (Herdado de Object.)
Método protegidoFinalize Libera os recursos não gerenciados e executa outras operações de limpeza antes do Component ser recuperados pela coleta de lixo. (Herdado de Component.)
Método públicoGetHashCodeServe como a função de hash padrão. (Herdado de Object.)
Método públicoGetLifetimeService Recupera o objeto atual de serviço de vida útil que controla a diretiva de vida útil para esta instância. (Herdado de MarshalByRefObject.)
Método protegidoGetService Retorna um objeto que representa um serviço fornecido pelo Component ou por seu Container. (Herdado de Component.)
Método públicoGetType Obtém o Type da instância atual. (Herdado de Object.)
Método públicoInitializeLifetimeService Obtém um objeto de serviço de tempo de vida para controlar a diretiva de vida útil para esta instância. (Herdado de MarshalByRefObject.)
Método públicoInstallQuando substituído em uma classe derivada, realiza a instalação.
Método protegidoMemberwiseClone()Cria uma cópia superficial do Object atual. (Herdado de Object.)
Método protegidoMemberwiseClone(Boolean) Cria uma cópia superficial do objeto MarshalByRefObject atual. (Herdado de MarshalByRefObject.)
Método protegidoOnAfterInstallGera o evento AfterInstall.
Método protegidoOnAfterRollbackGera o evento AfterRollback.
Método protegidoOnAfterUninstallGera o evento AfterUninstall.
Método protegidoOnBeforeInstallGera o evento BeforeInstall.
Método protegidoOnBeforeRollbackGera o evento BeforeRollback.
Método protegidoOnBeforeUninstallGera o evento BeforeUninstall.
Método protegidoOnCommittedGera o evento Committed.
Método protegidoOnCommittingGera o evento Committing.
Método públicoRollbackQuando substituído em uma classe derivada, restaura o estado pré-instalação do computador.
Método públicoToStringRetorna uma String contendo o nome do Component, se houver. Este método não deve ser sobrescrito. (Herdado de Component.)
Método públicoUninstallQuando substituído em uma classe derivada, remove uma instalação.
Superior

  NomeDescrição
Evento públicoAfterInstallOcorre após a Install métodos de todos os instaladores na Installers propriedade foram executados.
Evento públicoAfterRollbackOcorre após as instalações de todos os instaladores na Installers propriedade serão revertidas.
Evento públicoAfterUninstallOcorre após todos os instaladores na Installers propriedade executar suas operações de desinstalação.
Evento públicoBeforeInstallOcorre antes do Install método de cada instalador na coleção de instalador foi executado.
Evento públicoBeforeRollbackOcorre antes de instaladores na Installers propriedade serão revertidas.
Evento públicoBeforeUninstallOcorre antes de instaladores na Installers propriedade executar suas operações de desinstalação.
Evento públicoCommittedOcorre após todos os instaladores na Installers propriedade se comprometeram a suas instalações.
Evento públicoCommittingOcorre antes de instaladores na Installers committ de propriedade suas instalações.
Evento públicoDisposedOcorre quando o componente é descartado por uma chamada do método Dispose. (Herdado de Component.)
Superior

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

Com suporte em: 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Com suporte em: 4, 3.5 SP1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, 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)

O .NET Framework não oferece suporte a todas as versões de cada plataforma. Para obter uma lista das versões com suporte, consulte Requisitos do sistema do .NET Framework.

Quaisquer membros estático (Shared no Visual Basic) públicos deste tipo são thread-safe. Não há garantia de que qualquer membro de instância seja thread-safe.

Contribuições da comunidade

ADICIONAR
Mostrar:
© 2014 Microsoft