MessageQueue.GetAllMessages Método

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

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

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

Public Function GetAllMessages () As Message()

Devoluções

Um array de tipo Message que representa todas as mensagens na fila, na mesma ordem em que aparecem na fila de Fila de Mensagens.

Exceções

Exemplos

O exemplo de código a seguir demonstra o uso de 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);
}

Observações

GetAllMessages devolve um instantâneo estático das mensagens na fila, não ligações dinâmicas a essas mensagens. Portanto, não pode usar o array para modificar as mensagens na fila. Se quiser interação dinâmica em tempo real com a fila (como a capacidade de apagar mensagens), chame o GetMessageEnumerator2 método, que devolve uma lista dinâmica das mensagens na fila.

Como GetAllMessages devolve uma cópia das mensagens na fila no momento em que o método foi chamado, o array não reflete as novas mensagens que chegam à fila nem as mensagens que são removidas da fila.

GetAllMessages recupera apenas as propriedades que não são filtradas pela MessageReadPropertyFilter propriedade.

A tabela seguinte mostra se este método está disponível em vários modos de Grupo de Trabalho.

Ver também

• Message
• GetMessageEnumerator2()