Bagikan melalui


MessageQueue.GetAllMessages Metode

Definisi

Mengembalikan semua pesan yang ada dalam antrean.

public:
 cli::array <System::Messaging::Message ^> ^ GetAllMessages();
public System.Messaging.Message[] GetAllMessages ();
member this.GetAllMessages : unit -> System.Messaging.Message[]
Public Function GetAllMessages () As Message()

Mengembalikan

Array jenis Message yang mewakili semua pesan dalam antrean, dalam urutan yang sama seperti yang muncul dalam antrean Antrean Pesan.

Pengecualian

Terjadi kesalahan saat mengakses metode Antrean Pesan.

Contoh

Contoh kode berikut menunjukkan penggunaan GetAllMessages.


// Connect to a queue on the local computer.
MessageQueue^ queue = gcnew MessageQueue(".\\exampleQueue");

// Populate an array with copies of all the messages in the queue.
array<Message^>^ msgs = queue->GetAllMessages();

// Loop through the messages.
for each(Message^ msg in msgs)
{
    // Display the label of each message.
    Console::WriteLine(msg->Label);
}

queue->Close();

// Connect to a queue on the local computer.
MessageQueue queue = new MessageQueue(".\\exampleQueue");

// Populate an array with copies of all the messages in the queue.
Message[] msgs = queue.GetAllMessages();

// Loop through the messages.
foreach(Message msg in msgs)
{
    // Display the label of each message.
    Console.WriteLine(msg.Label);
}

Keterangan

GetAllMessages mengembalikan rekam jepret statis pesan dalam antrean, bukan tautan dinamis ke pesan tersebut. Oleh karena itu, Anda tidak dapat menggunakan array untuk mengubah pesan dalam antrean. Jika Anda menginginkan interaksi dinamis secara real time dengan antrean (seperti kemampuan untuk menghapus pesan), panggil GetMessageEnumerator2 metode , yang mengembalikan daftar dinamis pesan dalam antrean.

Karena GetAllMessages mengembalikan salinan pesan dalam antrean pada saat metode dipanggil, array tidak mencerminkan pesan baru yang tiba dalam antrean atau pesan yang dihapus dari antrean.

GetAllMessages hanya mengambil properti yang tidak difilter oleh MessageReadPropertyFilter properti .

Tabel berikut ini memperlihatkan 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 Tidak
Komputer jarak jauh dan nama format langsung Ya

Berlaku untuk

Lihat juga