MessageQueue.GetAllMessages Metod

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

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

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

Public Function GetAllMessages () As Message()

Returer

En matris av typen Message som representerar alla meddelanden i kön, i samma ordning som de visas i kön Meddelandekö.

Undantag

Exempel

I följande kodexempel visas användningen av 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);
}

Kommentarer

GetAllMessages returnerar en statisk ögonblicksbild av meddelandena i kön, inte dynamiska länkar till dessa meddelanden. Därför kan du inte använda matrisen för att ändra meddelandena i kön. Om du vill ha dynamisk interaktion i realtid med kön (till exempel möjligheten att ta bort meddelanden) anropar GetMessageEnumerator2 du metoden som returnerar en dynamisk lista över meddelandena i kön.

Eftersom GetAllMessages returnerar en kopia av meddelandena i kön vid den tidpunkt då metoden anropades återspeglar matrisen inte nya meddelanden som tas emot i kön eller meddelanden som tas bort från kön.

GetAllMessages hämtar endast de egenskaper som inte filtreras bort av egenskapen MessageReadPropertyFilter .

I följande tabell visas om den här metoden är tillgänglig i olika arbetsgruppslägen.

Se även

• Message
• GetMessageEnumerator2()