MessageQueue.GetAllMessages Metode

Definisi

Ruang nama:

System.Messaging

Rakitan:

System.Messaging.dll

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

Message[]

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

Pengecualian

MessageQueueException

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

Lihat juga

• Message
• GetMessageEnumerator2()