Partager via

MessageQueueInstaller.Install(IDictionary) Méthode

  • Référence

Définition

Espace de noms:
System.Messaging
Assembly:
System.Messaging.dll

Exécute l'installation et écrit dans le Registre des informations sur la file d'attente de messages. Cette méthode est prévue pour être utilisée par des 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 -> unit
Public Overrides Sub Install (stateSaver As IDictionary)

Paramètres

stateSaver
IDictionary

IDictionary utilisé 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 les informations de file d’attente des messages dans le Registre et associe le MessageQueue instance à une file d’attente qui se trouve au niveau du chemin spécifié par la Path propriété . Si la file d’attente n’existe pas déjà, 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 .MessageQueueInstaller Si la file d’attente existante n’est pas transactionnelle, elle est supprimée, puis recréée en tant que file d’attente transactionnelle.

Attention

S’il est nécessaire de recréer la file d’attente, les messages dans la file d’attente seront perdus.

En règle générale, vous n’appelez pas les méthodes du MessageQueueInstaller à partir de votre 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 les informations de Registre associées à la file d’attente des messages en cours d’installation. L’installation est transactionnelle. Par conséquent, en cas d’échec d’un composant de projet d’installation pendant l’installation, tous les composants précédemment installés sont restaurés à leur état de préinstallation. Pour ce faire, appelez la méthode de Rollback chaque composant.

Après l’installation réussie de tous les composants associés au projet d’installation, l’utilitaire d’installation valide les installations. Commit termine l’installation de en MessageQueue définissant la file d’attente à 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 Install, efface les messages, car l’acte de purge des messages ne peut pas être restauré.

La routine d’installation d’une application utilise le programme 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 à Install en tant que stateSaver paramètre, sont mises à jour en permanence à mesure que 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.

S’applique à

Voir aussi