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 创建队列中所有消息的动态列表。 可以通过调用 RemoveCurrentMessageEnumeratorGetMessageEnumerator2 返回的 从队列中删除枚举器当前位置的消息。

由于游标与队列中消息的动态列表相关联,因此如果消息超出当前游标位置,则枚举将反映对队列中消息所做的任何修改。 例如,枚举器可以自动访问放置在光标当前位置之外的低优先级消息,但不能访问在该位置之前插入的较高优先级消息。 但是,可以通过调用 ResetMessageEnumerator来重置枚举,从而将光标移回列表的开头。

枚举中消息的顺序反映了它们在队列中的顺序,因此优先级较高的消息将出现在优先级较低的消息之前。

如果需要队列中消息的静态快照而不是动态连接,请调用 GetAllMessages。 此方法返回对象数组 Message ,这些对象表示调用方法时的消息。

下表显示了此方法是否在各种工作组模式下可用。

工作组模式 可用
本地计算机
本地计算机和直接格式名称
远程计算机
远程计算机和直接格式名称

适用于

另请参阅