MessageQueueEnumerator クラス
メッセージ キュー内のメッセージを列挙するための前方向カーソルを提供します。
この型のすべてのメンバの一覧については、MessageQueueEnumerator メンバ を参照してください。
System.Object
System.MarshalByRefObject
System.Messaging.MessageQueueEnumerator
Public Class MessageQueueEnumerator
Inherits MarshalByRefObject
Implements IEnumerator, IDisposable
[C#]
public class MessageQueueEnumerator : MarshalByRefObject,
IEnumerator, IDisposable
[C++]
public __gc class MessageQueueEnumerator : public
MarshalByRefObject, IEnumerator, IDisposable
[JScript]
public class MessageQueueEnumerator extends MarshalByRefObject
implements IEnumerator, IDisposable
スレッドセーフ
この型の public static (Visual Basicでは Shared) のすべてのメンバは、マルチスレッド操作で安全に使用できます。インスタンスのメンバの場合は、スレッドセーフであるとは限りません。
解説
ネットワーク上でのキューとの動的な対話には MessageQueueEnumerator を使います。 MessageQueue クラスを通じて使用できるメソッドは、キューの動的リストを含む MessageQueueEnumerator か、指定されたメソッドが呼び出された時点でのキューのコレクションのスナップショットを含む配列のいずれかを、返すことができます。
メモ ネットワークでのキューの順序は定義されていません。たとえば、コンピュータ、ラベル、パブリック/プライベート ステータス、またはユーザーがアクセスできる基準によって、キューを順序付けることはできません。 MessageQueueEnumerator はカーソルであり、初期化時に動的リストの先頭に配置されます。 MoveNext を呼び出すことで、このカーソルを列挙体の最初のキューに移動させることができます。列挙子が初期化された後に、 MoveNext を使って残りのキューを順に進んでいくことができます。
MessageQueueEnumerator で後方に移動することはできません。キュー列挙体の中では、カーソルは前方移動だけできます。しかし、 Reset を呼び出すと、列挙体をリセットしてカーソルを再びリストの先頭に置くことができます。列挙子は動的であるため、カーソルの現在位置より後に追加されるキューには、列挙子によってアクセスできます。しかし、カーソルの現在位置よりも前に挿入されているキューにアクセスするには、最初に Reset を呼び出す必要があります。
使用例
[Visual Basic, C#, C++] ネットワーク上のすべてのメッセージ キューを反復処理し、各キューのパスを取得する例を次に示します。この例では最後に、ネットワーク上のパブリック キューの数を表示します。
Imports System
Imports System.Messaging
Namespace MyProject
'/ <summary>
'/ Provides a container class for the example.
'/ </summary>
Public Class MyNewQueue
'**************************************************
' Provides an entry point into the application.
'
' This example uses a cursor to step through the
' message queues and list the public queues on the
' network.
'**************************************************
Public Shared Sub Main()
' Create a new instance of the class.
Dim myNewQueue As New MyNewQueue()
' Output the count of Lowest priority messages.
myNewQueue.ListPublicQueues()
Return
End Sub 'Main
'**************************************************
' Iterates through message queues and examines the
' path for each queue. Also displays the number of
' public queues on the network.
'**************************************************
Public Sub ListPublicQueues()
' Holds the count of private queues.
Dim numberQueues As Int32 = 0
' Get a cursor into the queues on the network.
Dim myQueueEnumerator As MessageQueueEnumerator = _
MessageQueue.GetMessageQueueEnumerator()
' Move to the next queue and read its path.
While myQueueEnumerator.MoveNext()
' Increase the count if the priority is Lowest.
Console.WriteLine(myQueueEnumerator.Current.Path)
numberQueues += 1
End While
' Display final count.
Console.WriteLine(("Number of public queues: " + _
numberQueues.ToString()))
Return
End Sub 'ListPublicQueues
End Class 'MyNewQueue
End Namespace 'MyProject
[C#]
using System;
using System.Messaging;
namespace MyProject
{
/// <summary>
/// Provides a container class for the example.
/// </summary>
public class MyNewQueue
{
//**************************************************
// Provides an entry point into the application.
//
// This example uses a cursor to step through the
// message queues and list the public queues on the
// network.
//**************************************************
public static void Main()
{
// Create a new instance of the class.
MyNewQueue myNewQueue = new MyNewQueue();
// Output the count of Lowest priority messages.
myNewQueue.ListPublicQueues();
return;
}
//**************************************************
// Iterates through message queues and examines the
// path for each queue. Also displays the number of
// public queues on the network.
//**************************************************
public void ListPublicQueues()
{
// Holds the count of private queues.
uint numberQueues = 0;
// Get a cursor into the queues on the network.
MessageQueueEnumerator myQueueEnumerator =
MessageQueue.GetMessageQueueEnumerator();
// Move to the next queue and read its path.
while(myQueueEnumerator.MoveNext())
{
// Increase the count if priority is Lowest.
Console.WriteLine(myQueueEnumerator.Current.Path);
numberQueues++;
}
// Display final count.
Console.WriteLine("Number of public queues: " +
numberQueues.ToString());
return;
}
}
}
[C++]
#using <mscorlib.dll>
#using <System.dll>
#using <System.Messaging.dll>
using namespace System;
using namespace System::Messaging;
//**************************************************
// Iterates through message queues and examines the
// path for each queue. Also displays the number of
// public queues on the network.
//**************************************************
void ListPublicQueues()
{
// Holds the count of private queues.
int numberQueues = 0;
// Get a cursor into the queues on the network.
MessageQueueEnumerator* myQueueEnumerator =
MessageQueue::GetMessageQueueEnumerator();
// Move to the next queue and read its path.
while(myQueueEnumerator->MoveNext())
{
// Increase the count if priority is Lowest.
Console::WriteLine(myQueueEnumerator->Current->Path);
numberQueues++;
}
// Display final count.
Console::WriteLine(S"Number of public queues: {0}", __box(numberQueues));
return;
}
//**************************************************
// Provides an entry point into the application.
//
// This example uses a cursor to step through the
// message queues and list the public queues on the
// network.
//**************************************************
int main()
{
// Output the count of Lowest priority messages.
ListPublicQueues();
}
[JScript] JScript のサンプルはありません。Visual Basic、C#、および C++ のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン .gif)
をクリックします。
必要条件
名前空間: System.Messaging
プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ
アセンブリ: System.Messaging (System.Messaging.dll 内)
参照
MessageQueueEnumerator メンバ | System.Messaging 名前空間 | MessageQueue | MessageQueue.GetMessageQueueEnumerator