Message.LookupId Özellik

Tanım

Ad Alanı:

System.Messaging

Bütünleştirilmiş Kod:

System.Messaging.dll

MSMQ 3.0'da kullanıma sunulmuştur. İletinin arama tanımlayıcısını alır.

public:
 property long LookupId { long get(); };

public long LookupId { get; }

member this.LookupId : int64

Public ReadOnly Property LookupId As Long

Özellik Değeri

Int64

İletinin Message Queuing tarafından oluşturulan ve iletinin bulunduğu kuyruğa özgü olan arama tanımlayıcısı.

Özel durumlar

PlatformNotSupportedException

MSMQ 3.0 yüklü değil.

InvalidOperationException

İleti gönderilmedi. Bu özellik yalnızca kuyruktan alınan iletilerde okunabilir.

-veya-

İleti kuyruğu, özelliğini yoksayacak LookupId şekilde filtrelenmiştir.

Açıklamalar

özelliği, LookupId iletinin arama tanımlayıcısına salt okunur erişim sağlar. MSMQ 3.0'da tanıtılan arama tanımlayıcısı, Message Queuing tarafından oluşturulan ve ileti kuyruğa yerleştirildiğinde her iletiye atanan 64 bitlik bir tanımlayıcıdır. Arama tanımlayıcısı, ileti gönderildiğinde oluşturulan ileti tanımlayıcısı ile aynı değildir.

Message Queuing, uygulama tarafından oluşturulan hedef, yönetim ve rapor kuyruklarının yanı sıra sistem tarafından oluşturulan günlük, teslim edilemeyen ileti, bağlayıcı ve giden kuyrukları da dahil olmak üzere herhangi bir kuyruğa yerleştirilen tüm iletiler için bir arama tanımlayıcısı oluşturur. Başka bir deyişle, bu hem uygulama göndererek hem de Message Queuing tarafından gönderilen iletileri içerir. Arama tanımlayıcısı kuyruğa özgüdür ve kuyruğun dışında bir anlamı yoktur.

bir ileti birkaç hedef kuyruğa gönderilirse veya iletinin bir kopyası bir bilgisayar günlüğünde veya kuyruk günlüğünde depolanıyorsa, iletinin her kopyası kendi kuyruğuna yerleştirildiğinde kendi arama tanımlayıcısına sahip olur.

LookupId özelliği yalnızca kuyruktan alınan iletilerde okunabilir.

Kuyruktaki belirli bir iletiyi okumak için arama tanımlayıcısı kullanılır. bir iletinin arama tanımlayıcısı bilindikten sonra, alıcı uygulama doğrudan o iletiye gitmek ve kuyruğun önünden başlayıp kuyruğun sonuna doğru gitmesi gereken imleçlerden farklı olarak kuyruktan göz atmak veya kuyruktan almak için or ReceiveByLookupId işlevini çağırabilirPeekByLookupId.

Kuyruktaki iletilerin arama tanımlayıcılarını almak uygulamanın sorumluluğundadır. Arama tanımlayıcılarını almanın olası yollarından biri, hedef kuyruk için her iletinin tanımlayıcılarını kuyruğa yerleştirilirken önbelleğe alan bir bileşeni çağıran bir tetikleyici oluşturmaktır.

Ayrıca bkz.

• PeekByLookupId
• ReceiveByLookupId