MessageQueue.GetMessageEnumerator2 方法

定義

命名空間:

System.Messaging

組件:

System.Messaging.dll

為佇列中的所有訊息建立列舉值物件。

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

public System.Messaging.MessageEnumerator GetMessageEnumerator2 ();

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

Public Function GetMessageEnumerator2 () As MessageEnumerator

傳回

MessageEnumerator

MessageEnumerator，保有在佇列中所包含的訊息。

備註

GetMessageEnumerator2 會建立佇列中所有訊息的動態清單。 您可以呼叫 RemoveCurrentMessageEnumeratorGetMessageEnumerator2 傳回的 ，從佇列中移除位於列舉值目前位置的訊息。

由於數據指標與佇列中的訊息動態清單相關聯，因此如果訊息超出目前的數據指標位置，列舉會反映對佇列中訊息所做的任何修改。 例如，列舉值可以自動存取置於游標目前位置以外的較低優先順序訊息，但無法自動存取在該位置之前插入的較高優先順序訊息。 不過，您可以藉由呼叫 ResetMessageEnumerator來重設列舉，藉此將游標移回清單的開頭。

列舉中的訊息順序會反映其在佇列中的順序，因此優先順序較高的訊息會出現在優先順序較低的訊息之前。

如果您要佇列中訊息的靜態快照集，而不是與其動態連線，請呼叫 GetAllMessages。 這個方法會傳回 物件的陣列，這個陣列 Message 表示呼叫方法時所傳回的訊息。

下表顯示此方法是否可在各種工作組模式中使用。

工作組模式	可用
本機電腦	是
本機計算機和直接格式名稱	是
遠端電腦	是
遠端電腦和直接格式名稱	是

另請參閱

• GetAllMessages()
• GetMessageQueueEnumerator()