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()

Retornos

Uma matriz do tipo Message que representa todas as mensagens na fila, na mesma ordem em que são exibidas na fila do serviço de Enfileiramento 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);
}

Comentários

GetAllMessagesretorna uma instantâneo estática das mensagens na fila, não links dinâmicos para essas mensagens. Portanto, você não pode usar a matriz para modificar as mensagens na fila. Se você quiser interação dinâmica em tempo real com a fila (como a capacidade de excluir mensagens), chame o GetMessageEnumerator2 método , que retorna uma lista dinâmica das mensagens na fila.

Como GetAllMessages retorna uma cópia das mensagens na fila no momento em que o método foi chamado, a matriz não reflete novas mensagens que chegam na fila ou mensagens que são removidas da fila.

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

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

Aplica-se a

Confira também

• Message
• GetMessageEnumerator2()