AssemblyInstaller Classe

Definição

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

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