MessageQueue.GetMessageEnumerator Yöntem

Tanım

Ad Alanı:

System.Messaging

Bütünleştirilmiş Kod:

System.Messaging.dll

Dikkat

This method returns a MessageEnumerator that implements RemoveCurrent family of methods incorrectly. Please use GetMessageEnumerator2 instead.

Kuyruktaki tüm iletiler için bir numaralandırıcı nesnesi oluşturur. GetMessageEnumerator() kullanım dışı bırakıldı. GetMessageEnumerator2() yerine kullanılmalıdır.

public:
 System::Messaging::MessageEnumerator ^ GetMessageEnumerator();

[System.Obsolete("This method returns a MessageEnumerator that implements RemoveCurrent family of methods incorrectly. Please use GetMessageEnumerator2 instead.")]
public System.Messaging.MessageEnumerator GetMessageEnumerator();

[<System.Obsolete("This method returns a MessageEnumerator that implements RemoveCurrent family of methods incorrectly. Please use GetMessageEnumerator2 instead.")>]
member this.GetMessageEnumerator : unit -> System.Messaging.MessageEnumerator

Public Function GetMessageEnumerator () As MessageEnumerator

Döndürülenler

MessageEnumerator

MessageEnumerator Kuyrukta yer alan iletileri tutan.

Öznitelikler

ObsoleteAttribute

Açıklamalar

GetMessageEnumerator bir kuyruktaki tüm iletilerin dinamik listesini oluşturur. Döndüren için arayarak RemoveCurrentMessageEnumeratorGetMessageEnumerator numaralandırıcının geçerli konumundaki iletiyi kuyruktan kaldırabilirsiniz.

İmleç kuyruktaki iletilerin dinamik listesiyle ilişkilendirildiğinden, ileti geçerli imleç konumunun ötesindeyse, numaralandırma kuyruktaki iletilerde yaptığınız değişiklikleri yansıtır. Örneğin, numaralandırıcı imlecin geçerli konumunun ötesine yerleştirilmiş düşük öncelikli bir iletiye otomatik olarak erişebilir, ancak bu konumdan önce eklenen daha yüksek öncelikli bir iletiye erişemez. Ancak, sabit listesini sıfırlayabilir ve böylece imleci çağırarak ResetMessageEnumeratorlistenin başına geri taşıyabilirsiniz.

Numaralandırmadaki iletilerin sırası kuyruktaki sıralarını yansıtır, bu nedenle daha yüksek öncelikli iletiler düşük öncelikli iletilerden önce görünür.

Kuyruktaki iletilerin dinamik bir bağlantı yerine statik anlık görüntüsünü istiyorsanız çağrısında bulunur GetAllMessages. Bu yöntem, yöntemin Message çağrıldığı sırada iletileri temsil eden bir nesne dizisi döndürü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	Mevcut
Yerel bilgisayar	Yes
Yerel bilgisayar ve doğrudan biçim adı	Yes
Uzak bilgisayar	Yes
Uzak bilgisayar ve doğrudan biçim adı	Yes

Ayrıca bkz.

• GetAllMessages()
• GetMessageEnumerator2()
• GetMessageQueueEnumerator()