MessageQueue.GetMessageEnumerator2 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
为队列中的所有消息创建枚举数对象。
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 ,这些对象表示调用方法时的消息。
下表显示了此方法是否在各种工作组模式下可用。
工作组模式 | 可用 |
---|---|
本地计算机 | 是 |
本地计算机和直接格式名称 | 是 |
远程计算机 | 是 |
远程计算机和直接格式名称 | 是 |