MessageQueue.GetAllMessages Metodo

Definizione

Spazio dei nomi:

System.Messaging

Assembly:

System.Messaging.dll

Restituisce tutti i messaggi presenti nella coda.

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

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

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

Public Function GetAllMessages () As Message()

Restituisce

Message[]

Matrice di tipo Message che rappresenta tutti i messaggi nella coda nello stesso ordine in cui vengono visualizzati nella coda di Accodamento messaggi.

Eccezioni

MessageQueueException

Si è verificato un errore durante l'accesso a un metodo di Accodamento messaggi.

Esempio

L'esempio di codice seguente illustra l'uso di 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);
}

Commenti

GetAllMessages restituisce uno snapshot statico dei messaggi nella coda, non i collegamenti dinamici a tali messaggi. Pertanto, non è possibile utilizzare la matrice per modificare i messaggi nella coda. Se si desidera un'interazione dinamica in tempo reale con la coda , ad esempio la possibilità di eliminare i messaggi, chiamare il GetMessageEnumerator2 metodo , che restituisce un elenco dinamico dei messaggi nella coda.

Poiché GetAllMessages restituisce una copia dei messaggi nella coda al momento della chiamata al metodo, la matrice non riflette i nuovi messaggi che arrivano nella coda o i messaggi rimossi dalla coda.

GetAllMessages recupera solo le proprietà non filtrate in base alla MessageReadPropertyFilter proprietà .

Nella tabella seguente viene illustrato se questo metodo è disponibile in varie modalità gruppo di lavoro.

Modalità gruppo di lavoro	Disponibile
Computer locale	Sì
Computer locale e nome del formato diretto	Sì
Computer remoto	No
Nome del formato diretto e del computer remoto	Sì

Vedi anche

• Message
• GetMessageEnumerator2()