MessageQueue.GetAllMessages Método

Definición

Espacio de nombres:

System.Messaging

Ensamblado:

System.Messaging.dll

Devuelve todos los mensajes que se encuentran en la cola.

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

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

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

Public Function GetAllMessages () As Message()

Devoluciones

Message[]

Matriz de tipo Message que representa todos los mensajes de la cola, en el mismo orden en que aparecen en la cola de Message Queuing.

Excepciones

MessageQueueException

Error al obtener acceso a un método de Message Queuing.

Ejemplos

En el siguiente ejemplo de código se muestra el 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);
}

Comentarios

GetAllMessages devuelve una instantánea estática de los mensajes de la cola, no vínculos dinámicos a esos mensajes. Por lo tanto, no puede usar la matriz para modificar los mensajes de la cola. Si desea una interacción dinámica en tiempo real con la cola (por ejemplo, la capacidad de eliminar mensajes), llame al GetMessageEnumerator2 método , que devuelve una lista dinámica de los mensajes de la cola.

Dado que GetAllMessages devuelve una copia de los mensajes de la cola en el momento en que se llamó al método , la matriz no refleja nuevos mensajes que llegan a la cola o mensajes que se quitan de la cola.

GetAllMessages recupera solo esas propiedades no filtradas por la MessageReadPropertyFilter propiedad .

En la tabla siguiente se muestra si este método está disponible en varios modos de grupo de trabajo.

Modo de grupo de trabajo	Disponible
Equipo local	Sí
Equipo local y nombre de formato directo	Sí
Equipo remoto	No
Equipo remoto y nombre de formato directo	Sí

Consulte también

• Message
• GetMessageEnumerator2()