MessageQueue.GetMessageEnumerator2 Metode
Definisi
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.
Membuat objek enumerator untuk semua pesan dalam antrean.
public:
System::Messaging::MessageEnumerator ^ GetMessageEnumerator2();
public System.Messaging.MessageEnumerator GetMessageEnumerator2 ();
member this.GetMessageEnumerator2 : unit -> System.Messaging.MessageEnumerator
Public Function GetMessageEnumerator2 () As MessageEnumerator
Mengembalikan
Yang MessageEnumerator menyimpan pesan yang terkandung dalam antrean.
Keterangan
GetMessageEnumerator2 membuat daftar dinamis semua pesan dalam antrean. Anda dapat menghapus dari antrean pesan di posisi enumerator saat ini dengan memanggil RemoveCurrentMessageEnumerator yang GetMessageEnumerator2 kembali.
Karena kursor dikaitkan dengan daftar dinamis pesan dalam antrean, enumerasi mencerminkan modifikasi apa pun yang Anda lakukan 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 ResetMessageEnumerator.
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 | Tersedia |
---|---|
Komputer lokal | Ya |
Komputer lokal dan nama format langsung | Ya |
Komputer jarak jauh | Ya |
Komputer jarak jauh dan nama format langsung | Ya |