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