AssemblyInstaller Clase

Definición

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

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()
Obsoletos.

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()
Obsoletos.

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)

Se aplica a