Message.LookupId Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Представлено в MSMQ 3.0. Получает идентификатор просмотра сообщения.
public:
property long LookupId { long get(); };public long LookupId { get; }member this.LookupId : int64Public ReadOnly Property LookupId As LongЗначение свойства
Код просмотра сообщения, который создается службой Message Queuing и уникален в очереди, где находится сообщение.
Исключения
Приложение MSMQ 3.0 не установлено.
Сообщение не отправлено. Это свойство можно прочитать только для сообщений, извлеченных из очереди.
-или-
Очередь сообщений фильтруется, чтобы не учитывать свойство LookupId.
Комментарии
Свойство LookupId предоставляет доступ только для чтения к идентификатору подстановки сообщения. Идентификатор подстановки, представленный в MSMQ 3.0, — это 64-разрядный идентификатор, который создается службой очереди сообщений и назначается каждому сообщению при его размещении в очереди. Идентификатор подстановки отличается от идентификатора сообщения, создаваемого при отправке сообщения.
Очередь сообщений создает идентификатор подстановки для всех сообщений, размещенных в любой очереди, включая созданные приложениями конечные очереди, очереди администрирования и отчетов, а также журнал, недоставленные сообщения, соединительные и исходящие очереди. Другими словами, это относится как к сообщениям, отправленным путем отправки приложений, так и с помощью очереди сообщений. Идентификатор подстановки является уникальным для очереди и не имеет смысла за пределами очереди.
Если сообщение отправляется в несколько конечных очередей или копия сообщения хранится в журнале компьютеров или журнала очереди, каждая копия сообщения будет иметь собственный идентификатор подстановки при его размещении в соответствующей очереди.
Свойство LookupId может быть прочитано только для сообщений, полученных из очереди.
Идентификатор подстановки используется для чтения определенного сообщения в очереди. После того как идентификатор подстановки сообщения будет известен, принимающее приложение может вызвать PeekByLookupId функцию или ReceiveByLookupId , чтобы перейти непосредственно к сообщению и просмотреть или извлечь его из очереди, в отличие от курсоров, которые должны начинаться в передней части очереди и переходить к концу очереди.
За получение идентификаторов подстановки сообщений в очереди отвечает приложение. Один из возможных способов получить идентификаторы подстановки — создать триггер для конечной очереди, который вызывает компонент, который кэширует идентификаторы каждого сообщения по мере их размещения в очереди.
