MessageQueue.GetAllMessages Metoda

Definice

Obor názvů:

System.Messaging

Sestavení:

System.Messaging.dll

Vrátí všechny zprávy, které jsou ve frontě.

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

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

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

Public Function GetAllMessages () As Message()

Návraty

Message[]

Pole typu Message , které představuje všechny zprávy ve frontě, ve stejném pořadí, v jakém se zobrazují ve frontě služby Řízení front zpráv.

Výjimky

MessageQueueException

Při přístupu k metodě řízení front zpráv došlo k chybě.

Příklady

Následující příklad kódu ukazuje použití 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);
}

Poznámky

GetAllMessages vrátí statický snímek zpráv ve frontě, nikoli dynamické odkazy na tyto zprávy. Proto nelze pole použít k úpravě zpráv ve frontě. Pokud chcete dynamickou interakci s frontou v reálném čase (například schopnost odstranit zprávy), zavolejte GetMessageEnumerator2 metodu, která vrátí dynamický seznam zpráv ve frontě.

Vzhledem k tomu GetAllMessages , že vrátí kopii zpráv ve frontě v době, kdy byla metoda volána, pole neodráží nové zprávy, které přicházejí do fronty nebo zprávy, které jsou z fronty odebrány.

GetAllMessages načte pouze tyto vlastnosti, které vlastnost nefiltruje MessageReadPropertyFilter .

Následující tabulka ukazuje, zda je tato metoda k dispozici v různých režimech pracovní skupiny.

Režim pracovní skupiny	K dispozici
Místní počítač	Ano
Název místního počítače a přímého formátu	Ano
Vzdálený počítač	Ne
Název vzdáleného počítače a přímého formátu	Ano

Viz také

• Message
• GetMessageEnumerator2()