Message.LookupId Свойство

  • Ссылка

Определение

Пространство имен:
System.Messaging
Сборка:
System.Messaging.dll

Представлено в MSMQ 3.0. Получает идентификатор просмотра сообщения.

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

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

Int64

Код просмотра сообщения, который создается службой Message Queuing и уникален в очереди, где находится сообщение.

Исключения

PlatformNotSupportedException

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

InvalidOperationException

Сообщение не отправлено. Это свойство можно прочитать только для сообщений, извлеченных из очереди.

-или-

Очередь сообщений фильтруется, чтобы не учитывать свойство LookupId.

Комментарии

Свойство LookupId предоставляет доступ только для чтения к идентификатору подстановки сообщения. Идентификатор подстановки, представленный в MSMQ 3.0, — это 64-разрядный идентификатор, который создается службой очереди сообщений и назначается каждому сообщению при его размещении в очереди. Идентификатор подстановки отличается от идентификатора сообщения, создаваемого при отправке сообщения.

Очередь сообщений создает идентификатор подстановки для всех сообщений, размещенных в любой очереди, включая созданные приложениями конечные очереди, очереди администрирования и отчетов, а также журнал, недоставленные сообщения, соединительные и исходящие очереди. Другими словами, это относится как к сообщениям, отправленным путем отправки приложений, так и с помощью очереди сообщений. Идентификатор подстановки является уникальным для очереди и не имеет смысла за пределами очереди.

Если сообщение отправляется в несколько конечных очередей или копия сообщения хранится в журнале компьютеров или журнала очереди, каждая копия сообщения будет иметь собственный идентификатор подстановки при его размещении в соответствующей очереди.

Свойство LookupId может быть прочитано только для сообщений, полученных из очереди.

Идентификатор подстановки используется для чтения определенного сообщения в очереди. После того как идентификатор подстановки сообщения будет известен, принимающее приложение может вызвать PeekByLookupId функцию или ReceiveByLookupId , чтобы перейти непосредственно к сообщению и просмотреть или извлечь его из очереди, в отличие от курсоров, которые должны начинаться в передней части очереди и переходить к концу очереди.

За получение идентификаторов подстановки сообщений в очереди отвечает приложение. Один из возможных способов получить идентификаторы подстановки — создать триггер для конечной очереди, который вызывает компонент, который кэширует идентификаторы каждого сообщения по мере их размещения в очереди.

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

См. также раздел