MessageQueue.PeekByLookupId Yöntem

Tanım

Ad Alanı:

System.Messaging

Bütünleştirilmiş Kod:

System.Messaging.dll

MSMQ 3.0'da kullanıma sunulmuştur. Kuyruktan belirli bir iletiye göz atar. İleti bir arama tanımlayıcısı tarafından veya kuyruğun önündeki veya sonundaki konumuyla belirtilebilir.

Aşırı Yüklemeler

Name	Description
PeekByLookupId(Int64)	MSMQ 3.0'da kullanıma sunulmuştur. İşlem dışı bir kuyruktan verilen arama tanımlayıcısı ile eşleşen iletiye göz atar.
PeekByLookupId(MessageLookupAction, Int64)	MSMQ 3.0'da kullanıma sunulmuştur. Kuyruktan belirli bir iletiye göz atar. İleti bir arama tanımlayıcısı tarafından veya kuyruğun önündeki veya sonundaki konumuyla belirtilebilir.

PeekByLookupId(Int64)

MSMQ 3.0'da kullanıma sunulmuştur. İşlem dışı bir kuyruktan verilen arama tanımlayıcısı ile eşleşen iletiye göz atar.

public:
 System::Messaging::Message ^ PeekByLookupId(long lookupId);

public System.Messaging.Message PeekByLookupId(long lookupId);

member this.PeekByLookupId : int64 -> System.Messaging.Message

Public Function PeekByLookupId (lookupId As Long) As Message

Parametreler

lookupId

Int64

Göz LookupId atacak iletinin.

Döndürülenler

Message

özelliği MessageLookupId geçirilen parametreyle lookupId eşleşir.

Özel durumlar

PlatformNotSupportedException

MSMQ 3.0 yüklü değil.

InvalidOperationException

Belirtilen lookupId ileti bulunamadı.

MessageQueueException

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

Açıklamalar

Kuyruktan kaldırmadan bilinen arama tanımlayıcısına sahip bir iletiyi okumak için bu yöntemi kullanın. İleti kuyrukta değilse bu yöntem hemen bir özel durum oluşturur.

İletinin LookupId özelliği, iletinin bulunduğu kuyruğa özeldir, bu nedenle kuyrukta verilen lookupId parametreyle eşleşen en fazla bir ileti olur.

Belirtilen arama tanımlayıcısına sahip bir iletiyi okumak ve kuyruktan kaldırmak için yöntemini kullanın ReceiveByLookupId .

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	Evet
Yerel bilgisayar ve doğrudan biçim adı	Evet
Uzak bilgisayar	Hayır
Uzak bilgisayar ve doğrudan biçim adı	Evet

Ayrıca bkz.

• LookupId
• ReceiveByLookupId

PeekByLookupId(MessageLookupAction, Int64)

MSMQ 3.0'da kullanıma sunulmuştur. Kuyruktan belirli bir iletiye göz atar. İleti bir arama tanımlayıcısı tarafından veya kuyruğun önündeki veya sonundaki konumuyla belirtilebilir.

public:
 System::Messaging::Message ^ PeekByLookupId(System::Messaging::MessageLookupAction action, long lookupId);

public System.Messaging.Message PeekByLookupId(System.Messaging.MessageLookupAction action, long lookupId);

member this.PeekByLookupId : System.Messaging.MessageLookupAction * int64 -> System.Messaging.Message

Public Function PeekByLookupId (action As MessageLookupAction, lookupId As Long) As Message

Parametreler

action

MessageLookupAction

İletinin kuyrukta MessageLookupAction nasıl okunacağını belirten değerlerden biri. Aşağıdakilerden birini belirtin:

MessageLookupAction.Current: tarafından lookupIdbelirtilen iletiye göz atar.

MessageLookupAction.Next: tarafından lookupIdbelirtilen iletiyi izleyen iletiye göz atar.

MessageLookupAction.Previous: tarafından lookupIdbelirtilen iletiden önceki iletiye göz atar.

MessageLookupAction.First: Kuyruktaki ilk iletiye göz atar. lookupId parametresi 0 olarak ayarlanmalıdır.

MessageLookupAction.Last: Kuyruktaki son iletiye göz atar. lookupId parametresi 0 olarak ayarlanmalıdır.

lookupId

Int64

Göz LookupId atacak iletinin veya 0. 0, kuyruktaki ilk veya son iletiye erişirken kullanılır.

Döndürülenler

Message

Message geçirilen ve lookupId parametreleri tarafından action belirtilen.

Özel durumlar

PlatformNotSupportedException

MSMQ 3.0 yüklü değil.

InvalidOperationException

Belirtilen lookupId ileti bulunamadı.

MessageQueueException

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

InvalidEnumArgumentException

action parametresi üyelerden MessageLookupAction biri değildir.

Açıklamalar

Kuyruktan kaldırmadan bilinen arama tanımlayıcısına sahip bir iletiyi okumak için bu yöntemi kullanın. İleti kuyrukta değilse bu yöntem hemen bir özel durum oluşturur.

İletinin LookupId özelliği, iletinin bulunduğu kuyruğa özeldir, bu nedenle kuyrukta verilen lookupId parametreyle eşleşen en fazla bir ileti olur.

Belirtilen tanımlayıcıya sahip bir iletiyi okumak ve kuyruktan kaldırmak için yöntemini kullanın ReceiveByLookupId .

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	Evet
Yerel bilgisayar ve doğrudan biçim adı	Evet
Uzak bilgisayar	Hayır
Uzak bilgisayar ve doğrudan biçim adı	Evet

Ayrıca bkz.

• LookupId
• ReceiveByLookupId