AssemblyInstaller Classe

Référence

Définition

Espace de noms:: System.Configuration.Install

Assembly:: System.Configuration.Install.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Charge un assembly et exécute tous les programmes d'installation qu'il contient.

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

Héritage: Object

MarshalByRefObject

Component

Installer
AssemblyInstaller

Exemples

Dans l’exemple suivant, un AssemblyInstaller est créé en appelant le AssemblyInstaller constructeur. Les propriétés de cet objet sont définies et les Install méthodes et Commit sont appelées pour installer 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

Constructeurs

AssemblyInstaller()	Initialise une nouvelle instance de la classe AssemblyInstaller.
AssemblyInstaller(Assembly, String[])	Initialise une nouvelle instance de la classe AssemblyInstaller et spécifie l'assembly à installer, ainsi que la ligne de commande à utiliser lors de la création d'un nouvel objet InstallContext.
AssemblyInstaller(String, String[])	Initialise une nouvelle instance de la classe AssemblyInstaller et spécifie le nom de fichier de l'assembly à installer, ainsi que la ligne de commande à utiliser lors de la création d'un nouvel objet InstallContext pour l'installation de l'assembly.

Propriétés

Assembly	Obtient ou définit l'assembly à installer.
CanRaiseEvents	Obtient une valeur qui indique si le composant peut déclencher un événement. (Hérité de Component)
CommandLine	Obtient ou définit la ligne de commande à utiliser lors de la création d'un nouvel objet InstallContext pour l'installation de l'assembly.
Container	Obtient le IContainer qui contient la Component. (Hérité de Component)
Context	Obtient ou définit des informations sur l'installation en cours. (Hérité de Installer)
DesignMode	Obtient une valeur qui indique si Component est actuellement en mode design. (Hérité de Component)
Events	Obtient la liste des gestionnaires d'événements attachés à ce Component. (Hérité de Component)
HelpText	Obtient le texte d’aide pour tous les programmes d’installation de la collection de programmes d’installation.
Installers	Obtient la collection de programmes d’installation contenue dans ce programme d’installation. (Hérité de Installer)
Parent	Obtient ou définit le programme d'installation contenant la collection à laquelle appartient ce programme d'installation. (Hérité de Installer)
Path	Obtient ou définit le chemin d'accès de l'assembly à installer.
Site	Obtient ou définit le ISite de Component. (Hérité de Component)
UseNewContext	Obtient ou définit une valeur indiquant si un nouvel objet InstallContext doit être créé pour l'installation de l'assembly.

Méthodes

CheckIfInstallable(String)	Vérifie si l'assembly spécifié peut être installé.
Commit(IDictionary)	Termine la transaction d'installation.
CreateObjRef(Type)	Crée un objet contenant toutes les informations appropriées requises pour générer un proxy permettant de communiquer avec un objet distant. (Hérité de MarshalByRefObject)
Dispose()	Libère toutes les ressources utilisées par Component. (Hérité de Component)
Dispose(Boolean)	Libère les ressources non managées utilisées par Component et libère éventuellement les ressources managées. (Hérité de Component)
Equals(Object)	Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object)
GetHashCode()	Fait office de fonction de hachage par défaut. (Hérité de Object)
GetLifetimeService()	Obsolète. Récupère l'objet de service de durée de vie en cours qui contrôle la stratégie de durée de vie de cette instance. (Hérité de MarshalByRefObject)
GetService(Type)	Retourne un objet qui représente un service fourni par Component ou par son Container. (Hérité de Component)
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
InitializeLifetimeService()	Obsolète. Obtient un objet de service de durée de vie pour contrôler la stratégie de durée de vie de cette instance. (Hérité de MarshalByRefObject)
Install(IDictionary)	Effectue l'installation.
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
MemberwiseClone(Boolean)	Crée une copie superficielle de l'objet MarshalByRefObject actuel. (Hérité de MarshalByRefObject)
OnAfterInstall(IDictionary)	Déclenche l’événement AfterInstall. (Hérité de Installer)
OnAfterRollback(IDictionary)	Déclenche l’événement AfterRollback. (Hérité de Installer)
OnAfterUninstall(IDictionary)	Déclenche l’événement AfterUninstall. (Hérité de Installer)
OnBeforeInstall(IDictionary)	Déclenche l’événement BeforeInstall. (Hérité de Installer)
OnBeforeRollback(IDictionary)	Déclenche l’événement BeforeRollback. (Hérité de Installer)
OnBeforeUninstall(IDictionary)	Déclenche l’événement BeforeUninstall. (Hérité de Installer)
OnCommitted(IDictionary)	Déclenche l’événement Committed. (Hérité de Installer)
OnCommitting(IDictionary)	Déclenche l’événement Committing. (Hérité de Installer)
Rollback(IDictionary)	Restaure l'état qui était celui de l'ordinateur avant l'installation.
ToString()	Retourne un String contenant le nom du Component, s’il en existe un. Cette méthode ne doit pas être remplacée. (Hérité de Component)
Uninstall(IDictionary)	Supprime une installation.

Événements

AfterInstall	Se produit après l'exécution des méthodes Install(IDictionary) de tous les programmes d'installation de la propriété Installers. (Hérité de Installer)
AfterRollback	Se produit après la restauration des installations de tous les programmes d'installation de la propriété Installers. (Hérité de Installer)
AfterUninstall	Se produit une fois que tous les programmes d'installation de la propriété Installers ont effectué leurs propres opérations de désinstallation. (Hérité de Installer)
BeforeInstall	Se produit avant l’exécution de la méthode Install(IDictionary) de chaque programme d’installation contenu dans la collection de programmes d’installation. (Hérité de Installer)
BeforeRollback	Se produit avant la restauration des programmes d'installation de la propriété Installers. (Hérité de Installer)
BeforeUninstall	Se produit avant que les programmes d'installation de la propriété Installers aient effectué leurs propres opérations de désinstallation. (Hérité de Installer)
Committed	Se produit après la validation de l'installation de tous les programmes d'installation de la propriété Installers. (Hérité de Installer)
Committing	Se produit avant la validation de l’installation des programmes d’installation de la propriété Installers. (Hérité de Installer)
Disposed	Se produit lorsque le composant est supprimé par un appel à la méthode Dispose(). (Hérité de Component)

S’applique à