Message.LookupId Properti

Definisi

Ruang nama:

System.Messaging

Rakitan:

System.Messaging.dll

Diperkenalkan di MSMQ 3.0. Mendapatkan pengidentifikasi pencarian pesan.

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

public long LookupId { get; }

member this.LookupId : int64

Public ReadOnly Property LookupId As Long

Nilai Properti

Int64

Pengidentifikasi pencarian pesan, yang dihasilkan oleh Antrean Pesan dan unik untuk antrean tempat pesan berada.

Pengecualian

PlatformNotSupportedException

MSMQ 3.0 tidak diinstal.

InvalidOperationException

Pesan belum dikirim. Properti ini hanya dapat dibaca pada pesan yang diambil dari antrean.

-atau-

Antrean pesan difilter untuk mengabaikan LookupId properti .

Keterangan

Properti LookupId menyediakan akses baca-saja ke pengidentifikasi pencarian pesan. Pengidentifikasi pencarian, yang diperkenalkan di MSMQ 3.0, adalah pengidentifikasi 64-bit yang dihasilkan oleh Antrean Pesan dan ditetapkan ke setiap pesan saat pesan ditempatkan dalam antrean. Pengidentifikasi pencarian tidak sama dengan pengidentifikasi pesan yang dihasilkan saat pesan dikirim.

Antrean Pesan menghasilkan pengidentifikasi pencarian untuk semua pesan yang ditempatkan dalam antrean apa pun, termasuk antrean tujuan, administrasi, dan laporan yang dihasilkan aplikasi, serta jurnal yang dihasilkan sistem, surat gagal, konektor, dan antrean keluar. Dengan kata lain, ini termasuk kedua pesan yang dikirim dengan mengirim aplikasi dan dengan Antrean Pesan. Pengidentifikasi pencarian unik untuk antrean dan tidak memiliki arti di luar antrean.

Jika pesan dikirim ke beberapa antrean tujuan, atau jika salinan pesan disimpan dalam jurnal komputer atau jurnal antrean, setiap salinan pesan akan memiliki pengidentifikasi pencarian sendiri ketika ditempatkan dalam antrean masing-masing.

Properti LookupId hanya dapat dibaca pada pesan yang diambil dari antrean.

Pengidentifikasi pencarian digunakan untuk membaca pesan tertentu dalam antrean. Setelah pengidentifikasi pencarian pesan diketahui, aplikasi penerima dapat memanggil atau ReceiveByLookupId berfungsi untuk langsung masuk ke pesan tersebut PeekByLookupId dan mengintip atau mengambilnya dari antrean, tidak seperti kursor yang harus dimulai di bagian depan antrean dan menavigasi ke akhir antrean,

Mendapatkan pengidentifikasi pencarian pesan dalam antrean adalah tanggung jawab aplikasi. Salah satu cara yang mungkin untuk mendapatkan pengidentifikasi pencarian adalah dengan membuat pemicu untuk antrean tujuan yang memanggil komponen yang menyimpan pengidentifikasi setiap pesan saat ditempatkan dalam antrean.

Lihat juga

• PeekByLookupId
• ReceiveByLookupId