Message.LookupId Propiedad

Definición

Introducido en MSMQ 3.0.Introduced in MSMQ 3.0. Obtiene el identificador de búsqueda del mensaje.Gets the message's lookup identifier.

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

Valor de propiedad

Int64

El identificador de búsqueda del mensaje, generado por Message Queuing y único para la cola donde reside el mensaje.The message's lookup identifier, which is generated by Message Queuing and is unique to the queue where the message resides.

Excepciones

MSMQ 3.0 no está instalado.MSMQ 3.0 is not installed.

El mensaje no se ha enviado.The message has not been sent. Esta propiedad solo puede leerse en mensajes recuperados de una cola.This property can only be read on messages retrieved from a queue.

o bien-or- La cola de mensajes se filtra para omitir la propiedad LookupId.The message queue is filtered to ignore the LookupId property.

Comentarios

La LookupId propiedad proporciona acceso de solo lectura al identificador de búsqueda de un mensaje.The LookupId property provides read-only access to a message's lookup identifier. El identificador de búsqueda, introducido en MSMQ 3,0, es un identificador de 64 bits que genera Message Queue Server y se asigna a cada mensaje cuando el mensaje se coloca en la cola.The lookup identifier, introduced in MSMQ 3.0, is a 64-bit identifier that is generated by Message Queuing and assigned to each message when the message is placed in the queue. El identificador de búsqueda no es el mismo que el identificador de mensaje que se genera cuando se envía el mensaje.The lookup identifier is not the same as the message identifier that is generated when the message is sent.

Message Queue Server genera un identificador de búsqueda para todos los mensajes que se colocan en cualquier cola, incluidas las colas de informes, la administración y el destino generados por la aplicación, así como las colas de salida, de mensajes no enviados, de conector y salientes generados por el sistema.Message Queuing generates a lookup identifier for all messages that are placed in any queue, including application-generated destination, administration, and report queues, as well as system-generated journal, dead-letter, connector, and outgoing queues. En otras palabras, esto incluye los mensajes enviados mediante el envío de aplicaciones y Message Queue Server.In other words, this includes both messages sent by sending applications and by Message Queuing. El identificador de búsqueda es único en la cola y no tiene ningún significado fuera de la cola.The lookup identifier is unique to the queue and has no meaning outside the queue.

Si se envía un mensaje a varias colas de destino, o si se almacena una copia de un mensaje en un diario del equipo o en la cola, cada copia del mensaje tendrá su propio identificador de búsqueda cuando se coloque en su cola respectiva.If a message is sent to several destination queues, or if a copy of a message is stored in a computer journal or queue journal, each copy of the message will have its own lookup identifier when it is placed in its respective queue.

La LookupId propiedad solo se puede leer en los mensajes recuperados de una cola.The LookupId property can only be read on messages retrieved from a queue.

Un identificador de búsqueda se utiliza para leer un mensaje específico en la cola.A lookup identifier is used to read a specific message in the queue. Una vez conocido el identificador de búsqueda de un mensaje, la aplicación receptora puede llamar a la PeekByLookupId ReceiveByLookupId función o para ir directamente a ese mensaje y examinarlo 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.Once the lookup identifier of a message is known, the receiving application can call the PeekByLookupId or ReceiveByLookupId function to go directly to that message and peek at or retrieve it from the queue, unlike cursors that must start at the front of the queue and navigate towards the end of the queue,

La obtención de los identificadores de búsqueda de los mensajes en la cola es responsabilidad de la aplicación.Obtaining the lookup identifiers of the messages in the queue is the responsibility of the application. Una forma posible de obtener los identificadores de búsqueda es crear un desencadenador para la cola de destino que invoca un componente que almacena en memoria caché los identificadores de cada mensaje a medida que se colocan en la cola.One possible way to obtain the lookup identifiers is to create a trigger for the destination queue that invokes a component that caches the identifiers of each message as they are placed in the queue.

Se aplica a

Consulte también