MessageQueue.GetMessageEnumerator2 メソッド

.NET Framework クラス ライブラリ リファレンス

MessageQueue.GetMessageEnumerator2 メソッド

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

キューにあるすべてのメッセージに対して列挙子オブジェクトを作成します。

名前空間: System.Messaging
アセンブリ: System.Messaging (system.messaging.dll 内)
構文

Visual Basic (宣言)

Public Function GetMessageEnumerator2 As
 MessageEnumerator

Visual Basic (使用法)

Dim instance As MessageQueue
Dim returnValue As MessageEnumerator

returnValue = instance.GetMessageEnumerator2

C#

public MessageEnumerator GetMessageEnumerator2 ()

C++

public:
MessageEnumerator^ GetMessageEnumerator2 ()

J#

public MessageEnumerator GetMessageEnumerator2 ()

JScript

public function GetMessageEnumerator2 () :
 MessageEnumerator

戻り値
キューに含まれるメッセージを保持する MessageEnumerator。

解説

GetMessageEnumerator2 は、キューにあるすべてのメッセージの動的リストを作成します。GetMessageEnumerator2 が返す MessageEnumerator に対して RemoveCurrent を呼び出して、列挙子の現在の位置にあるメッセージをキューから削除できます。

カーソルは、キューにあるメッセージの動的リストに関連付けられるため、メッセージが現在のカーソル位置よりも後ろにあれば、列挙体はキューのメッセージに対して行った変更を反映します。たとえば、カーソルの現在位置よりも後ろに配置された優先順位が低いメッセージに列挙子は自動的にアクセスできます。しかし、その位置よりも前に挿入された優先順位が高いメッセージにはアクセスできません。ただし、列挙体はリセットできます。つまり、MessageEnumerator に対して Reset を呼び出して、リストの先頭にカーソルを戻すことができます。

列挙体の中でのメッセージの順序は、キューの中での順序を反映します。そのため、優先順位が高いメッセージは、優先順位が低いメッセージよりも前に出現します。

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

このメソッドが各種のワークグループ モードで使用できるかどうかを次の表に示します。

ワークグループ モード	使用可否
ローカル コンピュータ	○
ローカル コンピュータと直接書式名	○
リモート コンピュータ	○
リモート コンピュータと直接書式名	はい

.NET Framework のセキュリティ

• 直前の呼び出し元に対する完全な信頼。このメンバは、部分的に信頼されているコードから使用することはできません。詳細については、「」を参照してください。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
MessageQueue クラス
MessageQueue メンバ
System.Messaging 名前空間
GetAllMessages
GetMessageQueueEnumerator