Compartilhar via


MessageQueue.GetAllMessages Método

Definição

Retorna todas as mensagens na fila.

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

Erro ao acessar um método do serviço de Enfileiramento de Mensagens.

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.

Modo de grupo de trabalho Disponível
Computador local Yes
Nome do computador local e do formato direto Yes
Computador remoto Não
Computador remoto e nome de formato direto Yes

Aplica-se a

Confira também