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 は、キュー内のすべてのメッセージの動的リストを作成します。 を返す を呼び出RemoveCurrentすことで、列挙子の現在の位置にあるメッセージをMessageEnumeratorGetMessageEnumerator2キューから削除できます。

カーソルはキュー内のメッセージの動的リストに関連付けられているため、メッセージが現在のカーソル位置を超えている場合、列挙はキュー内のメッセージに加えた変更を反映します。 たとえば、列挙子は、カーソルの現在の位置を超えて配置された優先度の低いメッセージに自動的にアクセスできますが、その位置の前に挿入された優先度の高いメッセージにはアクセスできません。 ただし、 を呼び出ResetMessageEnumeratorすことで列挙体をリセットし、カーソルをリストの先頭に戻すことができます。

列挙内のメッセージの順序はキュー内の順序を反映するため、優先度の高いメッセージは優先順位の低いメッセージの前に表示されます。

メッセージへの動的接続ではなく、キュー内のメッセージの静的スナップショットが必要な場合は、 を呼び出します GetAllMessages。 このメソッドは、 メソッドが呼び出されたときの Message メッセージを表す オブジェクトの配列を返します。

次の表は、このメソッドがさまざまなワークグループ モードで使用できるかどうかを示しています。

ワークグループ モード 利用可能
ローカル コンピューター はい
ローカル コンピューターと直接の形式名 はい
リモート コンピューター はい
リモート コンピューターと直接形式の名前 はい

適用対象

こちらもご覧ください