Message.LookupId Properti
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Diperkenalkan di MSMQ 3.0. Mendapatkan pengidentifikasi pencarian pesan.
public:
property long LookupId { long get(); };public long LookupId { get; }member this.LookupId : int64Public ReadOnly Property LookupId As LongNilai Properti
Pengidentifikasi pencarian pesan, yang dihasilkan oleh Antrean Pesan dan unik untuk antrean tempat pesan berada.
Pengecualian
MSMQ 3.0 tidak diinstal.
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.
