MessageQueueEnumerator Kelas

Referensi

Definisi

Ruang nama:: System.Messaging

Rakitan:: System.Messaging.dll

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Menyediakan kursor terusan saja untuk menghitung pesan dalam antrean pesan.

public ref class MessageQueueEnumerator : MarshalByRefObject, IDisposable, System::Collections::IEnumerator

public class MessageQueueEnumerator : MarshalByRefObject, IDisposable, System.Collections.IEnumerator

type MessageQueueEnumerator = class
    inherit MarshalByRefObject
    interface IEnumerator
    interface IDisposable

Public Class MessageQueueEnumerator
Inherits MarshalByRefObject
Implements IDisposable, IEnumerator

Warisan: Object

MarshalByRefObject
MessageQueueEnumerator

Penerapan: IEnumerator IDisposable

Contoh

Contoh kode berikut melakukan iterasi melalui semua antrean pesan di jaringan, dan memeriksa jalur untuk setiap antrean. Terakhir, ini menampilkan jumlah antrean publik di jaringan.

#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( "Number of public queues: {0}", 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();
}

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;
        }
    }
}

Imports System.Messaging



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


        
        ' 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

End Class

Keterangan

Gunakan MessageQueueEnumerator untuk interaksi dinamis dengan antrean pada jaringan. Metode yang tersedia melalui MessageQueue kelas dapat mengembalikan MessageQueueEnumerator daftar antrean dinamis yang berisi, atau array yang berisi rekam jepret koleksi antrean pada saat metode yang ditentukan dipanggil.

Tidak ada urutan antrean yang ditentukan dalam jaringan. Mereka tidak diurutkan, misalnya, berdasarkan komputer, label, status publik atau privat, atau kriteria lain yang dapat diakses pengguna. MessageQueueEnumerator adalah kursor, diinisialisasi ke kepala daftar dinamis. Anda dapat memindahkan kursor ke antrean pertama enumerasi dengan memanggil MoveNext. Setelah enumerator diinisialisasi, Anda dapat menggunakan MoveNext untuk melangkah maju melalui antrean yang tersisa.

Tidak dimungkinkan untuk mundur dengan MessageQueueEnumerator. Kursor hanya memungkinkan pergerakan maju melalui enumerasi antrean. Namun, Anda dapat memanggil Reset untuk mengatur ulang enumerasi dan meletakkan kursor di awal daftar lagi. Karena enumerator bersifat dinamis, antrean yang ditambahkan di luar posisi kursor saat ini dapat diakses oleh enumerator. Antrean yang dimasukkan sebelum posisi kursor saat ini tidak dapat diakses tanpa terlebih dahulu memanggil Reset.

Properti

Current	Mendapatkan arus MessageQueue enumerasi.
LocatorHandle	Mendapatkan handel Antrean Pesan asli yang digunakan untuk menemukan antrean dalam jaringan.

Metode

Close()	Membebaskan sumber daya yang terkait dengan enumerator.
CreateObjRef(Type)	Membuat objek yang berisi semua informasi relevan yang diperlukan untuk menghasilkan proksi yang digunakan untuk berkomunikasi dengan objek jarak jauh. (Diperoleh dari MarshalByRefObject)
Dispose()	Merilis semua sumber daya yang MessageQueueEnumeratordigunakan oleh .
Dispose(Boolean)	Merilis sumber daya tidak terkelola yang MessageQueueEnumerator digunakan oleh dan secara opsional merilis sumber daya terkelola.
Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
Finalize()	Merilis sumber daya yang disimpan oleh antrean.
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetLifetimeService()	Kedaluwarsa. Mengambil objek layanan seumur hidup saat ini yang mengontrol kebijakan seumur hidup untuk instans ini. (Diperoleh dari MarshalByRefObject)
GetType()	Mendapatkan instans Type saat ini. (Diperoleh dari Object)
InitializeLifetimeService()	Kedaluwarsa. Mendapatkan objek layanan seumur hidup untuk mengontrol kebijakan seumur hidup untuk instans ini. (Diperoleh dari MarshalByRefObject)
MemberwiseClone()	Membuat salinan dangkal dari yang saat ini Object. (Diperoleh dari Object)
MemberwiseClone(Boolean)	Membuat salinan dangkal objek saat ini MarshalByRefObject . (Diperoleh dari MarshalByRefObject)
MoveNext()	Memajukan enumerator ke antrean enumerasi berikutnya, jika saat ini tersedia.
Reset()	Mengatur ulang kursor, sehingga menunjuk ke awal enumerasi.
ToString()	Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object)

Implementasi Antarmuka Eksplisit

IEnumerator.Current

Mendapatkan arus MessageQueue enumerasi.

Berlaku untuk