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