Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

Clase MessageQueueInstaller

 

Publicado: octubre de 2016

Permite instalar y configurar una cola que la aplicación necesita para ejecutarse. Esta clase se llama por la utilidad de instalación, por ejemplo, InstallUtil.exe, al instalar un MessageQueue.

Espacio de nombres:   System.Messaging
Ensamblado:  System.Messaging (en System.Messaging.dll)

System.Object
  System.MarshalByRefObject
    System.ComponentModel.Component
      System.Configuration.Install.Installer
        System.Configuration.Install.ComponentInstaller
          System.Messaging.MessageQueueInstaller

public class MessageQueueInstaller : ComponentInstaller

NombreDescripción
System_CAPS_pubmethodMessageQueueInstaller()

Inicializa una nueva instancia de la clase MessageQueueInstaller. No establece las propiedades de instancia.

System_CAPS_pubmethodMessageQueueInstaller(MessageQueue)

Inicializa una nueva instancia de la MessageQueueInstaller clase, inicializando la configuración de instalación en la configuración de un miembro de MessageQueue instancia.

NombreDescripción
System_CAPS_pubpropertyAuthenticate

Obtiene o establece un valor que indica si la cola para instalarse acepta sólo mensajes autenticados.

System_CAPS_pubpropertyBasePriority

Obtiene o establece la prioridad básica que se utiliza para enrutar mensajes de una cola pública a través de la red.

System_CAPS_protpropertyCanRaiseEvents

Obtiene un valor que indica si el componente puede provocar un evento.(Heredado de Component).

System_CAPS_pubpropertyCategory

Obtiene o establece un tipo de cola específico de la implementación.

System_CAPS_pubpropertyContainer

Obtiene IContainer que contiene Component.(Heredado de Component).

System_CAPS_pubpropertyContext

Obtiene o establece información sobre la instalación actual.(Heredado de Installer).

System_CAPS_protpropertyDesignMode

Obtiene un valor que indica si la Component está actualmente en modo de diseño.(Heredado de Component).

System_CAPS_pubpropertyEncryptionRequired

Obtiene o establece un valor que indica si la cola acepta mensajes sólo privados o cifrados.

System_CAPS_protpropertyEvents

Obtiene la lista de controladores de eventos que se adjuntará a este Component.(Heredado de Component).

System_CAPS_pubpropertyHelpText

Obtiene el texto de ayuda de todos los instaladores que se encuentran en la colección de instaladores.(Heredado de Installer).

System_CAPS_pubpropertyInstallers

Obtiene la colección de instaladores que contiene este instalador.(Heredado de Installer).

System_CAPS_pubpropertyLabel

Obtiene o establece una descripción de la cola.

System_CAPS_pubpropertyMaximumJournalSize

Obtiene o establece el tamaño máximo del diario asociado a la cola.

System_CAPS_pubpropertyMaximumQueueSize

Obtiene o establece el tamaño máximo de la cola.

System_CAPS_pubpropertyMulticastAddress

Introducido en MSMQ 3.0. Obtiene o establece la dirección de multidifusión asociada a la cola.

System_CAPS_pubpropertyParent

Obtiene o establece el instalador que contiene la colección a la que pertenece este instalador.(Heredado de Installer).

System_CAPS_pubpropertyPath

Obtiene o establece la ubicación de la cola a la que hace referencia este objeto.

System_CAPS_pubpropertyPermissions

Obtiene o establece los permisos asociados a la cola.

System_CAPS_pubpropertySite

Obtiene o establece la ISite de la Component.(Heredado de Component).

System_CAPS_pubpropertyTransactional

Obtiene o establece un valor que indica si la cola acepta únicamente mensajes enviados como parte de una transacción.

System_CAPS_pubpropertyUninstallAction

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 actual de la instalación.

System_CAPS_pubpropertyUseJournalQueue

Obtiene o establece un valor que indica si los mensajes que se recuperan de la cola también se copian a la cola del diario asociada.

NombreDescripción
System_CAPS_pubmethodCommit(IDictionary)

