AssemblyInstaller Classe
Definição
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
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) |