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 MessageQueue

 

Publicado: octubre de 2016

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

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

System.Object
  System.MarshalByRefObject
    System.ComponentModel.Component
      System.Messaging.MessageQueue

[MessagingDescriptionAttribute("MessageQueueDesc")]
public class MessageQueue : Component, IEnumerable

NombreDescripción
System_CAPS_pubmethodMessageQueue()

Inicializa una nueva instancia de la clase MessageQueue. Después de que el constructor predeterminado inicializa la nueva instancia, debe establecer la instancia Path propiedad antes de poder utilizar la instancia.

System_CAPS_pubmethodMessageQueue(String)

Inicializa una nueva instancia de la MessageQueue clase que hace referencia a la cola de Message Queue Server en la ruta especificada.

System_CAPS_pubmethodMessageQueue(String, Boolean)

Inicializa una nueva instancia de la MessageQueue clase que hace referencia a la cola de Message Queue Server en la ruta de acceso especificada y con la restricción de acceso de lectura especificada.

System_CAPS_pubmethodMessageQueue(String, Boolean, Boolean)

Inicializa una nueva instancia de la clase MessageQueue.

System_CAPS_pubmethodMessageQueue(String, Boolean, Boolean, QueueAccessMode)

Inicializa una nueva instancia de la clase MessageQueue.

System_CAPS_pubmethodMessageQueue(String, QueueAccessMode)

Inicializa una nueva instancia de la clase MessageQueue.

NombreDescripción
System_CAPS_pubpropertyAccessMode

Obtiene un valor que indica el modo de acceso para la cola.

System_CAPS_pubpropertyAuthenticate

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

System_CAPS_pubpropertyBasePriority

Obtiene o establece la prioridad básica que Message Queue Server 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_pubpropertyCanRead

Obtiene un valor que indica si el MessageQueue se puede leer.

System_CAPS_pubpropertyCanWrite

Obtiene un valor que indica si la MessageQueue puede escribirse.

System_CAPS_pubpropertyCategory

Obtiene o establece la categoría de la cola.

System_CAPS_pubpropertyContainer

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

System_CAPS_pubpropertyCreateTime

Obtiene la fecha y hora que se creó la cola de Message Queue Server.

System_CAPS_pubpropertyDefaultPropertiesToSend

Obtiene o establece el mensaje de valores de propiedad que se utiliza de forma predeterminada cuando la aplicación envía mensajes a la cola.

System_CAPS_pubpropertyDenySharedReceive

Obtiene o establece un valor que indica si esta MessageQueue tiene acceso exclusivo para recibir mensajes de la cola de Message Queue Server.

System_CAPS_protpropertyDesignMode

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

System_CAPS_pubpropertySystem_CAPS_staticEnableConnectionCache

Obtiene o establece un valor que indica si la aplicación va a mantener una caché de conexiones.

System_CAPS_pubpropertyEncryptionRequired

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

System_CAPS_protpropertyEvents

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

System_CAPS_pubpropertyFormatName

Obtiene el nombre de cola único que generó Message Queue Server en el momento de creación de la cola.

System_CAPS_pubpropertyFormatter

Obtiene o establece al formateador utilizado para serializar o deserializar un objeto en el cuerpo de un mensaje de lectura o escritura a la cola.

System_CAPS_pubpropertyId

Obtiene el identificador único de Message Queue Server de la cola.

System_CAPS_pubpropertyLabel

Obtiene o establece la descripción de la cola.

System_CAPS_pubpropertyLastModifyTime

Obtiene la última vez que se modificaron las propiedades de una cola.

System_CAPS_pubpropertyMachineName

Obtiene o establece el nombre del equipo donde se encuentra la cola de Message Queue Server.

System_CAPS_pubpropertyMaximumJournalSize

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

System_CAPS_pubpropertyMaximumQueueSize

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

System_CAPS_pubpropertyMessageReadPropertyFilter

Obtiene o establece el filtro de propiedad para recibir o buscar mensajes.

System_CAPS_pubpropertyMulticastAddress

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

System_CAPS_pubpropertyPath

Obtiene o establece la ruta de acceso de la cola. Establecer el Path hace que el MessageQueue para que señale a una nueva cola.

