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

Espacio de nombres System.Messaging

 

Publicado: octubre de 2016

El System.Messaging espacio de nombres proporciona clases que permiten conectar, supervisar y administrar las colas de mensajes en la red y enviar, recibirán o inspección mensajes.

ClaseDescripción
System_CAPS_pubclassAccessControlEntry

Especifica los derechos de acceso para un usuario de confianza (usuario, grupo o equipo) para realizar implementaciones específicas de la aplicación de las tareas comunes.

System_CAPS_pubclassAccessControlList

Contiene una lista de entradas de control de acceso que especifica los derechos de acceso para uno o varias personas de confianza.

System_CAPS_pubclassActiveXMessageFormatter

Serializa o deserializa los tipos de datos primitivos y otros objetos en el cuerpo de un mensaje de Message Queue Server, con un formato que sea compatible con el componente ActiveX MSMQ.

System_CAPS_pubclassBinaryMessageFormatter

Serializa o deserializa un objeto o todo un grafo de objetos conectados, a o desde el cuerpo de un mensaje de Message Queue Server, usando un formato binario.

System_CAPS_pubclassCursor

Un Cursor se utiliza para mantener una ubicación concreta de un MessageQueue al leer mensajes de la cola.

System_CAPS_pubclassDefaultPropertiesToSend

Especifica los valores de propiedad predeterminados que se usará cuando se envían objetos distintos de Message instancias de una cola de mensajes.

System_CAPS_pubclassMessage

Proporciona acceso a las propiedades necesarias para definir un mensaje de Message Queue Server.

System_CAPS_pubclassMessageEnumerator

Ofrece un cursor de solo avance para enumerar los mensajes de una cola de mensajes.

System_CAPS_pubclassMessagePropertyFilter

Controla y selecciona las propiedades que se recuperan al leerlo o recibir mensajes de una cola de mensajes.

System_CAPS_pubclassMessageQueue

Proporciona acceso a una cola en un servidor de Message Queue Server.

System_CAPS_pubclassMessageQueueAccessControlEntry

Especifica los derechos de acceso de un usuario de confianza (usuario, grupo o equipo) para realizar tareas de Message Queue Server.

System_CAPS_pubclassMessageQueueCriteria

Filtros de colas de mensajes cuando se realiza una consulta mediante la MessageQueue clase GetPublicQueues método.

System_CAPS_pubclassMessageQueueEnumerator

Ofrece un cursor de solo avance para enumerar los mensajes de una cola de mensajes.

System_CAPS_pubclassMessageQueueException

Excepción que se produce cuando ocurre un error interno de Microsoft Message Queuing.

System_CAPS_pubclassMessageQueueInstaller

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.

System_CAPS_pubclassMessageQueuePermission

Permite controlar los permisos de acceso del código para la mensajería.

System_CAPS_pubclassMessageQueuePermissionAttribute

Permite declarativa MessageQueue comprobaciones de permisos.

System_CAPS_pubclassMessageQueuePermissionEntry

Define la unidad más pequeña de un permiso de seguridad de acceso a código establecido para los mensajes.

System_CAPS_pubclassMessageQueuePermissionEntryCollection

Contiene una colección fuertemente tipada de objetos MessageQueuePermissionEntry.

System_CAPS_pubclassMessageQueueTransaction

Proporciona una transacción interna de Message Queue Server.

System_CAPS_pubclassMessagingDescriptionAttribute

Especifica una descripción para una propiedad o evento.

System_CAPS_pubclassPeekCompletedEventArgs

Proporciona datos para el evento PeekCompleted. Cuando la operación de lectura asincrónica llama a un controlador de eventos, se pasa una instancia de esta clase al controlador.

System_CAPS_pubclassReceiveCompletedEventArgs

Proporciona datos para el evento ReceiveCompleted. Cuando la recepción asincrónica operación llama a un controlador de eventos, se pasa una instancia de esta clase al controlador.

