Message.LookupId Message.LookupId Message.LookupId Message.LookupId Property

Определение

Представлено в MSMQ 3.0.Introduced in MSMQ 3.0. Получает идентификатор просмотра сообщения.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

Значение свойства

Код просмотра сообщения, который создается службой Message Queuing и уникален в очереди, где находится сообщение.The message's lookup identifier, which is generated by Message Queuing and is unique to the queue where the message resides.

Исключения

Приложение MSMQ 3.0 не установлено.MSMQ 3.0 is not installed.

Сообщение не отправлено.The message has not been sent. Это свойство можно прочитать только для сообщений, извлеченных из очереди.This property can only be read on messages retrieved from a queue.

- или --or- Очередь сообщений фильтруется, чтобы не учитывать свойство LookupId.The message queue is filtered to ignore the LookupId property.

Комментарии

LookupId Свойство предоставляет доступ только для чтения к идентификатору просмотра сообщения.The LookupId property provides read-only access to a message's lookup identifier. Идентификатор уточняющего запроса, представленный в MSMQ 3,0, является 64-битным идентификатором, который создается службой очереди сообщений и назначается каждому сообщению, когда сообщение помещается в очередь.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. Идентификатор уточняющего запроса не совпадает с идентификатором сообщения, формируемого при отправке сообщения.The lookup identifier is not the same as the message identifier that is generated when the message is sent.

Служба очереди сообщений создает идентификатор уточняющего запроса для всех сообщений, помещаемых в любую очередь, включая созданные приложением, административные очереди, а также созданные системой журналы, недоставленные сообщения, соединитель и исходящие очереди.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. Другими словами, сюда входят сообщения, отправленные отправляющим приложением и очередью сообщений.In other words, this includes both messages sent by sending applications and by Message Queuing. Идентификатор уточняющего запроса уникален для очереди и не имеет смысла за пределами очереди.The lookup identifier is unique to the queue and has no meaning outside the queue.

Если сообщение отправляется в несколько очередей назначения или если копия сообщения хранится в журнале компьютера или в журнале очереди, то каждая копия сообщения будет иметь собственный идентификатор поиска, когда он помещается в соответствующую очередь.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.

LookupId Свойство может быть прочитано только для сообщений, полученных из очереди.The LookupId property can only be read on messages retrieved from a queue.

Идентификатор уточняющего запроса используется для чтения определенного сообщения в очереди.A lookup identifier is used to read a specific message in the queue. Когда идентификатор уточняющего запроса сообщения известен, принимающее приложение может вызвать PeekByLookupId функцию или ReceiveByLookupId , чтобы перейти непосредственно к этому сообщению и просмотреть или извлечь его из очереди, в отличие от курсоров, которые должны начинаться в начале очереди. Перейдите к концу очереди,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,

Получение идентификаторов поиска сообщений в очереди является обязанностью приложения.Obtaining the lookup identifiers of the messages in the queue is the responsibility of the application. Одним из возможных способов получения идентификаторов поиска является создание триггера для очереди назначения, вызывающей компонент, который кэширует идентификаторы каждого сообщения в том виде, в каком они помещены в очередь.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.

Применяется к

Дополнительно