MessageQueue.PeekByLookupId Метод

Определение

Пространство имен:

System.Messaging

Сборка:

System.Messaging.dll

Представлено в MSMQ 3.0. Считывает конкретное сообщение из очереди. Сообщение может быть задано кодом просмотра либо его положением относительно начала или конца очереди.

Перегрузки

PeekByLookupId(Int64)	Представлено в MSMQ 3.0. Считывает сообщение, соответствующее заданному идентификатору просмотра, из нетранзакционной очереди.
PeekByLookupId(MessageLookupAction, Int64)	Представлено в MSMQ 3.0. Считывает конкретное сообщение из очереди. Сообщение может быть задано кодом просмотра либо его положением относительно начала или конца очереди.

PeekByLookupId(Int64)

Представлено в MSMQ 3.0. Считывает сообщение, соответствующее заданному идентификатору просмотра, из нетранзакционной очереди.

public:
 System::Messaging::Message ^ PeekByLookupId(long lookupId);

public System.Messaging.Message PeekByLookupId (long lookupId);

member this.PeekByLookupId : int64 -> System.Messaging.Message

Public Function PeekByLookupId (lookupId As Long) As Message

Параметры

lookupId

Int64

Свойство LookupId считываемого сообщения.

Возвращаемое значение

Message

Объект Message, свойство LookupId которого соответствует переданному в объект параметру lookupId.

Исключения

PlatformNotSupportedException

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

InvalidOperationException

Не удалось найти сообщение с указанным параметром lookupId.

MessageQueueException

При обращении к методу службы очереди сообщений возникла ошибка.

Комментарии

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

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

Чтобы прочитать сообщение с указанным идентификатором поиска и удалить его из очереди, используйте ReceiveByLookupId метод .

В следующей таблице показано, доступен ли этот метод в различных режимах рабочей группы.

Режим рабочей группы	Доступно
Локальный компьютер	Да
Имя локального компьютера и прямого формата	Да
Удаленный компьютер	Нет
Имя удаленного компьютера и прямого формата	Да

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

• LookupId
• ReceiveByLookupId

PeekByLookupId(MessageLookupAction, Int64)

Представлено в MSMQ 3.0. Считывает конкретное сообщение из очереди. Сообщение может быть задано кодом просмотра либо его положением относительно начала или конца очереди.

public:
 System::Messaging::Message ^ PeekByLookupId(System::Messaging::MessageLookupAction action, long lookupId);

public System.Messaging.Message PeekByLookupId (System.Messaging.MessageLookupAction action, long lookupId);

member this.PeekByLookupId : System.Messaging.MessageLookupAction * int64 -> System.Messaging.Message

Public Function PeekByLookupId (action As MessageLookupAction, lookupId As Long) As Message

Параметры

action

MessageLookupAction

Одно из значений MessageLookupAction, задающее порядок чтения сообщения в очереди. Укажите одно из следующих значений:

MessageLookupAction.Current: считывает сообщение, заданное параметром lookupId.

MessageLookupAction.Next: считывает сообщение, следующее за сообщением, заданным параметром lookupId.

MessageLookupAction.Previous: считывает сообщение, предшествующее сообщению, заданному параметром lookupId.

MessageLookupAction.First: считывает первое сообщение в очереди. Параметр lookupId должен быть установлен равным 0.

MessageLookupAction.Last: считывает последнее сообщение в очереди. Параметр lookupId должен быть установлен равным 0.

lookupId

Int64

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

Возвращаемое значение

Message

Объект Message, задаваемый передаваемыми параметрами action и lookupId.

Исключения

PlatformNotSupportedException

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

InvalidOperationException

Не удалось найти сообщение с указанным параметром lookupId.

MessageQueueException

При обращении к методу службы очереди сообщений возникла ошибка.

InvalidEnumArgumentException

Параметр action не является одним из членов MessageLookupAction.

Комментарии

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

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

Чтобы прочитать сообщение с указанным идентификатором и удалить его из очереди, используйте ReceiveByLookupId метод .

В следующей таблице показано, доступен ли этот метод в различных режимах рабочей группы.

Режим рабочей группы	Доступно
Локальный компьютер	Да
Имя локального компьютера и прямого формата	Да
Удаленный компьютер	Нет
Имя удаленного компьютера и прямого формата	Да

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

• LookupId
• ReceiveByLookupId