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 создает динамический список всех сообщений в очереди. Вы можете удалить из очереди сообщение в текущей позиции перечислителя, вызвав RemoveCurrent для возвращаемого MessageEnumeratorGetMessageEnumerator2 объекта .

Поскольку курсор связан с динамическим списком сообщений в очереди, перечисление отражает любые изменения, внесенные в сообщения в очереди, если сообщение находится за пределами текущей позиции курсора. Например, перечислитель может автоматически обращаться к сообщению с более низким приоритетом, размещенном за пределами текущей позиции курсора, но не к сообщению с более высоким приоритетом, вставленным перед этой позицией. Однако можно сбросить перечисление, тем самым переместив курсор обратно в начало списка, вызвав Reset для MessageEnumerator.

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

Если требуется статическое snapshot сообщений в очереди, а не динамическое подключение к ним, вызовите .GetAllMessages Этот метод возвращает массив Message объектов , которые представляют сообщения на момент вызова метода.

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

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

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

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