System_CAPS_pubpropertyQueueName

Obtiene o establece el nombre descriptivo que identifica la cola.

System_CAPS_pubpropertyReadHandle

Obtiene el identificador nativo utilizado para leer mensajes de la cola de mensajes.

System_CAPS_pubpropertySite

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

System_CAPS_pubpropertySynchronizingObject

Obtiene o establece el objeto que calcula las referencias de la llamada del controlador de eventos procedentes de un ReceiveCompleted o PeekCompleted eventos.

System_CAPS_pubpropertyTransactional

Obtiene un valor que indica si la cola acepta sólo transacciones.

System_CAPS_pubpropertyUseJournalQueue

Obtiene o establece un valor que indica si los mensajes recibidos se copian en la cola del diario.

System_CAPS_pubpropertyWriteHandle

Obtiene el identificador nativo utilizado para enviar mensajes a la cola de mensajes.

NombreDescripción
System_CAPS_pubmethodBeginPeek()

Inicia una operación de lectura asincrónica sin tiempo de espera. La operación no está completa hasta que haya un mensaje disponible en la cola.

System_CAPS_pubmethodBeginPeek(TimeSpan)

Inicia una operación de lectura asincrónica que tiene un tiempo de espera especificado. La operación no está completa hasta que haya un mensaje disponible en la cola o se agote el tiempo de espera.

System_CAPS_pubmethodBeginPeek(TimeSpan, Cursor, PeekAction, Object, AsyncCallback)

Inicia una operación de lectura asincrónica que tiene un tiempo de espera especificado y que utiliza un cursor, una acción de búsqueda peek y un objeto de estado especificado. El objeto de estado proporciona información asociada a lo largo de la duración de la operación. Esta sobrecarga recibe una notificación, mediante una devolución de llamada de la identidad del controlador de eventos para la operación. La operación no está completa hasta que haya un mensaje disponible en la cola o se agote el tiempo de espera.

System_CAPS_pubmethodBeginPeek(TimeSpan, Object)

Inicia una operación de lectura asincrónica que tiene un tiempo de espera especificado y un objeto de estado especificado, que proporciona información relacionada durante toda la operación. La operación no está completa hasta que haya un mensaje disponible en la cola o se agote el tiempo de espera.

System_CAPS_pubmethodBeginPeek(TimeSpan, Object, AsyncCallback)

Inicia una operación de lectura asincrónica que tiene un tiempo de espera especificado y un objeto de estado especificado, que proporciona información relacionada durante toda la operación. Esta sobrecarga recibe una notificación, mediante una devolución de llamada de la identidad del controlador de eventos para la operación. La operación no está completa hasta que haya un mensaje disponible en la cola o se agote el tiempo de espera.

System_CAPS_pubmethodBeginReceive()

Inicia una recepción asincrónica operación que no haya ningún tiempo de espera. La operación no está completa hasta que haya un mensaje disponible en la cola.

System_CAPS_pubmethodBeginReceive(TimeSpan)

Inicia una recepción asincrónica operación que tiene un tiempo de espera especificado. La operación no está completa hasta que haya un mensaje disponible en la cola o se agote el tiempo de espera.

System_CAPS_pubmethodBeginReceive(TimeSpan, Cursor, Object, AsyncCallback)

Inicia una operación de recepción asincrónica que tiene un tiempo de espera especificado y utiliza un cursor y un objeto de estado especificado. El objeto de estado proporciona información asociada a lo largo de la duración de la operación. Esta sobrecarga recibe una notificación, mediante una devolución de llamada de la identidad del controlador de eventos para la operación. La operación no está completa hasta que haya un mensaje disponible en la cola o se agote el tiempo de espera.

System_CAPS_pubmethodBeginReceive(TimeSpan, Object)

Inicia una operación de recepción asincrónica que tiene un tiempo de espera especificado y un objeto de estado especificado, que proporciona información relacionada durante toda la operación. La operación no está completa hasta que haya un mensaje disponible en la cola o se agote el tiempo de espera.

System_CAPS_pubmethodBeginReceive(TimeSpan, Object, AsyncCallback)

