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