Installer Classe
Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

Installer, classe

 

Fournit la base des installations personnalisées.

Espace de noms:   System.Configuration.Install
Assembly:  System.Configuration.Install (dans System.Configuration.Install.dll)


public class Installer : Component

NomDescription
System_CAPS_pubmethodInstaller()

Initialise une nouvelle instance de la classe Installer.

NomDescription
System_CAPS_protpropertyCanRaiseEvents

Obtient une valeur indiquant si le composant peut déclencher un événement.(Hérité de Component.)

System_CAPS_pubpropertyContainer

Obtient les IContainer qui contient la Component.(Hérité de Component.)

System_CAPS_pubpropertyContext

Obtient ou définit des informations sur l'installation en cours.

System_CAPS_protpropertyDesignMode

Obtient une valeur qui indique si la Component est actuellement en mode design.(Hérité de Component.)

System_CAPS_protpropertyEvents

Obtient la liste des gestionnaires d'événements associés à cette Component.(Hérité de Component.)

System_CAPS_pubpropertyHelpText

Obtient le texte d'aide pour tous les programmes d'installation de la collection de programmes d'installation.

System_CAPS_pubpropertyInstallers

Obtient la collection de programmes d'installation contenue dans ce programme d'installation.

System_CAPS_pubpropertyParent

Obtient ou définit le programme d'installation contenant la collection à laquelle appartient ce programme d'installation.

System_CAPS_pubpropertySite

Obtient ou définit le ISite de la Component.(Hérité de Component.)

NomDescription
System_CAPS_pubmethodCommit(IDictionary)

En cas de substitution dans une classe dérivée, termine la transaction d'installation.

System_CAPS_pubmethodCreateObjRef(Type)

Crée un objet qui contient toutes les informations requises pour générer un proxy permettant de communiquer avec un objet distant.(Hérité de MarshalByRefObject.)

System_CAPS_pubmethodDispose()

Libère toutes les ressources utilisées par Component.(Hérité de Component.)

System_CAPS_protmethodDispose(Boolean)

Libère les ressources non managées utilisées par Component et libère éventuellement les ressources managées.(Hérité de Component.)

System_CAPS_pubmethodEquals(Object)

Détermine si l'objet spécifié est identique à l'objet actuel.(Hérité de Object.)

System_CAPS_protmethodFinalize()

Libère les ressources non managées et exécute d'autres opérations de nettoyage avant la récupération du Component par le garbage collection.(Hérité de Component.)

System_CAPS_pubmethodGetHashCode()

Fait office de fonction de hachage par défaut.(Hérité de Object.)

System_CAPS_pubmethodGetLifetimeService()

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

System_CAPS_protmethodGetService(Type)

Retourne un objet qui représente un service fourni par Component ou par son Container.(Hérité de Component.)

System_CAPS_pubmethodGetType()

Obtient le Type de l'instance actuelle.(Hérité de Object.)

System_CAPS_pubmethodInitializeLifetimeService()

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

System_CAPS_pubmethodInstall(IDictionary)

En cas de substitution dans une classe dérivée, exécute l'installation.

System_CAPS_protmethodMemberwiseClone()

Crée une copie superficielle du Object actuel.(Hérité de Object.)

System_CAPS_protmethodMemberwiseClone(Boolean)

Crée une copie superficielle de l'utilisateur actuel MarshalByRefObject objet.(Hérité de MarshalByRefObject.)

System_CAPS_protmethodOnAfterInstall(IDictionary)

Déclenche l'événement AfterInstall.

System_CAPS_protmethodOnAfterRollback(IDictionary)

Déclenche l'événement AfterRollback.

System_CAPS_protmethodOnAfterUninstall(IDictionary)

Déclenche l'événement AfterUninstall.

System_CAPS_protmethodOnBeforeInstall(IDictionary)

Déclenche l'événement BeforeInstall.

System_CAPS_protmethodOnBeforeRollback(IDictionary)

Déclenche l'événement BeforeRollback.

System_CAPS_protmethodOnBeforeUninstall(IDictionary)

Déclenche l'événement BeforeUninstall.

System_CAPS_protmethodOnCommitted(IDictionary)

Déclenche l'événement Committed.

System_CAPS_protmethodOnCommitting(IDictionary)

Déclenche l'événement Committing.

System_CAPS_pubmethodRollback(IDictionary)

En cas de substitution dans une classe dérivée, restaure l'état de l'ordinateur préalable à l'installation.

System_CAPS_pubmethodToString()

Retourne un String contenant le nom de la Component, le cas échéant. Cette méthode ne doit pas être remplacée.(Hérité de Component.)

System_CAPS_pubmethodUninstall(IDictionary)

En cas de substitution dans une classe dérivée, supprime une installation.

NomDescription
System_CAPS_pubeventAfterInstall

Se produit après l'exécution des méthodes Install de tous les programmes d'installation de la propriété Installers.

System_CAPS_pubeventAfterRollback

Se produit après la restauration des installations de tous les programmes d'installation de la propriété Installers.

System_CAPS_pubeventAfterUninstall

Se produit une fois que tous les programmes d'installation de la propriété Installers ont effectué leurs propres opérations de désinstallation.

System_CAPS_pubeventBeforeInstall

Se produit avant l'exécution de la méthode Install de chaque programme d'installation contenu dans la collection de programmes d'installation.