Inicia una operación de recepción asincrónica que tiene un tiempo de espera especificado y un objeto de estado especificado, que proporciona información relacionada durante toda la operación. Esta sobrecarga recibe una notificación, mediante una devolución de llamada de la identidad del controlador de eventos para la operación. La operación no está completa hasta que haya un mensaje disponible en la cola o se agote el tiempo de espera.

System_CAPS_pubmethodSystem_CAPS_staticClearConnectionCache()

Borra la caché de conexión.

System_CAPS_pubmethodClose()

Libera todos los recursos asignados por el MessageQueue.

System_CAPS_pubmethodSystem_CAPS_staticCreate(String)

Crea una cola no transaccional de Message Queue Server en la ruta especificada.

System_CAPS_pubmethodSystem_CAPS_staticCreate(String, Boolean)

Crea una cola transaccional o no transaccional de Message Queue Server en la ruta especificada.

System_CAPS_pubmethodCreateCursor()

Crea un nuevo Cursor para la cola de mensajes actual.

System_CAPS_pubmethodCreateObjRef(Type)

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

System_CAPS_pubmethodSystem_CAPS_staticDelete(String)

Elimina una cola en un servidor de Message Queue Server.

System_CAPS_pubmethodDispose()

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

System_CAPS_protmethodDispose(Boolean)

Se deshace de los recursos (distintos de la memoria) que usa MessageQueue.(Invalida Component.Dispose(Boolean)).

System_CAPS_pubmethodEndPeek(IAsyncResult)

Completa la operación de lectura asincrónica especificada.

System_CAPS_pubmethodEndReceive(IAsyncResult)

Complete especificado asincrónica operación de recepción.

System_CAPS_pubmethodEquals(Object)

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

System_CAPS_pubmethodSystem_CAPS_staticExists(String)

Determina si existe una cola de Message Queue Server en la ruta especificada.

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

Devuelve todos los mensajes que se encuentran en la cola.

System_CAPS_pubmethodGetEnumerator()

Obsoleto. Enumera los mensajes de una cola. GetEnumerator está desusada. GetMessageEnumerator2 debe usarse en su lugar.

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

Obtiene el identificador del equipo en el que la cola que hace referencia esta MessageQueue se encuentra.

System_CAPS_pubmethodGetMessageEnumerator()

Obsoleto. Crea un objeto enumerador para todos los mensajes en la cola. GetMessageEnumerator está desusada. GetMessageEnumerator2 debe usarse en su lugar.

System_CAPS_pubmethodGetMessageEnumerator2()

Crea un objeto enumerador para todos los mensajes en la cola.

System_CAPS_pubmethodSystem_CAPS_staticGetMessageQueueEnumerator()

Proporciona la semántica del cursor de sólo avance para enumerar todas las colas públicas de la red.

System_CAPS_pubmethodSystem_CAPS_staticGetMessageQueueEnumerator(MessageQueueCriteria)

Proporciona la semántica del cursor de sólo avance para enumerar todas las colas públicas de la red que cumplen los criterios especificados.

System_CAPS_pubmethodSystem_CAPS_staticGetPrivateQueuesByMachine(String)

Recupera todas las colas privadas en el equipo especificado.

System_CAPS_pubmethodSystem_CAPS_staticGetPublicQueues()

Recupera todas las colas públicas de la red.

System_CAPS_pubmethodSystem_CAPS_staticGetPublicQueues(MessageQueueCriteria)

Recupera todas las colas públicas de la red que cumplen los criterios especificados.

System_CAPS_pubmethodSystem_CAPS_staticGetPublicQueuesByCategory(Guid)

Recupera todas las colas públicas de la red que pertenecen a la categoría especificada.

System_CAPS_pubmethodSystem_CAPS_staticGetPublicQueuesByLabel(String)

Recupera todas las colas públicas de la red que tengan la etiqueta especificada.

System_CAPS_pubmethodSystem_CAPS_staticGetPublicQueuesByMachine(String)

Recupera todas las colas públicas que residen en el equipo especificado.

System_CAPS_pubmethodSystem_CAPS_staticGetSecurityContext()

Recupera el contexto de seguridad que MSMQ asocia al usuario actual (identidad de subproceso) en el momento de esta llamada.

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

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

