Message.LookupId Propiedad

Definición

Introducido en MSMQ 3.0. Obtiene el identificador de búsqueda del mensaje.

public:
 property long LookupId { long get(); };
public long LookupId { get; }
member this.LookupId : int64
Public ReadOnly Property LookupId As Long

Valor de propiedad

El identificador de búsqueda del mensaje, generado por Message Queuing y único para la cola donde reside el mensaje.

Excepciones

MSMQ 3.0 no está instalado.

El mensaje no se ha enviado. Esta propiedad solo puede leerse en mensajes recuperados de una cola.

o bien

La cola de mensajes se filtra para omitir la propiedad LookupId.

Comentarios

La LookupId propiedad proporciona acceso de solo lectura al identificador de búsqueda de un mensaje. El identificador de búsqueda, introducido en MSMQ 3.0, es un identificador de 64 bits generado por Message Queuing y asignado a cada mensaje cuando el mensaje se coloca en la cola. El identificador de búsqueda no es el mismo que el identificador de mensaje que se genera cuando se envía el mensaje.

Message Queuing genera un identificador de búsqueda para todos los mensajes que se colocan en cualquier cola, incluidos el destino, la administración y las colas de informes generados por la aplicación, así como el diario generado por el sistema, los mensajes fallidos, el conector y las colas salientes. En otras palabras, esto incluye ambos mensajes enviados mediante el envío de aplicaciones y message Queuing. El identificador de búsqueda es único para la cola y no tiene ningún significado fuera de la cola.

Si se envía un mensaje a varias colas de destino o si se almacena una copia de un mensaje en un diario de equipo o diario de cola, cada copia del mensaje tendrá su propio identificador de búsqueda cuando se coloque en su cola respectiva.

La LookupId propiedad solo se puede leer en los mensajes recuperados de una cola.

Un identificador de búsqueda se usa para leer un mensaje específico en la cola. Una vez que se conoce el identificador de búsqueda de un mensaje, la aplicación receptora puede llamar a la PeekByLookupId función o ReceiveByLookupId para ir directamente a ese mensaje y ver o recuperarlo de la cola, a diferencia de los cursores que deben comenzar en la parte delantera de la cola y navegar hacia el final de la cola,

Obtener los identificadores de búsqueda de los mensajes de la cola es responsabilidad de la aplicación. Una manera posible de obtener los identificadores de búsqueda es crear un desencadenador para la cola de destino que invoca un componente que almacena en caché los identificadores de cada mensaje a medida que se colocan en la cola.

Se aplica a

Consulte también