AssemblyInstaller Classe

Referência

Definição

Namespace:: System.Configuration.Install

Assembly:: System.Configuration.Install.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Carrega um assembly e executa todos os instaladores nele.

public ref class AssemblyInstaller : System::Configuration::Install::Installer

public class AssemblyInstaller : System.Configuration.Install.Installer

type AssemblyInstaller = class
    inherit Installer

Public Class AssemblyInstaller
Inherits Installer

Herança: Object

MarshalByRefObject

Component

Installer
AssemblyInstaller

Exemplos

No exemplo a seguir, um AssemblyInstaller é criado invocando o AssemblyInstaller construtor . As propriedades desse objeto são definidas e os Install métodos e Commit são chamados para instalar o MyAssembly.exe assembly.

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

using namespace System;
using namespace System::Configuration::Install;
using namespace System::Collections;
using namespace System::Collections::Specialized;
int main()
{
   IDictionary^ mySavedState = gcnew Hashtable;
   Console::WriteLine( "" );
   try
   {
      
      // Set the commandline argument array for 'logfile'.
      array<String^>^commandLineOptions = {"/LogFile=example.log"};
      
      // Create an object of the 'AssemblyInstaller' class.
      AssemblyInstaller^ myAssemblyInstaller = gcnew AssemblyInstaller(
         "MyAssembly.exe", commandLineOptions );
      myAssemblyInstaller->UseNewContext = true;
      
      // Install the 'MyAssembly' assembly.
      myAssemblyInstaller->Install( mySavedState );
      
      // Commit the 'MyAssembly' assembly.
      myAssemblyInstaller->Commit( mySavedState );
   }
   catch ( Exception^ e ) 
   {
      Console::WriteLine( e->Message );
   }
}

using System;
using System.Configuration.Install;
using System.Collections;
using System.Collections.Specialized;

class AssemblyInstaller_Example
{
   static void Main()
   {
      IDictionary mySavedState = new Hashtable();

      Console.WriteLine( "" );

      try
      {
         // Set the commandline argument array for 'logfile'.
         string[] commandLineOptions = new string[ 1 ] {"/LogFile=example.log"};

         // Create an object of the 'AssemblyInstaller' class.
         AssemblyInstaller myAssemblyInstaller = new
                     AssemblyInstaller( "MyAssembly.exe" , commandLineOptions );

         myAssemblyInstaller.UseNewContext = true;

         // Install the 'MyAssembly' assembly.
         myAssemblyInstaller.Install( mySavedState );

         // Commit the 'MyAssembly' assembly.
         myAssemblyInstaller.Commit( mySavedState );
      }
      catch (Exception e)
      {
         Console.WriteLine( e.Message );
      }
   }
}

Imports System.Configuration.Install
Imports System.Collections
Imports System.Collections.Specialized

Class AssemblyInstaller_Example

   Shared Sub Main()
      Dim mySavedState = New Hashtable()

      Console.WriteLine("")

      Try
         ' Set the commandline argument array for 'logfile'.
         Dim commandLineOptions(0) As String
         commandLineOptions(0) = "/LogFile=example.log"

         ' Create an object of the 'AssemblyInstaller' class.
         Dim myAssemblyInstaller As _
               New AssemblyInstaller("MyAssembly.exe", commandLineOptions)

         myAssemblyInstaller.UseNewContext = True

         ' Install the 'MyAssembly' assembly.
         myAssemblyInstaller.Install(mySavedState)

         ' Commit the 'MyAssembly' assembly.
         myAssemblyInstaller.Commit(mySavedState)
      Catch e As Exception
         Console.WriteLine(e.Message)
      End Try
   End Sub
End Class

Construtores

AssemblyInstaller()	Inicializa uma nova instância da classe AssemblyInstaller.
AssemblyInstaller(Assembly, String[])	Inicializa uma nova instância da classe AssemblyInstaller e especifica tanto o assembly a ser instalado quanto a linha de comando a ser usada ao criar um novo objeto InstallContext.
AssemblyInstaller(String, String[])	Inicializa uma nova instância da classe AssemblyInstaller e especifica tanto o nome do arquivo do assembly a ser instalado quanto a linha de comando a ser usada ao criar um novo objeto InstallContext para a instalação do assembly.

Propriedades

