MessageQueue.GetMessageEnumerator Metode

Definisi

Ruang nama:

System.Messaging

Rakitan:

System.Messaging.dll

Perhatian

This method returns a MessageEnumerator that implements RemoveCurrent family of methods incorrectly. Please use GetMessageEnumerator2 instead.

Membuat objek enumerator untuk semua pesan dalam antrean. GetMessageEnumerator() tidak digunakan lagi. GetMessageEnumerator2() harus digunakan sebagai gantinya.

public:
 System::Messaging::MessageEnumerator ^ GetMessageEnumerator();

[System.Obsolete("This method returns a MessageEnumerator that implements RemoveCurrent family of methods incorrectly. Please use GetMessageEnumerator2 instead.")]
public System.Messaging.MessageEnumerator GetMessageEnumerator();

[<System.Obsolete("This method returns a MessageEnumerator that implements RemoveCurrent family of methods incorrectly. Please use GetMessageEnumerator2 instead.")>]
member this.GetMessageEnumerator : unit -> System.Messaging.MessageEnumerator

Public Function GetMessageEnumerator () As MessageEnumerator

Mengembalikan

MessageEnumerator

Menahan MessageEnumerator pesan yang terkandung dalam antrean.

Atribut

ObsoleteAttribute

Keterangan

GetMessageEnumerator membuat daftar dinamis semua pesan dalam antrean. Anda dapat menghapus dari antrean pesan pada posisi enumerator saat ini dengan memanggil RemoveCurrent pengembalian MessageEnumerator tersebutGetMessageEnumerator.

Karena kursor dikaitkan dengan daftar dinamis pesan dalam antrean, enumerasi mencerminkan modifikasi apa pun yang Anda buat pada pesan dalam antrean, jika pesan berada di luar posisi kursor saat ini. Misalnya, enumerator dapat secara otomatis mengakses pesan berprioritas lebih rendah yang ditempatkan di luar posisi kursor saat ini, tetapi bukan pesan berprioritas lebih tinggi yang disisipkan sebelum posisi tersebut. Namun, Anda dapat mengatur ulang enumerasi, sehingga memindahkan kursor kembali ke awal daftar, dengan memanggil Reset .MessageEnumerator

Urutan pesan dalam enumerasi mencerminkan urutannya dalam antrean, sehingga pesan berprioritas lebih tinggi akan muncul sebelum pesan berprioritas lebih rendah.

Jika Anda menginginkan rekam jepret statis pesan dalam antrean daripada koneksi dinamis ke pesan tersebut, panggil GetAllMessages. Metode ini mengembalikan array Message objek, yang mewakili pesan pada saat metode dipanggil.

Tabel berikut menunjukkan apakah metode ini tersedia dalam berbagai mode Grup Kerja.

Mode grup kerja	Available
Komputer lokal	Ya
Komputer lokal dan nama format langsung	Ya
Komputer jarak jauh	Ya
Komputer jarak jauh dan nama format langsung	Ya

Lihat juga

• GetAllMessages()
• GetMessageEnumerator2()
• GetMessageQueueEnumerator()