AssemblyInstaller Clase

Definición

Espacio de nombres:

System.Configuration.Install

Ensamblado:

System.Configuration.Install.dll

Carga un ensamblado y ejecuta todos los instaladores que contiene.

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

Herencia

Object

MarshalByRefObject

Component

Installer

AssemblyInstaller

Ejemplos

En el ejemplo siguiente, se crea mediante AssemblyInstaller la invocación del AssemblyInstaller constructor . Las propiedades de este objeto se establecen y se llama a los Install métodos y Commit para instalar el MyAssembly.exe ensamblado.

#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

Constructores

AssemblyInstaller()	Inicializa una nueva instancia de la clase AssemblyInstaller.
AssemblyInstaller(Assembly, String[])	Inicializa una nueva instancia de la clase AssemblyInstaller y especifica tanto el ensamblado que se va a instalar como la línea de comandos que se va a utilizar al crear un nuevo objeto InstallContext.
AssemblyInstaller(String, String[])	Inicializa una nueva instancia de la clase AssemblyInstaller y especifica tanto el nombre de archivo del ensamblado que se va a instalar como la línea de comandos que se va a utilizar al crear un nuevo objeto InstallContext para la instalación del ensamblado.

Propiedades

Assembly	Obtiene o establece el ensamblado que se va a instalar.
CanRaiseEvents	Obtiene un valor que indica si el componente puede generar un evento. (Heredado de Component)
CommandLine	Obtiene o establece la línea de comandos que se va a utilizar al crear un nuevo objeto InstallContext para la instalación del ensamblado.
Container	Obtiene la interfaz IContainer que contiene la clase Component. (Heredado de Component)
Context	Obtiene o establece información sobre la instalación actual. (Heredado de Installer)
DesignMode	Obtiene un valor que indica si Component está actualmente en modo de diseño. (Heredado de Component)
Events	Obtiene la lista de controladores de eventos asociados a Component. (Heredado de Component)
HelpText	Obtiene el texto de ayuda de todos los instaladores que se encuentran en la colección de instaladores.
Installers	Obtiene la colección de instaladores que contiene este instalador. (Heredado de Installer)
Parent	Obtiene o establece el instalador que contiene la colección a la que pertenece este instalador. (Heredado de Installer)
Path	Obtiene o establece la ruta de acceso al ensamblado que se va a instalar.
Site	Obtiene o establece ISite de Component. (Heredado de Component)
UseNewContext	Obtiene o establece un valor que indica si se va a crear un nuevo objeto InstallContext para la instalación del ensamblado.

Métodos

CheckIfInstallable(String)	Comprueba si se puede instalar el ensamblado especificado.
Commit(IDictionary)	Completa la transacción de instalación.
CreateObjRef(Type)	Crea un objeto que contiene toda la información relevante necesaria para generar un proxy utilizado para comunicarse con un objeto remoto. (Heredado de MarshalByRefObject)
Dispose()	Libera todos los recursos que usa Component. (Heredado de Component)
Dispose(Boolean)	Libera los recursos no administrados que usa Component y, de forma opcional, libera los recursos administrados. (Heredado de Component)
Equals(Object)	Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object)
GetHashCode()	Sirve como la función hash predeterminada. (Heredado de Object)
GetLifetimeService()	Recupera el objeto de servicio de duración actual que controla la directiva de duración de esta instancia. (Heredado de MarshalByRefObject)
GetService(Type)	Devuelve un objeto que representa el servicio suministrado por Component o por Container. (Heredado de Component)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
InitializeLifetimeService()	Obtiene un objeto de servicio de duración para controlar la directiva de duración de esta instancia. (Heredado de MarshalByRefObject)
Install(IDictionary)	Realiza la instalación.
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
MemberwiseClone(Boolean)	Crea una copia superficial del objeto MarshalByRefObject actual. (Heredado de MarshalByRefObject)
OnAfterInstall(IDictionary)	Genera el evento AfterInstall. (Heredado de Installer)
OnAfterRollback(IDictionary)	Genera el evento AfterRollback. (Heredado de Installer)
OnAfterUninstall(IDictionary)	Genera el evento AfterUninstall. (Heredado de Installer)
OnBeforeInstall(IDictionary)	Genera el evento BeforeInstall. (Heredado de Installer)
OnBeforeRollback(IDictionary)	Genera el evento BeforeRollback. (Heredado de Installer)
OnBeforeUninstall(IDictionary)	Genera el evento BeforeUninstall. (Heredado de Installer)
OnCommitted(IDictionary)	Genera el evento Committed. (Heredado de Installer)
OnCommitting(IDictionary)	Genera el evento Committing. (Heredado de Installer)
Rollback(IDictionary)	Restaura el estado en el que estaba el equipo antes de la instalación.
ToString()	Devuelve una String que contiene el nombre del Component, si existe. Este método no se debe invalidar. (Heredado de Component)
Uninstall(IDictionary)	Quita una instalación.

Eventos

AfterInstall	Se produce después de ejecutarse los métodos Install(IDictionary) de todos los instaladores de la propiedad Installers. (Heredado de Installer)
AfterRollback	Se produce después de deshacerse la instalación de todos los instaladores de la propiedad Installers. (Heredado de Installer)
AfterUninstall	Se produce después de que todos los instaladores de la propiedad Installers realicen sus operaciones de desinstalación. (Heredado de Installer)
BeforeInstall	Se produce antes de ejecutarse el método Install(IDictionary) de cada instalador en la colección de instaladores. (Heredado de Installer)
BeforeRollback	Se produce antes de deshacerse los instaladores de la propiedad Installers. (Heredado de Installer)
BeforeUninstall	Se produce antes de que los instaladores de la propiedad Installers realicen sus operaciones de desinstalación. (Heredado de Installer)
Committed	Se produce después de que todos los instaladores de la propiedad Installers confirmen sus instalaciones. (Heredado de Installer)
Committing	Se produce antes de que los instaladores de la propiedad Installers confirmen sus instalaciones. (Heredado de Installer)
Disposed	Tiene lugar cuando una llamada elimina el componente mediante una llamada al método Dispose(). (Heredado de Component)