MessageQueue.GetMessageEnumerator2 MessageQueue.GetMessageEnumerator2 MessageQueue.GetMessageEnumerator2 MessageQueue.GetMessageEnumerator2 Method

Определение

Создает объект перечислителя для всех сообщений очереди.Creates an enumerator object for all the messages in the queue.

public:
 System::Messaging::MessageEnumerator ^ GetMessageEnumerator2();
public System.Messaging.MessageEnumerator GetMessageEnumerator2 ();
member this.GetMessageEnumerator2 : unit -> System.Messaging.MessageEnumerator
Public Function GetMessageEnumerator2 () As MessageEnumerator

Возвраты

Объект MessageEnumerator содержащий сообщения, которые находятся в очереди.The MessageEnumerator holding the messages that are contained in the queue.

Комментарии

GetMessageEnumerator2создает динамический список всех сообщений в очереди.GetMessageEnumerator2 creates a dynamic list of all the messages in a queue. Можно удалить из очереди сообщение в текущей позиции перечислителя, вызвав метод RemoveCurrent MessageEnumerator для, который GetMessageEnumerator2 возвращает.You can remove from the queue the message at the enumerator's current position by calling RemoveCurrent for the MessageEnumerator that GetMessageEnumerator2 returns.

Поскольку курсор связан с динамическим списком сообщений в очереди, перечисление отражает любые изменения, внесенные в сообщения в очереди, если сообщение находится за пределами текущего положения курсора.Because the cursor is associated with the dynamic list of messages in the queue, the enumeration reflects any modification you make to the messages in the queue, if the message is beyond the current cursor position. Например, перечислитель может автоматически получить доступ к сообщениям с низким приоритетом, размещенному за пределами текущей позиции курсора, но не с более высоким приоритетом сообщением, вставленным перед этой позицией.For example, the enumerator can automatically access a lower-priority message placed beyond the cursor's current position, but not a higher-priority message inserted before that position. Однако можно сбросить перечисление, таким образом переместив курсор обратно в начало списка, вызвав метод Reset MessageEnumeratorдля.However, you can reset the enumeration, thereby moving the cursor back to the beginning of the list, by calling Reset for the MessageEnumerator.

Порядок сообщений в перечислении отражает порядок их следования в очереди, поэтому сообщения с более высоким приоритетом будут отображаться до приоритетов.The order of the messages in the enumeration reflects their order in the queue, so higher-priority messages will appear before lower-priority ones.

Если требуется статический моментальный снимок сообщений в очереди, а не динамическое соединение с ними, вызовите GetAllMessages.If you want a static snapshot of the messages in the queue rather than a dynamic connection to them, call GetAllMessages. Этот метод возвращает массив Message объектов, которые представляют сообщения на момент вызова метода.This method returns an array of Message objects, which represent the messages at the time the method was called.

В следующей таблице показано, доступен ли этот метод в различных режимах рабочей группы.The following table shows whether this method is available in various Workgroup modes.

Режим рабочей группыWorkgroup mode ДоступноAvailable
Локальный компьютерLocal computer ДаYes
Локальный компьютер и прямое имя форматаLocal computer and direct format name ДаYes
Удаленный компьютерRemote computer ДаYes
Удаленный компьютер и прямое имя форматаRemote computer and direct format name ДаYes

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

Дополнительно