MessageQueue.GetMessageEnumerator2 メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
キューにあるすべてのメッセージに対して列挙子オブジェクトを作成します。
public:
System::Messaging::MessageEnumerator ^ GetMessageEnumerator2();public System.Messaging.MessageEnumerator GetMessageEnumerator2 ();member this.GetMessageEnumerator2 : unit -> System.Messaging.MessageEnumeratorPublic Function GetMessageEnumerator2 () As MessageEnumerator戻り値
キューに含まれるメッセージを保持する MessageEnumerator。
注釈
GetMessageEnumerator2 は、キュー内のすべてのメッセージの動的リストを作成します。 を返す を呼び出RemoveCurrentすことで、列挙子の現在の位置にあるメッセージをMessageEnumeratorGetMessageEnumerator2キューから削除できます。
カーソルはキュー内のメッセージの動的リストに関連付けられているため、メッセージが現在のカーソル位置を超えている場合、列挙はキュー内のメッセージに加えた変更を反映します。 たとえば、列挙子は、カーソルの現在の位置を超えて配置された優先度の低いメッセージに自動的にアクセスできますが、その位置の前に挿入された優先度の高いメッセージにはアクセスできません。 ただし、 を呼び出ResetMessageEnumeratorすことで列挙体をリセットし、カーソルをリストの先頭に戻すことができます。
列挙内のメッセージの順序はキュー内の順序を反映するため、優先順位の高いメッセージは優先順位の低いメッセージの前に表示されます。
メッセージへの動的接続ではなく、キュー内のメッセージの静的なスナップショットが必要な場合は、 を呼び出しますGetAllMessages。 このメソッドは、 メソッドが呼び出されたときの Message メッセージを表す オブジェクトの配列を返します。
次の表は、このメソッドがさまざまなワークグループ モードで使用できるかどうかを示しています。
| ワークグループ モード | 利用可能 |
|---|---|
| ローカル コンピューター | はい |
| ローカル コンピューターと直接の形式名 | はい |
| リモート コンピューター | はい |
| リモート コンピューターと直接形式の名前 | はい |
適用対象
こちらもご覧ください
.NET