MessageQueue.GetMessageEnumerator Метод

public:
 System::Messaging::MessageEnumerator ^ GetMessageEnumerator();

public System.Messaging.MessageEnumerator GetMessageEnumerator();

[System.Obsolete("This method returns a MessageEnumerator that implements RemoveCurrent family of methods incorrectly. Please use GetMessageEnumerator2 instead.")]
public System.Messaging.MessageEnumerator GetMessageEnumerator();

member this.GetMessageEnumerator : unit -> System.Messaging.MessageEnumerator

[<System.Obsolete("This method returns a MessageEnumerator that implements RemoveCurrent family of methods incorrectly. Please use GetMessageEnumerator2 instead.")>]
member this.GetMessageEnumerator : unit -> System.Messaging.MessageEnumerator

Public Function GetMessageEnumerator () As MessageEnumerator

Возвращаемое значение

Удержание MessageEnumerator сообщений, содержащихся в очереди.

Атрибуты

ObsoleteAttribute

Комментарии

GetMessageEnumerator создает динамический список всех сообщений в очереди. Вы можете удалить сообщение из очереди в текущей позиции перечислителя, вызвав RemoveCurrentMessageEnumerator возвращаемый GetMessageEnumerator объект.

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

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

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

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

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

• GetAllMessages()
• GetMessageEnumerator2()
• GetMessageQueueEnumerator()