MessageQueue.PeekByLookupId Metode

Definisi

Ruang nama:

System.Messaging

Rakitan:

System.Messaging.dll

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

lookupId

Int64

Pesan LookupId yang akan diintip.

Mengembalikan

Message

Properti Message yang LookupId cocok dengan parameter yang lookupId diteruskan.

Pengecualian

PlatformNotSupportedException

MSMQ 3.0 tidak diinstal.

InvalidOperationException

Pesan dengan yang ditentukan lookupId tidak dapat ditemukan.

MessageQueueException

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

• LookupId
• ReceiveByLookupId

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

Message

yang Message ditentukan oleh action parameter dan lookupId yang diteruskan.

Pengecualian

PlatformNotSupportedException

MSMQ 3.0 tidak diinstal.

InvalidOperationException

Pesan dengan yang ditentukan lookupId tidak dapat ditemukan.

MessageQueueException

Terjadi kesalahan saat mengakses metode Antrean Pesan.

InvalidEnumArgumentException

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

Lihat juga

• LookupId
• ReceiveByLookupId