Bagikan melalui


MessageQueue.ReceiveByLookupId Metode

Definisi

Diperkenalkan dalam MSMQ 3.0. Menerima pesan tertentu dari antrean. Pesan dapat ditentukan oleh pengidentifikasi pencarian atau dengan posisinya di bagian depan atau akhir antrean.

Overload

ReceiveByLookupId(Int64)

Diperkenalkan di MSMQ 3.0. Menerima pesan yang cocok dengan pengidentifikasi pencarian yang diberikan dari antrean non-transaksi.

ReceiveByLookupId(MessageLookupAction, Int64, MessageQueueTransaction)

Diperkenalkan di MSMQ 3.0. Menerima pesan tertentu dari antrean transaksi. Pesan dapat ditentukan oleh pengidentifikasi pencarian atau dengan posisinya di bagian depan atau akhir antrean.

ReceiveByLookupId(MessageLookupAction, Int64, MessageQueueTransactionType)

Diperkenalkan di MSMQ 3.0. Menerima pesan tertentu dari antrean, menggunakan konteks transaksi yang ditentukan. Pesan dapat ditentukan oleh pengidentifikasi pencarian atau dengan posisinya di bagian depan atau akhir antrean.

ReceiveByLookupId(Int64)

Diperkenalkan di MSMQ 3.0. Menerima pesan yang cocok dengan pengidentifikasi pencarian yang diberikan dari antrean non-transaksi.

public:
 System::Messaging::Message ^ ReceiveByLookupId(long lookupId);
public System.Messaging.Message ReceiveByLookupId (long lookupId);
member this.ReceiveByLookupId : int64 -> System.Messaging.Message
Public Function ReceiveByLookupId (lookupId As Long) As Message

Parameter

lookupId
Int64

Pesan LookupId yang akan diterima.

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 dan 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 tanpa menghapusnya dari antrean, gunakan PeekByLookupId 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

ReceiveByLookupId(MessageLookupAction, Int64, MessageQueueTransaction)

Diperkenalkan di MSMQ 3.0. Menerima pesan tertentu dari antrean transaksi. Pesan dapat ditentukan oleh pengidentifikasi pencarian atau dengan posisinya di bagian depan atau akhir antrean.

public:
 System::Messaging::Message ^ ReceiveByLookupId(System::Messaging::MessageLookupAction action, long lookupId, System::Messaging::MessageQueueTransaction ^ transaction);
public System.Messaging.Message ReceiveByLookupId (System.Messaging.MessageLookupAction action, long lookupId, System.Messaging.MessageQueueTransaction transaction);
member this.ReceiveByLookupId : System.Messaging.MessageLookupAction * int64 * System.Messaging.MessageQueueTransaction -> System.Messaging.Message
Public Function ReceiveByLookupId (action As MessageLookupAction, lookupId As Long, transaction As MessageQueueTransaction) As Message

Parameter

action
MessageLookupAction

Salah MessageLookupAction satu nilai, menentukan bagaimana pesan dibaca dalam antrean. Tentukan salah satu hal berikut ini:

MessageLookupAction.Current: Menerima pesan yang ditentukan oleh lookupId dan menghapusnya dari antrean.

MessageLookupAction.Next: Menerima pesan setelah pesan yang ditentukan oleh lookupId dan menghapusnya dari antrean.

MessageLookupAction.Previous: Menerima pesan sebelum pesan yang ditentukan oleh lookupId dan menghapusnya dari antrean.

MessageLookupAction.First: Menerima pesan pertama dalam antrean dan menghapusnya dari antrean. Parameter lookupId harus diatur ke 0.

MessageLookupAction.Last: Menerima pesan terakhir dalam antrean dan menghapusnya dari antrean. Parameter lookupId harus diatur ke 0.

lookupId
Int64

Pesan LookupId yang akan diterima, atau 0. 0 digunakan saat mengakses pesan pertama atau terakhir dalam antrean.

Mengembalikan

yang Message ditentukan oleh lookupId parameter dan action yang diteruskan.

Pengecualian

MSMQ 3.0 tidak diinstal.

Pesan dengan yang ditentukan lookupId tidak dapat ditemukan.

Terjadi kesalahan saat mengakses metode Antrean Pesan.

-atau-

Antrean tidak transaksi.

Parameter action bukan salah MessageLookupAction satu anggota.

Keterangan

Gunakan metode ini untuk membaca pesan dengan pengidentifikasi pencarian yang diketahui dan menghapusnya dari antrean, menggunakan konteks transaksi yang ditentukan oleh transaction parameter . 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 .