System_CAPS_protmethodMemberwiseClone(Boolean)

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

System_CAPS_pubmethodPeek()

Devuelve sin quitar (búsqueda peek) el primer mensaje de la cola que hace referencia esta MessageQueue. El Peek método es sincrónico, por lo que se bloquea el subproceso actual hasta que haya un mensaje disponible.

System_CAPS_pubmethodPeek(TimeSpan)

Devuelve sin quitar (búsqueda peek) el primer mensaje de la cola que hace referencia esta MessageQueue. El Peek método es sincrónico, por lo que se bloquea el subproceso actual hasta que un mensaje disponible o se agote el tiempo de espera especificado.

System_CAPS_pubmethodPeek(TimeSpan, Cursor, PeekAction)

Devuelve sin quitar (búsqueda peek) el actual o el siguiente mensaje en la cola, utilizando el cursor especificado. El Peek método es sincrónico, por lo que se bloquea el subproceso actual hasta que un mensaje disponible o se agote el tiempo de espera especificado.

System_CAPS_pubmethodPeekByCorrelationId(String)

Inspecciona el mensaje que coincide con el identificador de correlación dado e inmediatamente inicia una excepción si la cola ningún mensaje con el identificador de correlación especificado.

System_CAPS_pubmethodPeekByCorrelationId(String, TimeSpan)

Busca el mensaje que coincide con el identificador de correlación dado y espera hasta que un mensaje con el identificador de correlación especificado esté disponible en la cola o el tiempo de espera expira.

System_CAPS_pubmethodPeekById(String)

Busca el mensaje cuyo identificador de mensaje coincida con el id parámetro.

System_CAPS_pubmethodPeekById(String, TimeSpan)

Busca el mensaje cuyo identificador de mensaje coincida con el id parámetro. Espera hasta que aparezca el mensaje en la cola o el tiempo de espera.

System_CAPS_pubmethodPeekByLookupId(Int64)

Introducido en MSMQ 3.0. Inspecciona un mensaje que coincida con el identificador de búsqueda dado de una cola no transaccional.

System_CAPS_pubmethodPeekByLookupId(MessageLookupAction, Int64)

Introducido en MSMQ 3.0. Inspecciona un mensaje concreto de la cola. El mensaje se puede especificar un identificador de búsqueda o por su posición al principio o al final de la cola.

System_CAPS_pubmethodPurge()

Elimina todos los mensajes contenidos en la cola.

System_CAPS_pubmethodReceive()

Recibe el primer mensaje disponible en la cola al que hace referencia el MessageQueue. Esta llamada es sincrónica y bloquea el subproceso actual de ejecución hasta que un mensaje esté disponible.

System_CAPS_pubmethodReceive(MessageQueueTransaction)

Recibe el primer mensaje disponible en la cola transaccional al que hace referencia el MessageQueue. Esta llamada es sincrónica y bloquea el subproceso actual de ejecución hasta que un mensaje esté disponible.

System_CAPS_pubmethodReceive(MessageQueueTransactionType)

Recibe el primer mensaje disponible en la cola al que hace referencia el MessageQueue. Esta llamada es sincrónica y bloquea el subproceso actual de ejecución hasta que un mensaje esté disponible.

System_CAPS_pubmethodReceive(TimeSpan)

Recibe el primer mensaje disponible en la cola al que hace referencia el MessageQueue y espera hasta que un mensaje esté disponible en la cola o el tiempo de espera expira.

System_CAPS_pubmethodReceive(TimeSpan, Cursor)

Recibe el mensaje actual en la cola, utilizando un cursor especificado. Si hay disponible ningún mensaje, este método espera hasta que hay un mensaje disponible o expire el tiempo de espera.

System_CAPS_pubmethodReceive(TimeSpan, Cursor, MessageQueueTransaction)

Recibe el mensaje actual en la cola, utilizando un cursor especificado. Si hay disponible ningún mensaje, este método espera hasta que hay un mensaje disponible o expire el tiempo de espera.

System_CAPS_pubmethodReceive(TimeSpan, Cursor, MessageQueueTransactionType)

