MessageQueueInstaller Classe

Définition

Espace de noms:

System.Messaging

Assembly:

System.Messaging.dll

Vous permet d’installer et de configurer une file d’attente dont votre application a besoin pour s’exécuter. Cette classe est appelée par l’utilitaire d’installation, par exemple, InstallUtil.exe, lors de l’installation d’un 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

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

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

Lors de la création d’une MessageQueueInstaller instance, vous pouvez éventuellement passer un serveur de test 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 de l’instance MessageQueueInstaller sur les états souhaités et appeler le constructeur sans paramètre.

Lorsque l’utilitaire d’installation est appelé, il recherche le RunInstallerAttribute. Si c’est truele cas, l’utilitaire installe toutes les files d’attente dans la Installers collection associée au programme d’installation de votre projet. Si RunInstallerAttribute c’est falsele cas, l’utilitaire ignore le programme d’installation du projet.

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

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

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

Constructeurs

Nom	Description
MessageQueueInstaller()	Initialise une nouvelle instance de la classe MessageQueueInstaller. Ne définit aucune propriété d’instance.
MessageQueueInstaller(MessageQueue)	Initialise une nouvelle instance de la MessageQueueInstaller classe, initialisant les paramètres d’installation sur ceux d’une instance existante MessageQueue .

Propriétés

Nom	Description
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 router les messages d’une file d’attente publique sur le réseau.
CanRaiseEvents	Obtient une valeur indiquant si le composant peut déclencher un événement. (Hérité de Component)
Category	Obtient ou définit un type de file d’attente spécifique à l’implémentation.
Container	Obtient le IContainer fichier qui contient le Component. (Hérité de Component)
Context	Obtient ou définit des informations sur l’installation actuelle. (Hérité de Installer)
DesignMode	Obtient une valeur qui indique si la Component valeur est actuellement en mode création. (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 qui sont attachés à ce Component. (Hérité de Component)
HelpText	Obtient le texte d’aide de tous les programmes d’installation de la collection d’programmes d’installation. (Hérité de Installer)
Installers	Obtient la collection de programmes d’installation que contient 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	Introduit dans MSMQ 3.0. Obtient ou définit l’adresse de multidiffusion 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 des 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 ce que fait le programme d’installation avec la file d’attente au moment de la désinstallation : supprimez-la, restaurez-la à son état de préinstallation ou laissez-la dans son état d’installation actuel.
UseJournalQueue	Obtient ou définit une valeur qui indique si les messages récupérés à partir de la file d’attente sont également copiés dans la file d’attente de journal associée.

Méthodes

Nom	Description
Commit(IDictionary)	Termine le processus d’installation en validant les MessageQueue informations d’installation que la Install(IDictionary) méthode a écrites 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.
CopyFromComponent(IComponent)	Copie les valeurs de propriété d’un MessageQueue composant requis au moment de l’installation pour une file d’attente de messages.
CreateObjRef(Type)	Crée un objet qui contient toutes les informations pertinentes requises pour générer un proxy utilisé pour communiquer avec un objet distant. (Hérité de MarshalByRefObject)
Dispose()	Libère toutes les ressources utilisées par le Component. (Hérité de Component)
Dispose(Boolean)	Libère les ressources non managées utilisées par les Component ressources gérées 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()	Sert de fonction de hachage par défaut. (Hérité de Object)
GetLifetimeService()	Récupère l’objet de service de durée de vie actuel 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 le Component ou par son Container. (Hérité de Component)
GetType()	Obtient la 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)	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.
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 Objectactuel. (Hérité de Object)
MemberwiseClone(Boolean)	Crée une copie superficielle de l’objet actuel MarshalByRefObject . (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’ordinateur à l’état dans lequel il était avant l’installation, en rétablissant les informations de file d’attente que la procédure d’installation a écrites 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.
ToString()	Retourne un String nom contenant le nom du Component, le cas échéant. Cette méthode ne doit pas être remplacée. (Hérité de Component)
Uninstall(IDictionary)	Supprime une installation en supprimant les informations de file d’attente du Registre. Cette méthode est destinée à être utilisée par les outils de désinstallation, qui appellent automatiquement les méthodes appropriées.

Événements

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

Voir aussi

• Installutil.exe (outil programme d’installation)