MessageQueueInstaller.Install(IDictionary) Méthode
Définition
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.
Effectue l’installation et écrit les informations de file d’attente des messages dans le Registre. Cette méthode est destinée à être utilisée par les outils d’installation, qui appellent automatiquement les méthodes appropriées.
public:
override void Install(System::Collections::IDictionary ^ stateSaver);public override void Install(System.Collections.IDictionary stateSaver);override this.Install : System.Collections.IDictionary -> unitPublic Overrides Sub Install (stateSaver As IDictionary)Paramètres
- stateSaver
- IDictionary
Utilisé IDictionary pour enregistrer les informations nécessaires à l’exécution d’une opération de validation, de restauration ou de désinstallation.
Remarques
La Install méthode écrit des informations de file d’attente de messages dans le Registre et associe l’instance MessageQueue à une file d’attente située sur le chemin spécifié par la Path propriété. Si la file d’attente n’existe pas encore, Install crée une file d’attente transactionnelle. Install définit les propriétés de file d’attente nouvelles ou existantes sur celles que vous avez spécifiées dans le MessageQueueInstaller. Si la file d’attente existe déjà, ses propriétés sont réinitialisées à celles de la MessageQueueInstallerfile d’attente . Si la file d’attente existante n’est pas transactionnelle, elle est supprimée, puis recréée en tant que file d’attente transactionnelle.
Avertissement
S’il est nécessaire de recréer la file d’attente, les messages de la file d’attente sont perdus.
En règle générale, vous n’appelez pas les méthodes de votre MessageQueueInstaller code ; elles sont généralement appelées uniquement par l’utilitaire d’installation installutil.exe. L’utilitaire appelle automatiquement la Install méthode pendant le processus d’installation pour écrire des informations de Registre associées à la file d’attente de messages en cours d’installation. L’installation est transactionnelle. Par conséquent, en cas de défaillance d’un composant de projet d’installation pendant l’installation, tous les composants précédemment installés sont restaurés dans leurs états de préinstallation. Pour ce faire, appelez la méthode de Rollback chaque composant.
Une fois l’installation réussie de tous les composants associés au projet d’installation s’est produite, l’utilitaire d’installation valide les installations. Commit termine l’installation du fichier MessageQueue en définissant la file d’attente sur l’état initial approprié. Si la file d’attente spécifiée par la Path propriété existe déjà et contient des messages, Commit efface les messages. Commit, au lieu de Installeffacer les messages, car l’acte de purger les messages ne peut pas être restauré.
La routine d’installation d’une application utilise les programmes d’installation du Installer.Context projet pour conserver automatiquement des informations sur les composants qui ont déjà été installés. Ces informations d’état, qui sont transmises en tant que stateSaver paramètre, sont mises à Install jour en permanence lorsque l’utilitaire installe chaque MessageQueueInstaller instance. En règle générale, il n’est pas nécessaire que votre code modifie explicitement ces informations d’état.