Completa el proceso de instalación confirmando la MessageQueue información de instalación que la Install método escribió en el registro. Este método está pensado para usarse con las herramientas de instalación, que llaman automáticamente a los métodos adecuados.(Invalida Installer.Commit(IDictionary)).

System_CAPS_pubmethodCopyFromComponent(IComponent)

Copia los valores de propiedad de un MessageQueue los componentes que son necesarios durante la instalación para una cola de mensajes.(Invalida ComponentInstaller.CopyFromComponent(IComponent)).

System_CAPS_pubmethodCreateObjRef(Type)

Crea un objeto que contiene toda la información pertinente necesaria para generar a un proxy utilizado para comunicarse con un objeto remoto.(Heredado de MarshalByRefObject).

System_CAPS_pubmethodDispose()

Libera todos los recursos que usa Component.(Heredado de Component).

System_CAPS_protmethodDispose(Boolean)

Libera los recursos no administrados que usa Component y libera los recursos administrados de forma opcional.(Heredado de Component).

System_CAPS_pubmethodEquals(Object)

Determina si el objeto especificado es igual al objeto actual.(Heredado de Object).

System_CAPS_protmethodFinalize()

Libera recursos no administrados y realiza otras operaciones de limpieza antes de que se reclame el elemento Component durante la recolección de elementos no usados.(Heredado de Component).

System_CAPS_pubmethodGetHashCode()

Sirve como la función hash predeterminada.(Heredado de Object).

System_CAPS_pubmethodGetLifetimeService()

Recupera el objeto de servicio de duración actual que controla la directiva de duración de esta instancia.(Heredado de MarshalByRefObject).

System_CAPS_protmethodGetService(Type)

Devuelve un objeto que representa el servicio suministrado por Component o por Container.(Heredado de Component).

System_CAPS_pubmethodGetType()

Obtiene el Type de la instancia actual.(Heredado de Object).

System_CAPS_pubmethodInitializeLifetimeService()

Obtiene un objeto de servicio de duración para controlar la directiva de duración de esta instancia.(Heredado de MarshalByRefObject).

System_CAPS_pubmethodInstall(IDictionary)

Realiza la instalación y escribe la información de la cola de mensajes en el registro. Este método está pensado para usarse con las herramientas de instalación, que llaman automáticamente a los métodos adecuados.(Invalida Installer.Install(IDictionary)).

System_CAPS_pubmethodIsEquivalentInstaller(ComponentInstaller)

Determina si el instalador especificado puede controlar el mismo tipo de instalación que este instalador.(Invalida ComponentInstaller.IsEquivalentInstaller(ComponentInstaller)).

System_CAPS_protmethodMemberwiseClone()

Crea una copia superficial del Object actual.(Heredado de Object).

System_CAPS_protmethodMemberwiseClone(Boolean)

Crea una copia superficial del actual MarshalByRefObject objeto.(Heredado de MarshalByRefObject).

System_CAPS_protmethodOnAfterInstall(IDictionary)

Genera el evento AfterInstall.(Heredado de Installer).

System_CAPS_protmethodOnAfterRollback(IDictionary)

Genera el evento AfterRollback.(Heredado de Installer).

System_CAPS_protmethodOnAfterUninstall(IDictionary)

Genera el evento AfterUninstall.(Heredado de Installer).

System_CAPS_protmethodOnBeforeInstall(IDictionary)

Genera el evento BeforeInstall.(Heredado de Installer).

System_CAPS_protmethodOnBeforeRollback(IDictionary)

Genera el evento BeforeRollback.(Heredado de Installer).

System_CAPS_protmethodOnBeforeUninstall(IDictionary)

Genera el evento BeforeUninstall.(Heredado de Installer).

System_CAPS_protmethodOnCommitted(IDictionary)

Genera el evento Committed.(Heredado de Installer).

System_CAPS_protmethodOnCommitting(IDictionary)

Genera el evento Committing.(Heredado de Installer).

System_CAPS_pubmethodRollback(IDictionary)