System_CAPS_pubclassSecurityContext

Representa el contexto de seguridad para un mensaje en una cola.

System_CAPS_pubclassTrustee

Especifica una cuenta de usuario, cuenta de grupo o sesión de inicio de sesión al que se aplica una entrada de control de acceso.

System_CAPS_pubclassXmlMessageFormatter

Serializa y deserializa objetos en el cuerpo de un mensaje con el formato XML basado en la definición de esquema XSD.

InterfazDescripción
System_CAPS_pubinterfaceIMessageFormatter

Serializa o deserializa objetos del cuerpo de un mensaje de Message Queue Server.

DelegadoDescripción
System_CAPS_pubdelegatePeekCompletedEventHandler

Representa el método que controlará el evento PeekCompleted de MessageQueue.

System_CAPS_pubdelegateReceiveCompletedEventHandler

Representa el método que controlará el evento ReceiveCompleted de MessageQueue.

EnumeraciónDescripción
System_CAPS_pubenumAccessControlEntryType

Especifica si se debe permitir, denegar o revocar los derechos de acceso para un usuario de confianza.

System_CAPS_pubenumAcknowledgeTypes

Especifica los tipos de mensaje de confirmación que Message Queue Server devuelve a la aplicación de envío.

System_CAPS_pubenumAcknowledgment

Especifica el resultado de un intento de entrega del mensaje.

System_CAPS_pubenumCryptographicProviderType

Especifica los proveedores de servicios criptográficos disponibles para validar las firmas digitales.

System_CAPS_pubenumEncryptionAlgorithm

Especifica el algoritmo de cifrado utilizado para cifrar el cuerpo de un mensaje privado.

System_CAPS_pubenumEncryptionRequired

Especifica el nivel de privacidad de mensajes recibidos por la cola.

System_CAPS_pubenumGenericAccessRights

Utiliza el formato de acceso de Windows 2000 y Windows NT para especificar un conjunto de derechos de acceso comunes que Message Queue Server asigna tanto a derechos de acceso estándar y específicos del objeto para lectura, escritura y ejecución.

System_CAPS_pubenumHashAlgorithm

Especifica el algoritmo hash utilizado por Message Queue Server al autenticar mensajes.

System_CAPS_pubenumMessageLookupAction

Especifica un mensaje para inspeccionar o recibir desde una cola de mensajes.

System_CAPS_pubenumMessagePriority

Especifica la prioridad que Message Queue Server se aplica a un mensaje mientras está en tránsito a una cola y cuando inserta el mensaje en la cola de destino.

System_CAPS_pubenumMessageQueueAccessRights

Especifica un conjunto de derechos de acceso específicos del objeto para operaciones específicas a Message Queue Server.

System_CAPS_pubenumMessageQueueErrorCode

Esta API admite la infraestructura producto y no está diseñada para usarse directamente desde el código. Identifica el origen de un error que se produjo dentro de la aplicación de Message Queue Server ha generado un MessageQueueException excepción.

System_CAPS_pubenumMessageQueuePermissionAccess

Define los niveles de acceso utilizados por System.Messaging las clases de permiso.

System_CAPS_pubenumMessageQueueTransactionStatus

Especifica el estado de una transacción interna de Message Queue Server.

System_CAPS_pubenumMessageQueueTransactionType

Especifica el tipo de una transacción de Message Queue Server.

System_CAPS_pubenumMessageType

Identifica el tipo de un mensaje. Un mensaje puede ser un mensaje de Message Queue Server típico, un positivo (recepción y lectura) o de confirmación negativo (recepción y lectura) mensaje o un mensaje de informe.

System_CAPS_pubenumPeekAction

Indica si se debe inspeccionar el mensaje actual de una cola o el mensaje siguiente.

System_CAPS_pubenumQueueAccessMode

Especifica el modo de acceso para un MessageQueue en tiempo de creación.

System_CAPS_pubenumStandardAccessRights

