MessageQueue.PeekByLookupId Yöntem

Tanım

Ad Alanı:

System.Messaging

Bütünleştirilmiş Kod:

System.Messaging.dll

MSMQ 3.0'da tanıtıldı. Kuyruktan belirli bir iletiye göz atarak. İleti bir arama tanımlayıcısı tarafından veya kuyruğun önündeki veya sonundaki konumuyla belirtilebilir.

Aşırı Yüklemeler

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

PeekByLookupId(Int64)

MSMQ 3.0'da tanıtıldı. İşlem dışı bir kuyruktan verilen arama tanımlayıcısı ile eşleşen iletiye göz atarak.

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 LookupId geçirilen Message 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	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.

• LookupId
• ReceiveByLookupId

PeekByLookupId(MessageLookupAction, Int64)

MSMQ 3.0'da tanıtıldı. Kuyruktan belirli bir iletiye göz atarak. İ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ğıdaki birini belirtin:

MessageLookupAction.Current: tarafından belirtilen iletiye göz atarak lookupId.

MessageLookupAction.Next: tarafından belirtilen iletiyi izleyen iletiye göz atarak lookupId.

MessageLookupAction.Previous: tarafından belirtilen iletiden önceki iletiye göz atarak lookupId.

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

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

lookupId

Int64

Göz LookupId atacak iletinin veya 0'ın. 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	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.

• LookupId
• ReceiveByLookupId