AssemblyInstaller Classe

Definizione

Carica un assembly ed esegue tutti i programmi di installazione in esso contenuti.Loads an assembly, and runs all the installers in it.

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
Ereditarietà

Esempi

Nell'esempio seguente viene creato un AssemblyInstaller oggetto richiamando il AssemblyInstaller costruttore.In the following example, an AssemblyInstaller is created by invoking the AssemblyInstaller constructor. Vengono impostate le proprietà di questo oggetto e vengono Install chiamati Commit i metodi e per installare l' MyAssembly.exe assembly.The properties of this object are set and the Install and Commit methods are called to install the 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 ( ArgumentException^ ) 
   {
   }
   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 (ArgumentException)
      {
      }
      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 ArgumentException
      Catch e As Exception
         Console.WriteLine(e.Message)
      End Try
   End Sub
End Class

Costruttori

AssemblyInstaller()

Inizializza una nuova istanza della classe AssemblyInstaller.Initializes a new instance of the AssemblyInstaller class.

AssemblyInstaller(Assembly, String[])

Inizializza una nuova istanza della classe AssemblyInstaller e specifica sia l'assembly da installare, sia la riga di comando da utilizzare per la creazione di un nuovo oggetto InstallContext.Initializes a new instance of the AssemblyInstaller class, and specifies both the assembly to install and the command line to use when creating a new InstallContext object.

AssemblyInstaller(String, String[])

Inizializza una nuova istanza della classe AssemblyInstaller e specifica sia il nome file dell'assembly da installare, sia la riga di comando da utilizzare per la creazione di un nuovo oggetto InstallContext per l'installazione dell'assembly.Initializes a new instance of the AssemblyInstaller class, and specifies both the file name of the assembly to install and the command line to use when creating a new InstallContext object for the assembly's installation.

Proprietà

Assembly

Ottiene o imposta l'assembly da installare.Gets or sets the assembly to install.

CanRaiseEvents

Ottiene un valore che indica se il componente può generare un evento.Gets a value indicating whether the component can raise an event.

(Ereditato da Component)
CommandLine

Ottiene o imposta la riga di comando da utilizzare durante la creazione di un nuovo oggetto InstallContext per l'installazione dell'assembly.Gets or sets the command line to use when creating a new InstallContext object for the assembly's installation.

Container

Ottiene il IContainer che contiene il Component.Gets the IContainer that contains the Component.

(Ereditato da Component)
Context

Ottiene o imposta le informazioni sull'installazione corrente.Gets or sets information about the current installation.

(Ereditato da Installer)
DesignMode

Ottiene un valore che indica se il Component si trova in modalità progettazione.Gets a value that indicates whether the Component is currently in design mode.

(Ereditato da Component)
Events

Ottiene l'elenco dei gestori eventi allegati a questo Component.Gets the list of event handlers that are attached to this Component.

(Ereditato da Component)
HelpText

Ottiene il testo della Guida per tutti i programmi di installazione dell'insieme Installer.Gets the help text for all the installers in the installer collection.

Installers

Ottiene l'insieme dei programmi di installazione contenuti nel programma.Gets the collection of installers that this installer contains.

(Ereditato da Installer)
Parent

Ottiene o imposta il programma di installazione contenente l'insieme cui appartiene questo programma di installazione.Gets or sets the installer containing the collection that this installer belongs to.

(Ereditato da Installer)
Path

Ottiene o imposta il percorso dell'assembly da installare.Gets or sets the path of the assembly to install.

Site

Ottiene o imposta l'oggetto ISite di Component.Gets or sets the ISite of the Component.

(Ereditato da Component)
UseNewContext

Ottiene o imposta un valore che indica se creare un nuovo oggetto InstallContext per l'installazione dell'assembly.Gets or sets a value indicating whether to create a new InstallContext object for the assembly's installation.

Metodi

CheckIfInstallable(String)

Verifica se è possibile installare l'assembly specificato.Checks to see if the specified assembly can be installed.

Commit(IDictionary)

Completa la transazione di installazione.Completes the installation transaction.

CreateObjRef(Type)

Consente di creare un oggetto che contiene tutte le informazioni rilevanti necessarie per la generazione del proxy utilizzato per effettuare la comunicazione con un oggetto remoto.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Ereditato da MarshalByRefObject)
Dispose()

Rilascia tutte le risorse usate da Component.Releases all resources used by the Component.

(Ereditato da Component)
Dispose(Boolean)

Rilascia le risorse non gestite usate da Component e, facoltativamente, le risorse gestite.Releases the unmanaged resources used by the Component and optionally releases the managed resources.

(Ereditato da Component)
Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.Determines whether the specified object is equal to the current object.

(Ereditato da Object)
GetHashCode()