Especifica un conjunto de derechos de acceso estándar correspondiente a operaciones comunes a la mayoría de los tipos de objetos protegibles.

System_CAPS_pubenumTrusteeType

Especifica el tipo de un usuario de confianza.

Los miembros de la MessageQueue clase incluyen los siguientes métodos para leer y escribir mensajes en la cola:

  • El M:System.Messaging.MessageQueue.Send método permite que la aplicación escribir mensajes en la cola. Las sobrecargas del método permiten especificar si se debe enviar el mensaje con un Message (que proporciona un control exhaustivo sobre la información enviada) o cualquier otro objeto administrado, como las clases específicas de la aplicación. El método también admite el envío de mensajes como parte de una transacción.

  • El Receive, M:System.Messaging.MessageQueue.ReceiveById, y M:System.Messaging.MessageQueue.ReceiveByCorrelationId métodos proporcionan funciones para leer los mensajes de una cola. Como el M:System.Messaging.MessageQueue.Send (método), estos métodos proporcionan sobrecargas que admiten el procesamiento de colas transaccionales. Estos métodos también proporcionan sobrecargas con tiempo de espera.

    Los parámetros de salida que permiten el procesamiento continúe si la cola está vacía. Dado que estos métodos son ejemplos de procesamiento sincrónico, interrumpen el subproceso actual hasta que haya un mensaje disponible, a menos que especifique un tiempo de espera.

  • El Peek es similar al método Receive, pero no hace que un mensaje que se va a quitar de la cola cuando se leen. Porque Peek no cambia el contenido de la cola, existen dos sobrecargas que admiten procesamiento transaccional. Sin embargo, dado que Peek, como Receive, lee los mensajes de la cola sincrónicamente, las sobrecargas del método admite la especificación de un tiempo de espera para impedir que el subproceso espera indefinidamente.

  • El BeginPeek, EndPeek(IAsyncResult), BeginReceive, y EndReceive(IAsyncResult) métodos ofrecen formas de leer los mensajes de la cola asincrónicamente. No interrumpen el subproceso actual mientras se espera un mensaje llegue a la cola.

Los siguientes métodos de la MessageQueue clase proporcionan funciones para recuperar listas de colas según los criterios especificados y averiguar si existen determinadas colas:

Otros métodos de la MessageQueue clase proporcionan la funcionalidad siguiente:

  • Crear y eliminar colas de Message Queue Server.

  • Uso de un enumerador de mensajes para recorrer en iteración los mensajes de una cola.

  • Uso de un enumerador de cola para iterar las colas del sistema.

  • Establecer derechos de acceso basados en ACL.

  • Trabajar con la caché de conexión.

La Message clase proporciona un control detallado sobre la información que se envía a una cola y se utiliza el objeto al recibir o inspeccionar mensajes de una cola. Además del cuerpo del mensaje, las propiedades de la Message clase incluyen valores de confirmación, selección de formateador, información de identificación, autenticación y cifrado, marcas de hora, indicaciones sobre el uso de seguimiento, registro en diario de servidor y colas de mensajes no enviados y datos de transacciones.

El MessageQueue componente está asociado a los tres formateadores siguientes, que permiten serializar y deserializar los mensajes enviados y recibidos de las colas:

  • El XmlMessageFormatter proporciona mensajería de correspondencia imprecisa, lo que permite crear versiones independientes de tipos serializados en el cliente y el servidor.

  • El ActiveXMessageFormatter es compatible con el control COM MSMQ. Permite enviar tipos que pueden recibir el control y recibir tipos enviados por el control.

  • El BinaryMessageFormatter ofrece una alternativa más rápida a la XmlMessageFormatter, pero sin la ventaja de mensajería de correspondencia imprecisa.

Otras clases en el Messaging espacio de nombres admiten el acceso a código y seguridad basada en ACL, filtrado Message Propiedades al leer los mensajes de una cola y mediante transacciones al enviar y recibir mensajes.

Volver al principio
Mostrar: