MessageQueue.PeekByLookupId Metode
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. Mengintip pesan tertentu dari antrean. Pesan dapat ditentukan oleh pengidentifikasi pencarian atau dengan posisinya di bagian depan atau akhir antrean.
Overload
PeekByLookupId(Int64) |
Diperkenalkan di MSMQ 3.0. Mengintip pesan yang cocok dengan pengidentifikasi pencarian yang diberikan dari antrean non-transaksi. |
PeekByLookupId(MessageLookupAction, Int64) |
Diperkenalkan di MSMQ 3.0. Mengintip pesan tertentu dari antrean. Pesan dapat ditentukan oleh pengidentifikasi pencarian atau dengan posisinya di bagian depan atau akhir antrean. |
PeekByLookupId(Int64)
Diperkenalkan di MSMQ 3.0. Mengintip pesan yang cocok dengan pengidentifikasi pencarian yang diberikan dari antrean non-transaksi.
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
Parameter
Mengembalikan
Properti Message yang LookupId cocok dengan parameter yang lookupId
diteruskan.
Pengecualian
MSMQ 3.0 tidak diinstal.
Pesan dengan yang ditentukan lookupId
tidak dapat ditemukan.
Terjadi kesalahan saat mengakses metode Antrean Pesan.
Keterangan
Gunakan metode ini untuk membaca pesan dengan pengidentifikasi pencarian yang diketahui tanpa menghapusnya dari antrean. Metode ini segera melemparkan pengecualian jika pesan tidak ada dalam antrean.
Properti LookupId pesan unik untuk antrean tempat pesan berada, sehingga paling banyak akan ada satu pesan dalam antrean yang cocok dengan parameter yang diberikan lookupId
.
Untuk membaca pesan dengan pengidentifikasi pencarian tertentu dan menghapusnya dari antrean, gunakan ReceiveByLookupId metode .
Tabel berikut menunjukkan apakah metode ini tersedia dalam berbagai mode Grup Kerja.
Mode grup kerja | Tersedia |
---|---|
Komputer lokal | Ya |
Komputer lokal dan nama format langsung | Ya |
Komputer jarak jauh | Tidak |
Komputer jarak jauh dan nama format langsung | Ya |
Lihat juga
Berlaku untuk
PeekByLookupId(MessageLookupAction, Int64)
Diperkenalkan di MSMQ 3.0. Mengintip pesan tertentu dari antrean. Pesan dapat ditentukan oleh pengidentifikasi pencarian atau dengan posisinya di bagian depan atau akhir antrean.
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
Parameter
- action
- MessageLookupAction
Salah MessageLookupAction satu nilai, menentukan bagaimana pesan dibaca dalam antrean. Tentukan salah satu hal berikut ini:
MessageLookupAction.Current
: Mengintip pesan yang ditentukan oleh lookupId
.
MessageLookupAction.Next
: Mengintip pesan setelah pesan yang ditentukan oleh lookupId
.
MessageLookupAction.Previous
: Mengintip pesan sebelum pesan yang ditentukan oleh lookupId
.
MessageLookupAction.First
: Mengintip pesan pertama dalam antrean. Parameter lookupId
harus diatur ke 0.
MessageLookupAction.Last
: Mengintip pesan terakhir dalam antrean. Parameter lookupId
harus diatur ke 0.
- lookupId
- Int64
Pesan LookupId yang akan diintip, atau 0. 0 digunakan saat mengakses pesan pertama atau terakhir dalam antrean.
Mengembalikan
yang Message ditentukan oleh action
parameter dan lookupId
yang diteruskan.
Pengecualian
MSMQ 3.0 tidak diinstal.
Pesan dengan yang ditentukan lookupId
tidak dapat ditemukan.
Terjadi kesalahan saat mengakses metode Antrean Pesan.
Parameter action
bukan salah MessageLookupAction satu anggota.
Keterangan
Gunakan metode ini untuk membaca pesan dengan pengidentifikasi pencarian yang diketahui tanpa menghapusnya dari antrean. Metode ini segera melemparkan pengecualian jika pesan tidak ada dalam antrean.
Properti LookupId pesan unik untuk antrean tempat pesan berada, sehingga paling banyak akan ada satu pesan dalam antrean yang cocok dengan parameter yang diberikan lookupId
.
Untuk membaca pesan dengan pengidentifikasi tertentu dan menghapusnya dari antrean, gunakan ReceiveByLookupId metode .
Tabel berikut menunjukkan apakah metode ini tersedia dalam berbagai mode Grup Kerja.
Mode grup kerja | Tersedia |
---|---|
Komputer lokal | Ya |
Komputer lokal dan nama format langsung | Ya |
Komputer jarak jauh | Tidak |
Komputer jarak jauh dan nama format langsung | Ya |