System_CAPS_pubeventBeforeRollback

Se produit avant la restauration des programmes d'installation de la propriété Installers.

System_CAPS_pubeventBeforeUninstall

Se produit avant que les programmes d'installation de la propriété Installers aient effectué leurs propres opérations de désinstallation.

System_CAPS_pubeventCommitted

Se produit après la validation de l'installation de tous les programmes d'installation de la propriété Installers.

System_CAPS_pubeventCommitting

Se produit avant la validation de l'installation des programmes d'installation de la propriété Installers.

System_CAPS_pubeventDisposed

Se produit lorsque le composant est supprimé par un appel à la Dispose (méthode).(Hérité de Component.)

Il s'agit de la classe de base pour tous les programmes d'installation personnalisés du .NET Framework. Programmes d'installation sont des composants qui aident à installer des applications sur un ordinateur.

Il existe plusieurs étapes à suivre pour utiliser un Installer:

  • Hériter la Installer classe.

  • Remplacer le Install, Commit, Rollback, et Uninstall méthodes.

  • Ajouter le RunInstallerAttribute à votre dérivée de classe et la valeur true.

  • Placez votre classe dérivée dans l'assembly avec votre application à installer.

  • Appelez les programmes d'installation. Par exemple, utiliser InstallUtil.exe pour appeler les programmes d'installation.

Le Installers propriété contient une collection de programmes d'installation. Si cette instance de Installer fait partie d'une installation de la collection, le Parent est définie sur le Installer instance qui contient la collection. Pour obtenir un exemple d'utilisation de la Installers collection, consultez la AssemblyInstaller classe.

Le Install, Commit, Rollback, et Uninstall méthodes de la Installer classe passer par la collection de programmes d'installation stockées dans le Installers propriété et appelle la méthode correspondante de chaque programme d'installation.

Le Install, Commit, Rollback, et Uninstall méthodes ne sont pas toujours appelées sur le même Installer instance. Par exemple, une Installer instance peut-être être utilisée lors de l'installation et la validation d'une application, et ensuite la référence à cette instance est libérée. Plus tard, la désinstallation de l'application crée une référence à un nouveau Installer instance, ce qui signifie que la Uninstall méthode est appelée par une autre instance de Installer. Pour cette raison, dans votre classe dérivée, n'enregistrez pas l'état d'un ordinateur dans un programme d'installation. Utilisez plutôt un IDictionary qui sont conservée entre les appels et transmis à votre Install, Commit, Rollback, et Uninstall méthodes.

Deux situations illustrent la nécessité d'enregistrer les informations dans l'état de veille IDictionary. Tout d'abord, supposez que votre programme d'installation définit une clé de Registre. Il doit enregistrer la valeur de clé d'origine dans le IDictionary. Si l'installation est restaurée, la valeur d'origine peut être restaurée. Ensuite, supposons que le programme d'installation remplace un fichier existant. Enregistrez le fichier existant dans un répertoire temporaire et l'emplacement du nouvel emplacement du fichier dans le IDictionary. Si l'installation est restaurée, le fichier plus récent soit supprimé et remplacé par l'original de l'emplacement temporaire.

Le Installer.Context propriété contient des informations sur l'installation. Par exemple, les informations sur l'emplacement du fichier journal pour l'installation, l'emplacement du fichier pour enregistrer les informations requises par le Uninstall (méthode) et la ligne de commande qui a été entrée lors de l'exécution de l'exécutable d'installation.

L'exemple suivant illustre l'utilisation de la Installer classe. Il crée une classe qui hérite de Installer. Lorsque Commit est sur le point d'effectuer, Committing événement se produit et un message s'affiche. Pour utiliser le Installer (classe), vous devez référencer le System.Configuration.Install assembly dans votre projet.

using System;
using System.Collections;
using System.ComponentModel;
using System.Configuration.Install;

// Set 'RunInstaller' attribute to true.
[RunInstaller(true)]
public class MyInstallerClass: Installer
{
   public MyInstallerClass() :base()
   {
      // Attach the 'Committed' event.
      this.Committed += new InstallEventHandler(MyInstaller_Committed);
      // Attach the 'Committing' event.
      this.Committing += new InstallEventHandler(MyInstaller_Committing);

   }
   // Event handler for 'Committing' event.
   private void MyInstaller_Committing(object sender, InstallEventArgs e)
   {
      Console.WriteLine("");
      Console.WriteLine("Committing Event occured.");
      Console.WriteLine("");
   }
   // Event handler for 'Committed' event.
   private void MyInstaller_Committed(object sender, InstallEventArgs e)
   {
      Console.WriteLine("");
      Console.WriteLine("Committed Event occured.");
      Console.WriteLine("");
   }
   // Override the 'Install' method.
   public override void Install(IDictionary savedState)
   {
      base.Install(savedState);
   }
   // Override the 'Commit' method.
   public override void Commit(IDictionary savedState)
   {
      base.Commit(savedState);
   }
   // Override the 'Rollback' method.
   public override void Rollback(IDictionary savedState)
   {
      base.Rollback(savedState);
   }
   public static void Main()
   {
      Console.WriteLine("Usage : installutil.exe Installer.exe ");
   }
}

.NET Framework
Disponible depuis 1.1

Tous les membres statiques (Shared en Visual Basic) publics de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.

Retour au début
Afficher:
© 2016 Microsoft