MessageQueue.GetAllMessages Metódus

Definíció

Névtér:

System.Messaging

Szerelvény:

System.Messaging.dll

Visszaadja az üzenetsor összes üzenetét.

public:
 cli::array <System::Messaging::Message ^> ^ GetAllMessages();

public System.Messaging.Message[] GetAllMessages();

member this.GetAllMessages : unit -> System.Messaging.Message[]

Public Function GetAllMessages () As Message()

Válaszok

Message[]

Olyan típusú Message tömb, amely az üzenetsor összes üzenetét jelöli, ugyanabban a sorrendben, mint a Message Queueing üzenetsorban.

Kivételek

MessageQueueException

Hiba történt a Message Queuing metódus elérésekor.

Példák

Az alábbi példakód bemutatja a használatát 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);
}

Megjegyzések

GetAllMessages Statikus pillanatképet ad vissza az üzenetsorban lévő üzenetekről, nem pedig ezekre az üzenetekre mutató dinamikus hivatkozásokat. Ezért nem használhatja a tömböt az üzenetsor üzenetsorában lévő üzenetek módosítására. Ha valós idejű, dinamikus interakcióra van szüksége az üzenetsorsal (például az üzenetek törlésének lehetőségével), hívja meg a GetMessageEnumerator2 metódust, amely az üzenetsor üzeneteinek dinamikus listáját adja vissza.

Mivel GetAllMessages a metódus meghívásakor az üzenetsor üzeneteinek másolatát adja vissza, a tömb nem tükrözi az üzenetsorba érkező új üzeneteket, illetve az üzenetsorból eltávolított üzeneteket.

GetAllMessages csak azokat a tulajdonságokat kéri le, amelyeket MessageReadPropertyFilter a tulajdonság nem szűr ki.

Az alábbi táblázat azt mutatja be, hogy ez a módszer elérhető-e különböző munkacsoport-módban.

Munkacsoport mód	Elérhető
Helyi számítógép	Igen
Helyi számítógép és közvetlen formátum neve	Igen
Távoli számítógép	No
Távoli számítógép és közvetlen formátum neve	Igen

Lásd még

• Message
• GetMessageEnumerator2()