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 的 從列舉器目前位置移除訊息。

由於游標與隊列中訊息的動態清單相關聯，列舉會反映你對佇列訊息所做的任何修改，若訊息超出當前游標位置。 例如，列舉器可以自動存取位於游標當前位置之外的低優先權訊息，但無法存取該位置之前插入的高優先權訊息。 不過，你可以透過呼叫 ResetMessageEnumerator。

列舉中訊息的順序反映了它們在佇列中的順序，因此高優先權訊息會先出現在低優先級訊息之前。

如果你想要佇列中訊息的靜態快照，而非動態連線，請呼叫 GetAllMessages。 此方法回傳一個物件陣列 Message ，代表呼叫時的訊息。

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

另請參閱

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