MessageQueue.GetMessageEnumerator2 Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Создает объект перечислителя для всех сообщений в очереди.
public:
System::Messaging::MessageEnumerator ^ GetMessageEnumerator2();
public System.Messaging.MessageEnumerator GetMessageEnumerator2();
member this.GetMessageEnumerator2 : unit -> System.Messaging.MessageEnumerator
Public Function GetMessageEnumerator2 () As MessageEnumerator
Возвращаемое значение
Удержание MessageEnumerator сообщений, содержащихся в очереди.
Комментарии
GetMessageEnumerator2 создает динамический список всех сообщений в очереди. Вы можете удалить сообщение из очереди в текущей позиции перечислителя, вызвав RemoveCurrentMessageEnumerator возвращаемый GetMessageEnumerator2 объект.
Так как курсор связан с динамическим списком сообщений в очереди, перечисление отражает любые изменения, внесенные в сообщения в очереди, если сообщение выходит за рамки текущей позиции курсора. Например, перечислитель может автоматически получить доступ к сообщению с более низким приоритетом, размещенном за пределами текущей позиции курсора, но не к сообщению с более высоким приоритетом, вставленным до этой позиции. Однако можно сбросить перечисление, тем самым переместив курсор обратно в начало списка, вызвав Reset запрос.MessageEnumerator
Порядок сообщений в перечислении отражает их порядок в очереди, поэтому сообщения с более высоким приоритетом будут отображаться перед более низким приоритетом.
Если требуется статический моментальный снимок сообщений в очереди, а не динамическое подключение к ним, вызовите вызов GetAllMessages. Этот метод возвращает массив Message объектов, представляющих сообщения во время вызова метода.
В следующей таблице показано, доступен ли этот метод в различных режимах рабочей группы.
| Режим рабочей группы | В наличии |
|---|---|
| Локальный компьютер | Yes |
| Имя локального компьютера и прямого формата | Yes |
| Удаленный компьютер | Yes |
| Имя удаленного компьютера и прямого формата | Yes |