Recibe el mensaje actual en la cola, utilizando un cursor especificado. Si hay disponible ningún mensaje, este método espera hasta que hay un mensaje disponible o expire el tiempo de espera.

System_CAPS_pubmethodReceive(TimeSpan, MessageQueueTransaction)

Recibe el primer mensaje disponible en la cola transaccional al que hace referencia el MessageQueue y espera hasta que un mensaje esté disponible en la cola o el tiempo de espera expira.

System_CAPS_pubmethodReceive(TimeSpan, MessageQueueTransactionType)

Recibe el primer mensaje disponible en la cola al que hace referencia el MessageQueue. Esta llamada es sincrónica y espera hasta que un mensaje esté disponible en la cola o el tiempo de espera expira.

System_CAPS_pubmethodReceiveByCorrelationId(String)

Recibe el mensaje que coincide con el identificador de correlación dado (desde una cola no transaccional) e inmediatamente inicia una excepción si la cola ningún mensaje con el identificador de correlación especificado.

System_CAPS_pubmethodReceiveByCorrelationId(String, MessageQueueTransaction)

Recibe el mensaje que coincide con el identificador de correlación dado (desde una cola transaccional) e inmediatamente inicia una excepción si la cola ningún mensaje con el identificador de correlación especificado.

System_CAPS_pubmethodReceiveByCorrelationId(String, MessageQueueTransactionType)

Recibe el mensaje que coincide con el identificador de correlación dado e inmediatamente inicia una excepción si la cola ningún mensaje con el identificador de correlación especificado.

System_CAPS_pubmethodReceiveByCorrelationId(String, TimeSpan)

Recibe el mensaje que coincide con el identificador de correlación dado (desde una cola no transaccional) y espera hasta que un mensaje con el identificador de correlación especificado esté disponible en la cola o el tiempo de espera expira.

System_CAPS_pubmethodReceiveByCorrelationId(String, TimeSpan, MessageQueueTransaction)

Recibe el mensaje que coincide con el identificador de correlación dado (desde una cola transaccional) y espera hasta que un mensaje con el identificador de correlación especificado esté disponible en la cola o el tiempo de espera expira.

System_CAPS_pubmethodReceiveByCorrelationId(String, TimeSpan, MessageQueueTransactionType)

Recibe el mensaje que coincide con el identificador de correlación dado y espera hasta que un mensaje con el identificador de correlación especificado esté disponible en la cola o el tiempo de espera expira.

System_CAPS_pubmethodReceiveById(String)

Recibe el mensaje que coincide con el identificador dado desde una cola no transaccional e inmediatamente inicia una excepción si la cola ningún mensaje con el identificador especificado.

System_CAPS_pubmethodReceiveById(String, MessageQueueTransaction)

Recibe el mensaje que coincide con el identificador dado (desde una cola transaccional) e inmediatamente inicia una excepción si la cola ningún mensaje con el identificador especificado.

System_CAPS_pubmethodReceiveById(String, MessageQueueTransactionType)

Recibe el mensaje que coincide con el identificador dado e inmediatamente inicia una excepción si la cola ningún mensaje con el identificador especificado.

System_CAPS_pubmethodReceiveById(String, TimeSpan)

Recibe el mensaje que coincide con el identificador dado (desde una cola no transaccional) y espera hasta que un mensaje con el identificador especificado esté disponible en la cola o el tiempo de espera expira.

System_CAPS_pubmethodReceiveById(String, TimeSpan, MessageQueueTransaction)

Recibe el mensaje que coincide con el identificador dado (desde una cola transaccional) y espera hasta que un mensaje con el identificador especificado esté disponible en la cola o el tiempo de espera expira.

System_CAPS_pubmethodReceiveById(String, TimeSpan, MessageQueueTransactionType)

Recibe el mensaje que coincide con el identificador dado y espera hasta que un mensaje con el identificador especificado esté disponible en la cola o el tiempo de espera expira.

System_CAPS_pubmethodReceiveByLookupId(Int64)

Introducido en MSMQ 3.0. Recibe el mensaje que coincide con el identificador de búsqueda dado de una cola no transaccional.

