MessageQueue.ReceiveByLookupId 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 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.MessagePublic Function ReceiveByLookupId (lookupId As Long) As MessageParameter
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.MessagePublic Function ReceiveByLookupId (action As MessageLookupAction, lookupId As Long, transaction As MessageQueueTransaction) As MessageParameter
- 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.
- transaction
- MessageQueueTransaction
Objek MessageQueueTransaction.
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.MessagePublic Function ReceiveByLookupId (action As MessageLookupAction, lookupId As Long, transactionType As MessageQueueTransactionType) As MessageParameter
- 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
Saran dan Komentar
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat: https://aka.ms/ContentUserFeedback.
Kirim dan lihat umpan balik untuk