Assembly	Obtém ou define o assembly a ser instalado.
CanRaiseEvents	Obtém um valor que indica se o componente pode acionar um evento. (Herdado de Component)
CommandLine	Obtém ou define a linha de comando a ser usada ao criar um novo objeto InstallContext para a instalação do assembly.
Container	Obtém o IContainer que contém o Component. (Herdado de Component)
Context	Obtém ou define informações sobre a instalação atual. (Herdado de Installer)
DesignMode	Obtém um valor que indica se o Component está no modo de design no momento. (Herdado de Component)
Events	Obtém a lista de manipuladores de eventos que estão anexados a este Component. (Herdado de Component)
HelpText	Obtém o texto de ajuda para todos os instaladores na coleção de instalador.
Installers	Obtém a coleção de instaladores que contém esse instalador. (Herdado de Installer)
Parent	Obtém ou define o instalador que contém a coleção à qual o instalador pertence. (Herdado de Installer)
Path	Obtém ou define o caminho do assembly a ser instalado.
Site	Obtém ou define o ISite do Component. (Herdado de Component)
UseNewContext	Obtém ou define um valor que indica se deve ser criado um novo objeto InstallContext para a instalação do assembly.

Métodos

CheckIfInstallable(String)	Verifica para ver se o assembly especificado pode ser instalado.
Commit(IDictionary)	Conclui a transação de instalação.
CreateObjRef(Type)	Cria 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)
Dispose()	Libera todos os recursos usados pelo Component. (Herdado de Component)
Dispose(Boolean)	Libera os recursos não gerenciados usados pelo Component e opcionalmente libera os recursos gerenciados. (Herdado de Component)
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetLifetimeService()	Obsoleto. Recupera o objeto de serviço de tempo de vida atual que controla a política de ciclo de vida para esta instância. (Herdado de MarshalByRefObject)
GetService(Type)	Retorna um objeto que representa um serviço fornecido pelo Component ou pelo seu Container. (Herdado de Component)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
InitializeLifetimeService()	Obsoleto. Obtém um objeto de serviço de tempo de vida para controlar a política de tempo de vida para essa instância. (Herdado de MarshalByRefObject)
Install(IDictionary)	Realiza a instalação.
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
MemberwiseClone(Boolean)	Cria uma cópia superficial do objeto MarshalByRefObject atual. (Herdado de MarshalByRefObject)
OnAfterInstall(IDictionary)	Aciona o evento AfterInstall. (Herdado de Installer)
OnAfterRollback(IDictionary)	Aciona o evento AfterRollback. (Herdado de Installer)
OnAfterUninstall(IDictionary)	Aciona o evento AfterUninstall. (Herdado de Installer)
OnBeforeInstall(IDictionary)	Aciona o evento BeforeInstall. (Herdado de Installer)
OnBeforeRollback(IDictionary)	Aciona o evento BeforeRollback. (Herdado de Installer)
OnBeforeUninstall(IDictionary)	Aciona o evento BeforeUninstall. (Herdado de Installer)
OnCommitted(IDictionary)	Aciona o evento Committed. (Herdado de Installer)
OnCommitting(IDictionary)	Aciona o evento Committing. (Herdado de Installer)
Rollback(IDictionary)	Restaura o computador para o estado em que estava antes da instalação.
ToString()	Retorna um String que contém o nome do Component, se houver. Esse método não deve ser substituído. (Herdado de Component)
Uninstall(IDictionary)	Remove uma instalação.

Eventos

AfterInstall	Ocorre depois que os métodos do Install(IDictionary) de todos os instaladores na propriedade Installers foram executados. (Herdado de Installer)
AfterRollback	Ocorre após as instalações de todos os instaladores na propriedade Installers serem revertidas. (Herdado de Installer)
AfterUninstall	Ocorre depois que todos os instaladores na propriedade Installers realizam suas operações de desinstalação. (Herdado de Installer)
BeforeInstall	Ocorre antes do método Install(IDictionary) de cada instalador no instalador em que a coleção foi executada. (Herdado de Installer)
BeforeRollback	Ocorre antes que os instaladores na propriedade Installers sejam revertidos. (Herdado de Installer)
BeforeUninstall	Ocorre antes dos instaladores na propriedade Installers executarem suas operações de desinstalação. (Herdado de Installer)
Committed	Ocorre depois que todos os instaladores na propriedade Installers confirmaram suas instalações. (Herdado de Installer)
Committing	Ocorre antes que os instaladores na propriedade Installers façam commit de suas instalações. (Herdado de Installer)
Disposed	Ocorre quando o componente é disposto por uma chamada ao método Dispose(). (Herdado de Component)

Aplica-se a

Compartilhar via