System_CAPS_pubmethodReceiveByLookupId(MessageLookupAction, Int64, MessageQueueTransaction)

Introducido en MSMQ 3.0. Recibe un mensaje concreto de una cola transaccional. El mensaje se puede especificar un identificador de búsqueda o por su posición al principio o al final de la cola.

System_CAPS_pubmethodReceiveByLookupId(MessageLookupAction, Int64, MessageQueueTransactionType)

Introducido en MSMQ 3.0. Recibe un mensaje concreto de la cola, utilizando el contexto de transacción especificado. El mensaje se puede especificar un identificador de búsqueda o por su posición al principio o al final de la cola.

System_CAPS_pubmethodRefresh()

Actualiza las propiedades que presenta el MessageQueue para reflejar el estado actual del recurso.

System_CAPS_pubmethodResetPermissions()

Restablece la lista de permisos a los valores predeterminados del sistema operativo. Quita los permisos de cola que se ha anexado a la lista predeterminada.

System_CAPS_pubmethodSend(Object)

Envía un objeto a la cola no transaccional que hace referencia esta MessageQueue.

System_CAPS_pubmethodSend(Object, MessageQueueTransaction)

Envía un objeto a la cola transaccional que hace referencia esta MessageQueue.

System_CAPS_pubmethodSend(Object, MessageQueueTransactionType)

Envía un objeto a la cola a la que hace referencia esta MessageQueue.

System_CAPS_pubmethodSend(Object, String)

Envía un objeto a la cola no transaccional que hace referencia esta MessageQueue y especifica una etiqueta para el mensaje.

System_CAPS_pubmethodSend(Object, String, MessageQueueTransaction)

Envía un objeto a la cola transaccional que hace referencia esta MessageQueue y especifica una etiqueta para el mensaje.

System_CAPS_pubmethodSend(Object, String, MessageQueueTransactionType)

Envía un objeto a la cola a la que hace referencia esta MessageQueue y especifica una etiqueta para el mensaje.

System_CAPS_pubmethodSetPermissions(AccessControlList)

Asigna derechos de acceso a la cola basándose en el contenido de una lista de control de acceso.

System_CAPS_pubmethodSetPermissions(MessageQueueAccessControlEntry)

Asigna derechos de acceso a la cola basándose en el contenido de una entrada de control de acceso.

System_CAPS_pubmethodSetPermissions(String, MessageQueueAccessRights)

Proporciona los derechos de acceso de un equipo, grupo o usuario.

System_CAPS_pubmethodSetPermissions(String, MessageQueueAccessRights, AccessControlEntryType)

Proporciona un equipo, grupo o usuario los derechos de acceso especificados, con el tipo de control de acceso especificado (conceder, denegar, revocar o establecer).

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

NombreDescripción
System_CAPS_pubfieldSystem_CAPS_staticInfiniteQueueSize

Especifica que no exista ninguna restricción de tamaño para una cola.

System_CAPS_pubfieldSystem_CAPS_staticInfiniteTimeout

Especifica que no exista ningún tiempo de espera para métodos que busquen o reciban mensajes.

NombreDescripción
System_CAPS_pubeventDisposed

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

System_CAPS_pubeventPeekCompleted

Se produce cuando se lee un mensaje sin eliminarlo de la cola. Éste es el resultado de la operación asincrónica, BeginPeek.

System_CAPS_pubeventReceiveCompleted

Se produce cuando un mensaje se ha quitado de la cola. Este evento se desencadena por la operación asincrónica, BeginReceive.

NombreDescripción
System_CAPS_pubmethodAsParallel()

Sobrecargado. Habilita la paralelización de una consulta.(Definido por ParallelEnumerable).

System_CAPS_pubmethodAsQueryable()

Sobrecargado. Convierte un IEnumerable a un IQueryable. (Definido por Queryable).

System_CAPS_pubmethodCast<TResult>()

Convierte los elementos de un IEnumerable al tipo especificado.(Definido por Enumerable).

System_CAPS_pubmethodOfType<TResult>()

Filtra los elementos de un IEnumerable basado en un tipo especificado.(Definido por Enumerable).