Karena metode ini dipanggil pada antrean transaksional, pesan yang diterima akan dikembalikan ke antrean jika transaksi dibatalkan. Pesan tidak dihapus secara permanen dari antrean hingga transaksi dilakukan.

Untuk membaca pesan dengan pengidentifikasi tertentu tanpa menghapusnya dari antrean, gunakan PeekByLookupId metode . Tidak ada konteks transaksi yang terkait dengan pesan yang dikembalikan oleh panggilan ke PeekByLookupId. Karena PeekByLookupId tidak menghapus pesan apa pun dari antrean, tidak akan ada yang perlu digulung balik jika transaksi dibatalkan.

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

ReceiveByLookupId(MessageLookupAction, Int64, MessageQueueTransactionType)

Diperkenalkan dalam MSMQ 3.0. Menerima pesan tertentu dari antrean, menggunakan konteks transaksi yang ditentukan. Pesan dapat ditentukan oleh pengidentifikasi pencarian atau dengan posisinya di bagian depan atau akhir antrean.

public:
 System::Messaging::Message ^ ReceiveByLookupId(System::Messaging::MessageLookupAction action, long lookupId, System::Messaging::MessageQueueTransactionType transactionType);
public System.Messaging.Message ReceiveByLookupId (System.Messaging.MessageLookupAction action, long lookupId, System.Messaging.MessageQueueTransactionType transactionType);
member this.ReceiveByLookupId : System.Messaging.MessageLookupAction * int64 * System.Messaging.MessageQueueTransactionType -> System.Messaging.Message
Public Function ReceiveByLookupId (action As MessageLookupAction, lookupId As Long, transactionType As MessageQueueTransactionType) As Message

Parameter

action
MessageLookupAction

Salah MessageLookupAction satu nilai, menentukan bagaimana pesan dibaca dalam antrean. Tentukan salah satu hal berikut ini:

MessageLookupAction.Current: Menerima pesan yang ditentukan oleh lookupId dan menghapusnya dari antrean.

MessageLookupAction.Next: Menerima pesan setelah pesan yang ditentukan oleh lookupId dan menghapusnya dari antrean.

MessageLookupAction.Previous: Menerima pesan sebelum pesan yang ditentukan oleh lookupId dan menghapusnya dari antrean.

MessageLookupAction.First: Menerima pesan pertama dalam antrean dan menghapusnya dari antrean. Parameter lookupId harus diatur ke 0.

MessageLookupAction.Last: Menerima pesan terakhir dalam antrean dan menghapusnya dari antrean. Parameter lookupId harus diatur ke 0.

lookupId
Int64

Pesan LookupId yang akan diterima, atau 0. 0 digunakan saat mengakses pesan pertama atau terakhir dalam antrean.

transactionType
MessageQueueTransactionType

Salah MessageQueueTransactionType satu nilai, yang menjelaskan jenis konteks transaksi untuk dikaitkan dengan pesan.

Mengembalikan

Message yang 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.

-atau-

Parameter transactionType bukan salah MessageQueueTransactionType satu anggota.

Keterangan

Gunakan metode ini untuk membaca pesan dengan pengidentifikasi pencarian yang diketahui dan menghapusnya dari antrean, menggunakan konteks transaksi yang ditentukan oleh transactionType parameter . Metode ini segera melemparkan pengecualian jika pesan tidak berada 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 tanpa menghapusnya dari antrean, gunakan PeekByLookupId metode . Tidak ada konteks transaksi yang terkait dengan pesan yang dikembalikan oleh panggilan ke PeekByLookupId. Karena PeekByLookupId tidak menghapus pesan apa pun dari antrean, tidak akan ada yang perlu digulung balik jika transaksi dibatalkan.

Tentukan Automatic untuk transactionType parameter jika sudah ada konteks transaksi eksternal yang dilampirkan ke utas yang ingin Anda gunakan untuk menerima pesan. Tentukan Single apakah Anda ingin menerima pesan sebagai satu transaksi internal. Anda dapat menentukan None apakah Anda ingin menerima pesan dari antrean transaksi di luar konteks transaksi.

Jika metode ini dipanggil untuk menerima pesan dari antrean transaksi, pesan yang diterima akan dikembalikan ke antrean jika transaksi dibatalkan. Pesan tidak dihapus secara permanen dari antrean hingga transaksi dilakukan.

Tabel berikut ini memperlihatkan 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