MessageQueue.PeekByLookupId Método
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í.
Introducido en MSMQ 3.0. Ejecuta el método Peek en un mensaje concreto de la cola. El mensaje se puede especificar mediante un identificador de búsqueda o por su posición al principio o al final de la cola.
Sobrecargas
| PeekByLookupId(Int64) |
Introducido en MSMQ 3.0. Ejecuta el método Peek en el mensaje que coincide con el identificador de búsqueda determinado de una cola no transaccional. |
| PeekByLookupId(MessageLookupAction, Int64) |
Introducido en MSMQ 3.0. Ejecuta el método Peek en un mensaje concreto de la cola. El mensaje se puede especificar mediante un identificador de búsqueda o por su posición al principio o al final de la cola. |
PeekByLookupId(Int64)
Introducido en MSMQ 3.0. Ejecuta el método Peek en el mensaje que coincide con el identificador de búsqueda determinado de una cola no transaccional.
public:
System::Messaging::Message ^ PeekByLookupId(long lookupId);public System.Messaging.Message PeekByLookupId (long lookupId);member this.PeekByLookupId : int64 -> System.Messaging.MessagePublic Function PeekByLookupId (lookupId As Long) As MessageParámetros
Devoluciones
Message cuya propiedad LookupId coincide con el parámetro lookupId pasado.
Excepciones
MSMQ 3.0 no está instalado.
No se encontró el mensaje con el lookupId especificado.
Error al obtener acceso a un método de Message Queuing.
Comentarios
Use este método para leer un mensaje con un identificador de búsqueda conocido sin quitarlo de la cola. Este método produce una excepción inmediatamente si el mensaje no está en la cola.
La LookupId propiedad de un mensaje es única para la cola donde reside el mensaje, por lo que habrá como máximo un mensaje en la cola que coincida con el parámetro especificado lookupId .
Para leer un mensaje con un identificador de búsqueda especificado y quitarlo de la cola, use el ReceiveByLookupId método .
En la tabla siguiente se muestra si este método está disponible en varios modos de grupo de trabajo.
| Modo de grupo de trabajo | Disponible |
|---|---|
| Equipo local | Sí |
| Equipo local y nombre de formato directo | Sí |
| Equipo remoto | No |
| Equipo remoto y nombre de formato directo | Sí |
Consulte también
Se aplica a
PeekByLookupId(MessageLookupAction, Int64)
Introducido en MSMQ 3.0. Ejecuta el método Peek en un mensaje concreto de la cola. El mensaje se puede especificar mediante un identificador de búsqueda o por su posición al principio o al final de la cola.
public:
System::Messaging::Message ^ PeekByLookupId(System::Messaging::MessageLookupAction action, long lookupId);public System.Messaging.Message PeekByLookupId (System.Messaging.MessageLookupAction action, long lookupId);member this.PeekByLookupId : System.Messaging.MessageLookupAction * int64 -> System.Messaging.MessagePublic Function PeekByLookupId (action As MessageLookupAction, lookupId As Long) As MessageParámetros
- action
- MessageLookupAction
Uno de los valores MessageLookupAction, que especifica cómo se lee el mensaje en la cola. Especifique uno de los siguientes:
MessageLookupAction.Current: ejecuta el método Peek en el mensaje especificado por lookupId.
MessageLookupAction.Next: ejecuta el método Peek en el mensaje que sigue al mensaje especificado por lookupId.
MessageLookupAction.Previous: ejecuta el método Peek en el mensaje que precede al especificado por lookupId.
MessageLookupAction.First: ejecuta el método Peek en el primer mensaje de la cola. El parámetro lookupId debe establecerse en 0.
MessageLookupAction.Last: ejecuta el método Peek en el último mensaje de la cola. El parámetro lookupId debe establecerse en 0.
- lookupId
- Int64
LookupId del mensaje en el que ejecutar el método Peek o 0. 0 se usa al tener acceso al primer o último mensaje de la cola.
Devoluciones
La clase Message especificada por los parámetros action y lookupId pasados.
Excepciones
MSMQ 3.0 no está instalado.
No se encontró el mensaje con el lookupId especificado.
Error al obtener acceso a un método de Message Queuing.
El parámetro action no es un miembro de MessageLookupAction.
Comentarios
Use este método para leer un mensaje con un identificador de búsqueda conocido sin quitarlo de la cola. Este método produce una excepción inmediatamente si el mensaje no está en la cola.
La LookupId propiedad de un mensaje es única para la cola donde reside el mensaje, por lo que habrá como máximo un mensaje en la cola que coincida con el parámetro especificado lookupId .
Para leer un mensaje con un identificador especificado y quitarlo de la cola, use el ReceiveByLookupId método .
En la tabla siguiente se muestra si este método está disponible en varios modos de grupo de trabajo.
| Modo de grupo de trabajo | Disponible |
|---|---|
| Equipo local | Sí |
| Equipo local y nombre de formato directo | Sí |
| Equipo remoto | No |
| Equipo remoto y nombre de formato directo | Sí |