La tecnología de Message Queue Server permite que aplicaciones que se ejecutan en momentos diferentes comunicarse a través de redes heterogéneas y sistemas que pueden estar temporalmente sin conexión. Las aplicaciones enviarán, recepción o leer (peek sin quitar) mensajes de las colas. Message Queue Server es un componente opcional de Windows 2000 y Windows NT y debe instalarse por separado.

La MessageQueue clase es un contenedor de Message Queue Server. Hay varias versiones de Message Queue Server y utilizar el MessageQueue clase puede provocar un comportamiento ligeramente distinto, dependiendo del sistema operativo que esté utilizando. Para obtener información acerca de características específicas de cada versión de Message Queue Server, vea el tema "Novedades de Message Queue Server" en Platform SDK en MSDN.

La MessageQueue clase proporciona una referencia a una cola de Message Queue Server. Puede especificar una ruta de acceso en la MessageQueue constructor para conectarse a un recurso existente o puede crear una nueva cola en el servidor. Para poder llamar Send(Object), Peek, o Receive, debe asociar la nueva instancia de la MessageQueue clase con una cola existente. En ese momento, puede manipular las propiedades de la cola como Category y Label.

MessageQueue admite dos tipos de recuperación de mensajes: sincrónica y asincrónica. Los métodos sincrónicos, Peek y Receive, el subproceso debe esperar un intervalo de tiempo especificado para un nuevo mensaje llegue a la cola. Los métodos asincrónicos, BeginPeek y BeginReceive, permiten que las tareas de la aplicación principal continúen en un subproceso independiente hasta que llegue un mensaje en la cola. Estos métodos funcionan mediante objetos de devolución de llamada y objetos de estado para transmitir información entre subprocesos.

Cuando se crea una nueva instancia de la MessageQueue (clase), no se está creando una nueva cola de Message Queue Server. En su lugar, puede usar el Create(String), Delete(String), y Purge métodos para administrar las colas en el servidor.

A diferencia de Purge, Create(String) y Delete(String) son static miembros, por lo que puede llamar sin crear una nueva instancia de la MessageQueue clase.

Puede establecer la MessageQueue del objeto Path propiedad con uno de estos tres nombres: el nombre descriptivo y la FormatName, o Label. El nombre descriptivo, que se define por la cola MachineName y QueueName Propiedades, es MachineName\QueueName para una cola pública, y MachineName\Private$\QueueName para una cola privada. El FormatName propiedad permite el acceso sin conexión a las colas de mensajes. Por último, puede utilizar la cola Label establecer la cola de la propiedad Path.

Para obtener una lista de valores de propiedad iniciales de una instancia de MessageQueue, consulte el MessageQueue constructor.

En el ejemplo de código siguiente se crea un nuevo MessageQueue objetos mediante varios tipos de sintaxis de nombre de ruta de acceso. En cada caso, envía un mensaje a la cola cuya ruta de acceso se define en el constructor.

using System;
using System.Messaging;

namespace MyProject
{
	/// <summary>
	/// Provides a container class for the example.
	/// </summary>
	public class MyNewQueue
	{

		//**************************************************
		// Provides an entry point into the application.
		//		 
		// This example demonstrates several ways to set
		// a queue's path.
		//**************************************************

		public static void Main()
		{
			// Create a new instance of the class.
			MyNewQueue myNewQueue = new MyNewQueue();

			myNewQueue.SendPublic();
			myNewQueue.SendPrivate();
			myNewQueue.SendByLabel();
			myNewQueue.SendByFormatName();
			myNewQueue.MonitorComputerJournal();
			myNewQueue.MonitorQueueJournal();
			myNewQueue.MonitorDeadLetter();
			myNewQueue.MonitorTransactionalDeadLetter();

			return;
		}

		// References public queues.
		public void SendPublic()
		{
			MessageQueue myQueue = new MessageQueue(".\\myQueue");
			myQueue.Send("Public queue by path name.");

			return;
		}

		// References private queues.
		public void SendPrivate()
		{
			MessageQueue myQueue = new 
				MessageQueue(".\\Private$\\myQueue");
			myQueue.Send("Private queue by path name.");

			return;
		}

