AssemblyInstaller Classe

Definizione

Carica un assembly ed esegue tutti i programmi di installazione in esso contenuti.

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à

Esempio

Nell'esempio seguente viene creato un oggetto AssemblyInstaller richiamando il AssemblyInstaller costruttore . Le proprietà di questo oggetto vengono impostate e i Install metodi e Commit vengono chiamati per installare l'assembly MyAssembly.exe .

#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

Costruttori

Nome Descrizione
AssemblyInstaller()

Inizializza una nuova istanza della classe AssemblyInstaller.

AssemblyInstaller(Assembly, String[])

Inizializza una nuova istanza della AssemblyInstaller classe e specifica sia l'assembly da installare che la riga di comando da utilizzare durante la creazione di un nuovo InstallContext oggetto.

AssemblyInstaller(String, String[])

Inizializza una nuova istanza della AssemblyInstaller classe e specifica sia il nome file dell'assembly da installare che la riga di comando da utilizzare durante la creazione di un nuovo InstallContext oggetto per l'installazione dell'assembly.

Proprietà

Nome Descrizione
Assembly

Ottiene o imposta l'assembly da installare.

CanRaiseEvents

Ottiene un valore che indica se il componente può generare un evento.

(Ereditato da Component)
CommandLine

Ottiene o imposta la riga di comando da utilizzare durante la creazione di un nuovo InstallContext oggetto per l'installazione dell'assembly.

Container

Ottiene il IContainer che contiene il Component.

(Ereditato da Component)
Context

Ottiene o imposta informazioni sull'installazione corrente.

(Ereditato da Installer)
DesignMode

Ottiene un valore che indica se la Component è attualmente in modalità progettazione.

(Ereditato da Component)
Events

Ottiene l'elenco dei gestori eventi associati a questo Component.

(Ereditato da Component)
HelpText

Ottiene il testo della Guida per tutti i programmi di installazione nella raccolta del programma di installazione.

Installers

Ottiene la raccolta di programmi di installazione contenuti nel programma di installazione.

(Ereditato da Installer)
Parent

Ottiene o imposta il programma di installazione contenente la raccolta a cui appartiene il programma di installazione.

(Ereditato da Installer)
Path

Ottiene o imposta il percorso dell'assembly da installare.

Site

Ottiene o imposta il ISite del Component.

(Ereditato da Component)
UseNewContext

Ottiene o imposta un valore che indica se creare un nuovo InstallContext oggetto per l'installazione dell'assembly.

Metodi

Nome Descrizione
CheckIfInstallable(String)

Verifica se è possibile installare l'assembly specificato.

Commit(IDictionary)

Completa la transazione di installazione.

CreateObjRef(Type)

Crea un oggetto che contiene tutte le informazioni pertinenti necessarie per generare un proxy utilizzato per comunicare con un oggetto remoto.

(Ereditato da MarshalByRefObject)
Dispose()

Rilascia tutte le risorse usate da Component.

(Ereditato da Component)
Dispose(Boolean)

Rilascia le risorse non gestite usate da Component e, facoltativamente, rilascia le risorse gestite.

(Ereditato da Component)
Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.

(Ereditato da Object)
GetHashCode()

Funge da funzione hash predefinita.

(Ereditato da Object)
GetLifetimeService()
Obsoleti.

Recupera l'oggetto servizio di durata corrente che controlla i criteri di durata per questa istanza.

(Ereditato da MarshalByRefObject)
GetService(Type)

Restituisce un oggetto che rappresenta un servizio fornito dal Component o dal relativo Container.

(Ereditato da Component)
GetType()

Ottiene il Type dell'istanza corrente.

(Ereditato da Object)
InitializeLifetimeService()
Obsoleti.

Ottiene un oggetto servizio di durata per controllare i criteri di durata per questa istanza.

(Ereditato da MarshalByRefObject)
Install(IDictionary)

Esegue l'installazione.

MemberwiseClone()

Crea una copia superficiale del Objectcorrente.

(Ereditato da Object)
MemberwiseClone(Boolean)

Crea una copia superficiale dell'oggetto corrente MarshalByRefObject .

(Ereditato da MarshalByRefObject)
OnAfterInstall(IDictionary)

Genera l'evento AfterInstall.

(Ereditato da Installer)
OnAfterRollback(IDictionary)

Genera l'evento AfterRollback.

(Ereditato da Installer)
OnAfterUninstall(IDictionary)

Genera l'evento AfterUninstall.

(Ereditato da Installer)
OnBeforeInstall(IDictionary)

Genera l'evento BeforeInstall.

(Ereditato da Installer)
OnBeforeRollback(IDictionary)

Genera l'evento BeforeRollback.

(Ereditato da Installer)
OnBeforeUninstall(IDictionary)

Genera l'evento BeforeUninstall.

(Ereditato da Installer)
OnCommitted(IDictionary)

Genera l'evento Committed.

(Ereditato da Installer)
OnCommitting(IDictionary)

Genera l'evento Committing.

(Ereditato da Installer)
Rollback(IDictionary)

Ripristina lo stato del computer in cui si trovava prima dell'installazione.

ToString()

Restituisce un oggetto String contenente il nome dell'oggetto Component, se presente. Questo metodo non deve essere sottoposto a override.

(Ereditato da Component)
Uninstall(IDictionary)

Rimuove un'installazione.

Eventi

Nome Descrizione
AfterInstall

Si verifica dopo l'esecuzione Install(IDictionary) dei metodi di tutti i programmi di installazione nella Installers proprietà .

(Ereditato da Installer)
AfterRollback

Si verifica dopo il rollback delle installazioni di tutti i programmi di installazione nella Installers proprietà .

(Ereditato da Installer)
AfterUninstall

Si verifica dopo che tutti i programmi di installazione nella Installers proprietà eseguono le operazioni di disinstallazione.

(Ereditato da Installer)
BeforeInstall

Si verifica prima dell'esecuzione Install(IDictionary) del metodo di ogni programma di installazione nella raccolta del programma di installazione.

(Ereditato da Installer)
BeforeRollback

Si verifica prima del rollback dei programmi di installazione nella Installers proprietà .

(Ereditato da Installer)
BeforeUninstall

Si verifica prima che i programmi di installazione nella Installers proprietà eseguano le operazioni di disinstallazione.

(Ereditato da Installer)
Committed

Si verifica dopo che tutti i programmi di installazione nella proprietà hanno eseguito il Installers commit delle installazioni.

(Ereditato da Installer)
Committing

Si verifica prima che i programmi di installazione nella proprietà eseseguono il commit delle Installers installazioni.

(Ereditato da Installer)
Disposed

Si verifica quando il componente viene eliminato da una chiamata al metodo Dispose().

(Ereditato da Component)

Si applica a