MessageQueueInstaller Clase
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Permite instalar y configurar una cola que la aplicación necesita para poder ejecutarse. La utilidad de instalación, por ejemplo, InstallUtil.exe, llama a esta clase cuando se instala una MessageQueue.
public ref class MessageQueueInstaller : System::Configuration::Install::ComponentInstallerpublic class MessageQueueInstaller : System.Configuration.Install.ComponentInstallertype MessageQueueInstaller = class
inherit ComponentInstallerPublic Class MessageQueueInstaller
Inherits ComponentInstaller- Herencia
Comentarios
MessageQueueInstaller La utilidad de instalación usa para escribir valores del Registro asociados a la cola. Para obtener más información sobre las utilidades de instalación, vea Installutil.exe (Herramienta instalador).
Para instalar una cola, cree una clase de instalador de proyecto que herede de Installery establezca para RunInstallerAttribute la clase trueen . En el proyecto, cree una MessageQueueInstaller instancia para cada cola de la instalación y agregue la instancia a la clase del instalador del proyecto.
Al crear una MessageQueueInstaller instancia, puede pasar opcionalmente un existente MessageQueue (por ejemplo, desde un servidor de prueba) al MessageQueueInstaller constructor. Este enfoque proporciona automáticamente las opciones de configuración de la nueva cola mediante la creación de reflejo de la configuración de la cola pasada. Como alternativa, puede establecer manualmente las propiedades de la MessageQueueInstaller instancia en los estados que desee y llamar al constructor sin parámetros.
Cuando se llama a la utilidad de instalación, busca .RunInstallerAttribute Si es true, la utilidad instala todas las colas de la Installers colección asociada al instalador del proyecto. Si RunInstallerAttribute es false, la utilidad omite el instalador del proyecto.
Puede modificar otras propiedades de una MessageQueueInstaller instancia antes o después de agregar la instancia a la Installers colección del instalador del proyecto. Por ejemplo, se deben establecer las colas Path antes de que se ejecute la utilidad de instalación.
Normalmente, no se llama a los métodos del desde dentro del MessageQueueInstaller código; por lo general, la utilidad de instalación de installutil.exe los llama únicamente. La utilidad llama automáticamente al Install método durante el proceso de instalación y llama a Commit si la instalación no produjo una excepción. Devuelve errores, si es necesario, llamando Rollback al objeto que generó la excepción.
La rutina de instalación de una aplicación usa el instalador del Installer.Context proyecto para mantener automáticamente información sobre los componentes que ya se han instalado. Esta información de estado se actualiza continuamente a medida que la utilidad instala cada MessageQueueInstaller instancia. Normalmente, no es necesario que el código modifique explícitamente la información de estado.
Constructores
| MessageQueueInstaller() |
Inicializa una nueva instancia de la clase MessageQueueInstaller. No establece ninguna propiedad de la instancia. |
| MessageQueueInstaller(MessageQueue) |
Inicializa una nueva instancia de la clase MessageQueueInstaller, inicializando la configuración de instalación en la configuración de una instancia de MessageQueue existente. |
Propiedades
| Authenticate |
Obtiene o establece un valor que indica si la cola que se va a instalar acepta únicamente mensajes autenticados. |
| BasePriority |
Obtiene o establece la prioridad básica que se utiliza para distribuir los mensajes de una cola pública a través de la red. |
| CanRaiseEvents |
Obtiene un valor que indica si el componente puede generar un evento. (Heredado de Component) |
| Category |
Obtiene o establece un tipo de cola específico de la implementación. |
| Container |
Obtiene la interfaz IContainer que contiene la clase Component. (Heredado de Component) |
| Context |
Obtiene o establece información sobre la instalación actual. (Heredado de Installer) |
| DesignMode |
Obtiene un valor que indica si Component está actualmente en modo de diseño. (Heredado de Component) |
| EncryptionRequired |
Obtiene o establece un valor que indica si la cola acepta únicamente mensajes privados o cifrados. |
| Events |
Obtiene la lista de controladores de eventos asociados a Component. (Heredado de Component) |
| HelpText |
Obtiene el texto de ayuda de todos los instaladores que se encuentran en la colección de instaladores. (Heredado de Installer) |
| Installers |
Obtiene la colección de instaladores que contiene este instalador. (Heredado de Installer) |
| Label |
Obtiene o establece una descripción de la cola. |
| MaximumJournalSize |
Obtiene o establece el tamaño máximo del diario asociado a la cola. |
| MaximumQueueSize |
Obtiene o establece el tamaño máximo de la cola. |
| MulticastAddress |
Introducido en MSMQ 3.0. Obtiene o establece la dirección de multidifusión asociada a la cola. |
| Parent |
Obtiene o establece el instalador que contiene la colección a la que pertenece este instalador. (Heredado de Installer) |
| Path |
Obtiene o establece la ubicación de la cola a la que hace referencia el objeto. |
| Permissions |
Obtiene o establece los permisos asociados a la cola. |
| Site |
Obtiene o establece ISite de Component. (Heredado de Component) |
| Transactional |
Obtiene o establece un valor que indica si la cola acepta únicamente mensajes enviados como parte de una transacción. |
| UninstallAction |
Obtiene o establece un valor que indica lo que hará el instalador con la cola durante la desinstalación: quitarla, restaurarla al estado que tenía antes de la instalación o dejarla en su estado de instalación actual. |
| UseJournalQueue |
Obtiene o establece un valor que indica si los mensajes recuperados de la cola se copian también en la cola del diario asociada. |
Métodos
| Commit(IDictionary) |
Finaliza el proceso de instalación confirmando la información de instalación de MessageQueue que fue escrita en el Registro por el método Install(IDictionary). Este método está pensado para que lo utilicen las herramientas de instalación, que llaman automáticamente a los métodos adecuados. |
| CopyFromComponent(IComponent) |
Copias los valores de propiedad de un componente MessageQueue que son necesarios durante la instalación para una cola de mensajes. |
| CreateObjRef(Type) |
Crea un objeto que contiene toda la información relevante necesaria para generar un proxy utilizado para comunicarse con un objeto remoto. (Heredado de MarshalByRefObject) |
| Dispose() |
Libera todos los recursos que usa Component. (Heredado de Component) |
| Dispose(Boolean) |
Libera los recursos no administrados que usa Component y, de forma opcional, libera los recursos administrados. (Heredado de Component) |
| Equals(Object) |
Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object) |
| GetHashCode() |
Sirve como la función hash predeterminada. (Heredado de Object) |
| GetLifetimeService() |
Obsoletos.
Recupera el objeto de servicio de duración actual que controla la directiva de duración de esta instancia. (Heredado de MarshalByRefObject) |
| GetService(Type) |
Devuelve un objeto que representa el servicio suministrado por Component o por Container. (Heredado de Component) |
| GetType() |
Obtiene el Type de la instancia actual. (Heredado de Object) |
| InitializeLifetimeService() |
Obsoletos.
Obtiene un objeto de servicio de duración para controlar la directiva de duración de esta instancia. (Heredado de MarshalByRefObject) |
| Install(IDictionary) |
Realiza la instalación y escribe la información de la cola de mensajes en el Registro. Este método está pensado para que lo utilicen las herramientas de instalación, que llaman automáticamente a los métodos adecuados. |
| IsEquivalentInstaller(ComponentInstaller) |
Determina si el instalador especificado puede controlar el mismo tipo de instalación que este instalador. |
| MemberwiseClone() |
Crea una copia superficial del Object actual. (Heredado de Object) |
| MemberwiseClone(Boolean) |
Crea una copia superficial del objeto MarshalByRefObject actual. (Heredado de MarshalByRefObject) |
| OnAfterInstall(IDictionary) |
Genera el evento AfterInstall. (Heredado de Installer) |
| OnAfterRollback(IDictionary) |
Genera el evento AfterRollback. (Heredado de Installer) |
| OnAfterUninstall(IDictionary) |
Genera el evento AfterUninstall. (Heredado de Installer) |
| OnBeforeInstall(IDictionary) |
Genera el evento BeforeInstall. (Heredado de Installer) |
| OnBeforeRollback(IDictionary) |
Genera el evento BeforeRollback. (Heredado de Installer) |
| OnBeforeUninstall(IDictionary) |
Genera el evento BeforeUninstall. (Heredado de Installer) |
| OnCommitted(IDictionary) |
Genera el evento Committed. (Heredado de Installer) |
| OnCommitting(IDictionary) |
Genera el evento Committing. (Heredado de Installer) |
| Rollback(IDictionary) |
Restaura el estado que tenía el equipo antes de la instalación, deshaciendo la información de la cola que el procedimiento de instalación escribió en el Registro. Este método está pensado para que lo utilicen las herramientas de instalación, que llaman automáticamente a los métodos adecuados. |
| ToString() |
Devuelve una String que contiene el nombre del Component, si existe. Este método no se debe invalidar. (Heredado de Component) |
| Uninstall(IDictionary) |
Quita una instalación quitando la información de cola del Registro. Este método está pensado para que lo utilicen las herramientas de desinstalación, que llaman automáticamente a los métodos adecuados. |
Eventos
| AfterInstall |
Se produce después de ejecutarse los métodos Install(IDictionary) de todos los instaladores de la propiedad Installers. (Heredado de Installer) |
| AfterRollback |
Se produce después de deshacerse la instalación de todos los instaladores de la propiedad Installers. (Heredado de Installer) |
| AfterUninstall |
Se produce después de que todos los instaladores de la propiedad Installers realicen sus operaciones de desinstalación. (Heredado de Installer) |
| BeforeInstall |
Se produce antes de ejecutarse el método Install(IDictionary) de cada instalador en la colección de instaladores. (Heredado de Installer) |
| BeforeRollback |
Se produce antes de deshacerse los instaladores de la propiedad Installers. (Heredado de Installer) |
| BeforeUninstall |
Se produce antes de que los instaladores de la propiedad Installers realicen sus operaciones de desinstalación. (Heredado de Installer) |
| Committed |
Se produce después de que todos los instaladores de la propiedad Installers confirmen sus instalaciones. (Heredado de Installer) |
| Committing |
Se produce antes de que los instaladores de la propiedad Installers confirmen sus instalaciones. (Heredado de Installer) |
| Disposed |
Tiene lugar cuando una llamada elimina el componente mediante una llamada al método Dispose(). (Heredado de Component) |