		// References queues by label.
		public void SendByLabel()
		{
			MessageQueue myQueue = new MessageQueue("Label:TheLabel");
			myQueue.Send("Queue by label.");

			return;
		}

		// References queues by format name.
		public void SendByFormatName()
		{
			MessageQueue myQueue = new 
				MessageQueue("FormatName:Public=5A5F7535-AE9A-41d4" + 
				"-935C-845C2AFF7112");
			myQueue.Send("Queue by format name.");

			return;
		}

		// References computer journal queues.
		public void MonitorComputerJournal()
		{
			MessageQueue computerJournal = new 
				MessageQueue(".\\Journal$");
			while(true)
			{
				Message journalMessage = computerJournal.Receive();
				// Process the journal message.
			}
		}

		// References queue journal queues.
		public void MonitorQueueJournal()
		{
			MessageQueue queueJournal = new 
				MessageQueue(".\\myQueue\\Journal$");
			while(true)
			{
				Message journalMessage = queueJournal.Receive();
				// Process the journal message.
			}
		}

		// References dead-letter queues.
		public void MonitorDeadLetter()
		{
			MessageQueue deadLetter = new 
				MessageQueue(".\\DeadLetter$");
			while(true)
			{
				Message deadMessage = deadLetter.Receive();
				// Process the dead-letter message.
			}
		}

		// References transactional dead-letter queues.
		public void MonitorTransactionalDeadLetter()
		{
			MessageQueue TxDeadLetter = new 
				MessageQueue(".\\XactDeadLetter$");
			while(true)
			{
				Message txDeadLetter = TxDeadLetter.Receive();
				// Process the transactional dead-letter message.
			}
		}

	}
}

En el ejemplo de código siguiente se envía un mensaje a una cola y se recibe un mensaje de una cola, mediante una clase específica de la aplicación llamada Order.

using System;
using System.Messaging;

namespace MyProject
{

	// This class represents an object the following example 
	// sends to a queue and receives from a queue.
	public class Order
	{
		public int orderId;
		public DateTime orderTime;
	};	

	/// <summary>
	/// Provides a container class for the example.
	/// </summary>
	public class MyNewQueue
	{

		//**************************************************
		// Provides an entry point into the application.
		//		 
		// This example sends and receives a message from
		// a queue.
		//**************************************************

		public static void Main()
		{
			// Create a new instance of the class.
			MyNewQueue myNewQueue = new MyNewQueue();

			// Send a message to a queue.
			myNewQueue.SendMessage();

			// Receive a message from a queue.
			myNewQueue.ReceiveMessage();

			return;
		}


		//**************************************************
		// Sends an Order to a queue.
		//**************************************************

		public void SendMessage()
		{

			// Create a new order and set values.
			Order sentOrder = new Order();
			sentOrder.orderId = 3;
			sentOrder.orderTime = DateTime.Now;

			// Connect to a queue on the local computer.
			MessageQueue myQueue = new MessageQueue(".\\myQueue");

			// Send the Order to the queue.
			myQueue.Send(sentOrder);

			return;
		}


		//**************************************************
		// Receives a message containing an Order.
		//**************************************************

		public  void ReceiveMessage()
		{
			// Connect to the a queue on the local computer.
			MessageQueue myQueue = new MessageQueue(".\\myQueue");

			// Set the formatter to indicate body contains an Order.
			myQueue.Formatter = new XmlMessageFormatter(new Type[]
				{typeof(MyProject.Order)});

			try
			{
				// Receive and format the message. 
				Message myMessage =	myQueue.Receive(); 
				Order myOrder = (Order)myMessage.Body;

				// Display message information.
				Console.WriteLine("Order ID: " + 
					myOrder.orderId.ToString());
				Console.WriteLine("Sent: " + 
					myOrder.orderTime.ToString());
			}

			catch (MessageQueueException)
			{
				// Handle Message Queuing exceptions.
			}

			// Handle invalid serialization format.
			catch (InvalidOperationException e)
			{
				Console.WriteLine(e.Message);
			}

			// Catch other exceptions as necessary.

			return;
		}
	}
}

.NET Framework
Disponible desde 1.1

Sólo el GetAllMessagesmethodis subprocesos seguros.

Volver al principio
Mostrar: