MessageQueueEnumerator クラス

[アーティクル]
03/28/2008

メッセージキュー内のメッセージを列挙するための前方向カーソルを提供します。

この型のすべてのメンバの一覧については、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++ のサンプルを表示するには、このページの左上隅にある言語のフィルタボタンをクリックします。

必要条件

名前空間: 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

次の方法で共有

MessageQueueEnumerator クラス

スレッドセーフ

解説

使用例

必要条件

参照

その他のリソース