MessageQueue.GetAllMessages Yöntem

Tanım

Kuyruktaki tüm iletileri döndürür.

public:
 cli::array <System::Messaging::Message ^> ^ GetAllMessages();
public System.Messaging.Message[] GetAllMessages ();
member this.GetAllMessages : unit -> System.Messaging.Message[]
Public Function GetAllMessages () As Message()

Döndürülenler

Kuyruktaki tüm iletileri Message Queuing kuyruğunda göründükleri sırayla temsil eden tür Message dizisi.

Özel durumlar

Message Queuing yöntemine erişilirken bir hata oluştu.

Örnekler

Aşağıdaki kod örneğinde kullanımı gösterilmektedir 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);
}

Açıklamalar

GetAllMessages kuyruktaki iletilerin statik anlık görüntüsünü döndürür, bu iletilere dinamik bağlantılar döndürmez. Bu nedenle, diziyi kuyruktaki iletileri değiştirmek için kullanamazsınız. Gerçek zamanlı, kuyrukla dinamik etkileşim istiyorsanız (iletileri silme özelliği gibi), kuyruktaki iletilerin GetMessageEnumerator2 dinamik listesini döndüren yöntemini çağırın.

GetAllMessages Yöntemin çağrıldığı sırada kuyruktaki iletilerin bir kopyasını döndürdüğünden, dizi kuyruğa gelen yeni iletileri veya kuyruktan kaldırılan iletileri yansıtmaz.

GetAllMessages yalnızca özelliği tarafından MessageReadPropertyFilter filtrelenmemiş özellikleri alır.

Aşağıdaki tabloda bu yöntemin çeşitli Çalışma Grubu modlarında kullanılabilir olup olmadığı gösterilmektedir.

Çalışma grubu modu Kullanılabilir
Yerel bilgisayar Yes
Yerel bilgisayar ve doğrudan biçim adı Yes
Uzak bilgisayar No
Uzak bilgisayar ve doğrudan biçim adı Yes

Şunlara uygulanır

Ayrıca bkz.