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 表示呼叫方法時所傳回的訊息。
下表顯示此方法是否可在各種工作組模式中使用。
工作組模式 | 可用 |
---|---|
本機電腦 | 是 |
本機計算機和直接格式名稱 | 是 |
遠端電腦 | 是 |
遠端電腦和直接格式名稱 | 是 |