Compartir a través de


MessageQueue.PeekByLookupId Método

Definición

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.Message
Public Function PeekByLookupId (lookupId As Long) As Message

Parámetros

lookupId
Int64

La propiedad LookupId del mensaje que se busca con el método Peek.

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
Equipo local y nombre de formato directo
Equipo remoto No
Equipo remoto y nombre de formato directo

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.Message
Public Function PeekByLookupId (action As MessageLookupAction, lookupId As Long) As Message

Pará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
Equipo local y nombre de formato directo
Equipo remoto No
Equipo remoto y nombre de formato directo

Consulte también

Se aplica a