MessageQueueInstaller Clase

Definición

Espacio de nombres:

System.Messaging

Ensamblado:

System.Messaging.dll

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::ComponentInstaller

public class MessageQueueInstaller : System.Configuration.Install.ComponentInstaller

type MessageQueueInstaller = class
    inherit ComponentInstaller

Public Class MessageQueueInstaller
Inherits ComponentInstaller

Herencia

Object

MarshalByRefObject

Component

Installer

ComponentInstaller

MessageQueueInstaller

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

Consulte también

• Installutil.exe (Herramienta Installer)