Funge da funzione hash predefinita.Serves as the default hash function.

(Ereditato da Object)
GetLifetimeService()

Consente di recuperare l'oggetto servizio di durata corrente per controllare i criteri di durata per l'istanza.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Ereditato da MarshalByRefObject)
GetService(Type)

Consente di restituire un oggetto che rappresenta un servizio fornito da Component o dal relativo Container.Returns an object that represents a service provided by the Component or by its Container.

(Ereditato da Component)
GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Ereditato da Object)
InitializeLifetimeService()

Ottiene un oggetto servizio di durata per controllare i criteri di durata per questa istanza.Obtains a lifetime service object to control the lifetime policy for this instance.

(Ereditato da MarshalByRefObject)
Install(IDictionary)

Esegue l'installazione.Performs the installation.

MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Ereditato da Object)
MemberwiseClone(Boolean)

Crea una copia dei riferimenti dell'oggetto MarshalByRefObject corrente.Creates a shallow copy of the current MarshalByRefObject object.

(Ereditato da MarshalByRefObject)
OnAfterInstall(IDictionary)

Genera l'evento AfterInstall.Raises the AfterInstall event.

(Ereditato da Installer)
OnAfterRollback(IDictionary)

Genera l'evento AfterRollback.Raises the AfterRollback event.

(Ereditato da Installer)
OnAfterUninstall(IDictionary)

Genera l'evento AfterUninstall.Raises the AfterUninstall event.

(Ereditato da Installer)
OnBeforeInstall(IDictionary)

Genera l'evento BeforeInstall.Raises the BeforeInstall event.

(Ereditato da Installer)
OnBeforeRollback(IDictionary)

Genera l'evento BeforeRollback.Raises the BeforeRollback event.

(Ereditato da Installer)
OnBeforeUninstall(IDictionary)

Genera l'evento BeforeUninstall.Raises the BeforeUninstall event.

(Ereditato da Installer)
OnCommitted(IDictionary)

Genera l'evento Committed.Raises the Committed event.

(Ereditato da Installer)
OnCommitting(IDictionary)

Genera l'evento Committing.Raises the Committing event.

(Ereditato da Installer)
Rollback(IDictionary)

Ripristina lo stato in cui si trovava il computer prima dell'installazione.Restores the computer to the state it was in before the installation.

ToString()

Restituisce un oggetto String che contiene il nome dell'eventuale oggetto Component.Returns a String containing the name of the Component, if any. Questo metodo non deve essere sottoposto a override.This method should not be overridden.

(Ereditato da Component)
Uninstall(IDictionary)

Rimuove un'installazione.Removes an installation.

Eventi

AfterInstall

Viene generato dopo l'esecuzione dei metodi Install(IDictionary) di tutti i programmi di installazione contenuti nella proprietà Installers.Occurs after the Install(IDictionary) methods of all the installers in the Installers property have run.

(Ereditato da Installer)
AfterRollback

Si verifica dopo il rollback delle installazioni di tutti i programmi di installazione contenuti nella proprietà Installers.Occurs after the installations of all the installers in the Installers property are rolled back.

(Ereditato da Installer)
AfterUninstall

Viene generato dopo l'esecuzione delle operazioni di disinstallazione di tutti i programmi di installazione contenuti nella proprietà Installers.Occurs after all the installers in the Installers property perform their uninstallation operations.

(Ereditato da Installer)
BeforeInstall

Si verifica dopo l'esecuzione del metodo Install(IDictionary) di ogni programma di installazione contenuto nella raccolta Installer.Occurs before the Install(IDictionary) method of each installer in the installer collection has run.

(Ereditato da Installer)
BeforeRollback

Viene generato prima del rollback dei programmi di installazione contenuti nella proprietà Installers.Occurs before the installers in the Installers property are rolled back.

(Ereditato da Installer)
BeforeUninstall

Viene generato prima dell'esecuzione delle operazioni di disinstallazione dei programmi di installazione contenuti nella proprietà Installers.Occurs before the installers in the Installers property perform their uninstall operations.

(Ereditato da Installer)
Committed

Si verifica dopo l'esecuzione del commit delle installazioni di tutti i programmi di installazione contenuti nella proprietà Installers.Occurs after all the installers in the Installers property have committed their installations.

(Ereditato da Installer)
Committing

Si verifica prima dell'esecuzione del commit delle installazioni dei programmi di installazione contenuti nella proprietà Installers.Occurs before the installers in the Installers property commit their installations.

(Ereditato da Installer)
Disposed

Si verifica quando il componente viene eliminato da una chiamata al metodo Dispose().Occurs when the component is disposed by a call to the Dispose() method.

(Ereditato da Component)

Si applica a