MessageQueue.GetAllMessages Yöntem

Tanım

Ad Alanı:

System.Messaging

Bütünleştirilmiş Kod:

System.Messaging.dll

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

Message[]

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

Özel durumlar

MessageQueueException

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

Ayrıca bkz.

• Message
• GetMessageEnumerator2()