Restaura el equipo al estado que tenía 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 usarse con las herramientas de instalación, que llaman automáticamente a los métodos adecuados.(Invalida Installer.Rollback(IDictionary)).

System_CAPS_pubmethodToString()

Devuelve un String que contiene el nombre de la Component, si existe. Este método no se debe invalidar.(Heredado de Component).

System_CAPS_pubmethodUninstall(IDictionary)

Quita una instalación quitando la información de cola del registro. Este método está pensado para usarse con las herramientas de desinstalación, que llaman automáticamente a los métodos adecuados.(Invalida Installer.Uninstall(IDictionary)).

NombreDescripción
System_CAPS_pubeventAfterInstall

Se produce después de ejecutarse los métodos Install de todos los instaladores de la propiedad Installers.(Heredado de Installer).

System_CAPS_pubeventAfterRollback

Se produce después de deshacerse la instalación de todos los instaladores de la propiedad Installers.(Heredado de Installer).

System_CAPS_pubeventAfterUninstall

Se produce después de que todos los instaladores de la propiedad Installers realicen sus operaciones de desinstalación.(Heredado de Installer).

System_CAPS_pubeventBeforeInstall

Se produce antes de ejecutarse el método Install de cada instalador en la colección de instaladores.(Heredado de Installer).

System_CAPS_pubeventBeforeRollback

Se produce antes de deshacerse los instaladores de la propiedad Installers.(Heredado de Installer).

System_CAPS_pubeventBeforeUninstall

Se produce antes de que los instaladores de la propiedad Installers realicen sus operaciones de desinstalación.(Heredado de Installer).

System_CAPS_pubeventCommitted

Se produce después de que todos los instaladores de la propiedad Installers confirmen sus instalaciones.(Heredado de Installer).

System_CAPS_pubeventCommitting

Se produce antes de que los instaladores de la propiedad Installers confirmen sus instalaciones.(Heredado de Installer).

System_CAPS_pubeventDisposed

Se produce cuando el componente se elimina mediante una llamada a la Dispose (método).(Heredado de Component).

El MessageQueueInstaller se utiliza la utilidad de instalación para escribir valores del registro que están asociados a la cola. Para obtener más información acerca de las utilidades de instalación, consulte Installutil.exe (Installer Tool).

Para instalar una cola, cree una clase de instalador del proyecto que herede de la Installer, y establecer el RunInstallerAttribute para la clase true. Dentro del proyecto, cree una MessageQueueInstaller de la instancia para cada cola de la instalación y agregue la instancia a la clase de instalador del proyecto.

Al crear un MessageQueueInstaller instancia, puede opcionalmente pasar existente MessageQueue (por ejemplo, desde un servidor de pruebas) para el MessageQueueInstaller constructor. Este enfoque proporciona automáticamente la 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 el MessageQueueInstaller instancia en los Estados que desee y llama al constructor predeterminado.

Cuando se llama a la utilidad de instalación, busca el 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.

Modificar otras propiedades de un MessageQueueInstaller instancia antes o después de agregar la instancia a la Installers colección del instalador del proyecto. Por ejemplo, una cola de Path debe establecerse antes de que se ejecute la utilidad de instalación.

Normalmente, no se llama los métodos de la MessageQueueInstaller desde dentro del código; se suele llamar sólo desde la utilidad de instalación installutil.exe. La utilidad llama automáticamente el Install método durante el proceso de instalación y llama a Commit Si la instalación no ha iniciado una excepción. Deshace los errores, si es necesario, mediante una llamada a Rollback para el objeto que generó la excepción.

La rutina de instalación de la aplicación utiliza el instalador de proyecto Installer.Context para mantener automáticamente la información acerca de los componentes que ya se han instalado. Esta información de estado se actualiza continuamente en cada MessageQueueInstaller la utilidad instala la instancia. No es necesario normalmente para el código, modifique la información de estado de manera explícita.

.NET Framework
Disponible desde 1.1

Cualquier miembro ( Compartido en Visual Basic) estático público de este tipo es seguro para subprocesos. No se garantiza que los miembros de instancia sean seguros para subprocesos.

Volver al principio
Mostrar: