MessageQueueInstaller Classe

Définition

Espace de noms:

System.Messaging

Assembly:

System.Messaging.dll

Vous permet d'installer et de configurer une file d'attente nécessaire à l'exécution de votre application. Cette classe est appelée par l'utilitaire d'installation, par exemple InstallUtil.exe, lors de l'installation de MessageQueue.

public ref class MessageQueueInstaller : System::Configuration::Install::ComponentInstaller

public class MessageQueueInstaller : System.Configuration.Install.ComponentInstaller

type MessageQueueInstaller = class
    inherit ComponentInstaller

Public Class MessageQueueInstaller
Inherits ComponentInstaller

Héritage

Object

MarshalByRefObject

Component

Installer

ComponentInstaller

MessageQueueInstaller

Remarques

le est utilisé par l’utilitaire d’installation pour écrire les MessageQueueInstaller valeurs de Registre associées à la file d’attente. Pour plus d’informations sur les utilitaires d’installation, consultez Installutil.exe (Outil d’installation).

Pour installer une file d’attente, créez une classe de programme d’installation de projet qui hérite de Installeret définissez pour RunInstallerAttribute la classe truesur . Dans votre projet, créez une MessageQueueInstaller instance pour chaque file d’attente de l’installation et ajoutez le instance à votre classe d’installation de projet.

Lors de la création d’un MessageQueueInstaller instance, vous pouvez éventuellement passer un existant MessageQueue (par exemple, à partir d’un serveur de test) au MessageQueueInstaller constructeur. Cette approche fournit automatiquement les paramètres de configuration de la nouvelle file d’attente en mettant en miroir les paramètres de la file d’attente passée. Vous pouvez également définir manuellement les propriétés dans le MessageQueueInstaller instance sur les états souhaités et appeler le constructeur sans paramètre.

Lorsque l’utilitaire d’installation est appelé, il recherche le RunInstallerAttribute. S’il s’agit truede , l’utilitaire installe toutes les files d’attente dans le Installers regroupement associé au programme d’installation de votre projet. Si RunInstallerAttribute a la valeur false, l’utilitaire ignore le programme d’installation du projet.

Vous modifiez d’autres propriétés d’un MessageQueueInstaller instance avant ou après l’ajout du instance à la Installers collection du programme d’installation de votre projet. Par exemple, une file d’attente Path doit être définie avant l’exécution de l’utilitaire d’installation.

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 et appelle Commit si l’installation ne lève pas d’exception. Il sauvegarde les échecs, si nécessaire, en appelant Rollback pour l’objet qui a généré l’exception.

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 sont mises à jour en permanence à mesure que chaque MessageQueueInstaller instance est installé par l’utilitaire. Il n’est généralement pas nécessaire que votre code modifie explicitement les informations d’état.

Constructeurs

MessageQueueInstaller()	Initialise une nouvelle instance de la classe MessageQueueInstaller. Ne définit aucune propriété de l'instance.
MessageQueueInstaller(MessageQueue)	Initialise une nouvelle instance de la classe MessageQueueInstaller en affectant aux paramètres de l'installation les valeurs d'une instance de MessageQueue existante.

Propriétés

Authenticate	Obtient ou définit une valeur qui indique si la file d'attente à installer accepte uniquement les messages authentifiés.
BasePriority	Obtient ou définit la priorité de base utilisée pour acheminer les messages d'une file d'attente publique sur le réseau.
CanRaiseEvents	Obtient une valeur qui indique si le composant peut déclencher un événement. (Hérité de Component)
Category	Obtient ou définit un type de file d'attente propre à l'implémentation.
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)
EncryptionRequired	Obtient ou définit une valeur qui indique si la file d'attente accepte uniquement les messages privés ou chiffrés.
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. (Hérité de Installer)
Installers	Obtient la collection de programmes d’installation contenue dans ce programme d’installation. (Hérité de Installer)
Label	Obtient ou définit une description de la file d'attente.
MaximumJournalSize	Obtient ou définit la taille maximale du journal associé à la file d'attente.
MaximumQueueSize	Obtient ou définit la taille maximale de la file d'attente.
MulticastAddress	Présentation dans MSMQ 3.0. Obtient ou définit l'adresse multicast associée à la file d'attente.
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 l'emplacement de la file d'attente référencée par cet objet.
Permissions	Obtient ou définit les autorisations associées à la file d'attente.
Site	Obtient ou définit le ISite de Component. (Hérité de Component)
Transactional	Obtient ou définit une valeur qui indique si la file d'attente accepte uniquement les messages envoyés dans le cadre d'une transaction.
UninstallAction	Obtient ou définit une valeur qui indique le sort réservé à la file d'attente par le programme d'installation au moment de la désinstallation. Il peut la supprimer, la restaurer dans l'état qui était le sien avant l'installation ou la laisser dans son état actuel.
UseJournalQueue	Obtient ou définit une valeur qui indique si les messages récupérés de la file d'attente sont également copiés dans le journal de file d'attente associé.

Méthodes

Commit(IDictionary)	Termine le processus d'installation en validant les informations d'installation MessageQueue écrites par la méthode Install(IDictionary) dans le Registre. Cette méthode est prévue pour être utilisée par des outils d'installation qui appellent automatiquement les méthodes appropriées.
CopyFromComponent(IComponent)	Copie les valeurs des propriétés d'un composant MessageQueue requis lors de l'installation d'une file d'attente de messages.
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()	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()	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)	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.
IsEquivalentInstaller(ComponentInstaller)	Détermine si le programme d'installation spécifié peut gérer le même type d'installation que ce programme d'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)	Rétablit l'état qui était celui de l'ordinateur avant l'installation, en restaurant les informations de la file d'attente écrites dans le Registre par la procédure d'installation. Cette méthode est prévue pour être utilisée par des outils d'installation qui appellent automatiquement les méthodes appropriées.
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 en effaçant du Registre les informations de la file d'attente. Cette méthode est prévue pour être utilisée par des outils de désinstallation qui appellent automatiquement les méthodes appropriées.

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

Voir aussi

• Installutil.exe (outil Installer)