MessageEnumerator.RemoveCurrent 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.
Menghapus pesan saat ini dari antrean dan mengembalikan pesan ke aplikasi panggilan. Menghapus pesan akan menghapusnya dari antrean.
Overload
| RemoveCurrent() |
Menghapus pesan saat ini dari antrean transaksi atau non-transaksi dan mengembalikan pesan ke aplikasi panggilan. Tidak ada batas waktu yang ditentukan agar pesan tiba dalam antrean. |
| RemoveCurrent(MessageQueueTransaction) |
Menghapus pesan saat ini dari antrean transaksi dan mengembalikan pesan ke aplikasi panggilan. Tidak ada batas waktu yang ditentukan agar pesan tiba dalam antrean. |
| RemoveCurrent(MessageQueueTransactionType) |
Menghapus pesan saat ini dari antrean dan mengembalikan pesan ke aplikasi panggilan. Tidak ada batas waktu yang ditentukan agar pesan tiba dalam antrean. |
| RemoveCurrent(TimeSpan) |
Menghapus pesan saat ini dari antrean dan mengembalikan pesan ke aplikasi panggilan. Jika ada pesan yang akan dihapus, metode akan segera mengembalikannya. Jika tidak, metode menunggu batas waktu yang ditentukan untuk pesan baru tiba. |
| RemoveCurrent(TimeSpan, MessageQueueTransaction) |
Menghapus pesan saat ini dari antrean transaksi dan mengembalikan pesan ke aplikasi panggilan. Jika ada pesan yang akan dihapus, metode akan segera mengembalikannya. Jika tidak, metode menunggu batas waktu yang ditentukan untuk pesan baru tiba. |
| RemoveCurrent(TimeSpan, MessageQueueTransactionType) |
Menghapus pesan saat ini dari antrean dan mengembalikan pesan ke aplikasi panggilan. Jika ada pesan yang akan dihapus, metode akan segera mengembalikannya. Jika tidak, metode menunggu batas waktu yang ditentukan untuk pesan baru tiba. |
Keterangan
Perilaku yang dijelaskan untuk kelebihan beban ini hanya berlaku jika MessageEnumerator instans diambil dengan menggunakan GetMessageEnumerator2. Jangan gunakan GetMessageEnumerator untuk mengambil instans karena MessageEnumerator metode ini tidak digunakan lagi.
RemoveCurrent()
Menghapus pesan saat ini dari antrean transaksi atau non-transaksi dan mengembalikan pesan ke aplikasi panggilan. Tidak ada batas waktu yang ditentukan agar pesan tiba dalam antrean.
public:
System::Messaging::Message ^ RemoveCurrent();public System.Messaging.Message RemoveCurrent ();member this.RemoveCurrent : unit -> System.Messaging.MessagePublic Function RemoveCurrent () As MessageMengembalikan
Message yang mereferensikan pesan pertama yang tersedia dalam antrean.
Keterangan
RemoveCurrent menghapus dan mengembalikan pesan di lokasi kursor saat ini.
Jika Anda menggunakan penjurionan antrean, menghapus pesan menyebabkan salinan disimpan dalam antrean jurnal, seperti MessageQueue metode kelas Receive .
Ketika Anda menghapus pesan saat ini, kursor dipindahkan ke pesan berikutnya. Anda tidak perlu menelepon MoveNext setelah memanggil RemoveCurrent.
Jika Anda memanggil kelebihan beban ini pada antrean transaksional, Antrean Pesan membuat satu transaksi internal.
Lihat juga
Berlaku untuk
RemoveCurrent(MessageQueueTransaction)
Menghapus pesan saat ini dari antrean transaksi dan mengembalikan pesan ke aplikasi panggilan. Tidak ada batas waktu yang ditentukan agar pesan tiba dalam antrean.
public:
System::Messaging::Message ^ RemoveCurrent(System::Messaging::MessageQueueTransaction ^ transaction);public System.Messaging.Message RemoveCurrent (System.Messaging.MessageQueueTransaction transaction);member this.RemoveCurrent : System.Messaging.MessageQueueTransaction -> System.Messaging.MessagePublic Function RemoveCurrent (transaction As MessageQueueTransaction) As MessageParameter
- transaction
- MessageQueueTransaction
Objek MessageQueueTransaction yang menentukan transaksi tempat pesan akan dihapus.
Mengembalikan
Message yang mereferensikan pesan pertama yang tersedia dalam antrean.
Pengecualian
Parameternya transaction adalah null.
Keterangan
RemoveCurrent menghapus dan mengembalikan pesan di lokasi kursor saat ini, menggunakan konteks transaksi internal yang transaction ditentukan oleh parameter .
Jika Anda menggunakan penjurionan antrean, menghapus pesan menyebabkan salinan disimpan dalam antrean jurnal, seperti MessageQueue metode kelas Receive .
Saat bekerja dengan antrean transaksi, pembatalan transaksi menyebabkan pesan apa pun yang dihapus oleh panggilan RemoveCurrent dikembalikan ke antrean. Penghapusan tidak dapat dibatalkan sampai transaksi dilakukan.
Ketika Anda menghapus pesan saat ini, kursor dipindahkan ke pesan berikutnya. Anda tidak perlu menelepon MoveNext setelah memanggil RemoveCurrent.
Lihat juga
Berlaku untuk
RemoveCurrent(MessageQueueTransactionType)
Menghapus pesan saat ini dari antrean dan mengembalikan pesan ke aplikasi panggilan. Tidak ada batas waktu yang ditentukan agar pesan tiba dalam antrean.
public:
System::Messaging::Message ^ RemoveCurrent(System::Messaging::MessageQueueTransactionType transactionType);public System.Messaging.Message RemoveCurrent (System.Messaging.MessageQueueTransactionType transactionType);member this.RemoveCurrent : System.Messaging.MessageQueueTransactionType -> System.Messaging.MessagePublic Function RemoveCurrent (transactionType As MessageQueueTransactionType) As MessageParameter
- transactionType
- MessageQueueTransactionType
Salah MessageQueueTransactionType satu nilai, yang menjelaskan jenis konteks transaksi untuk dikaitkan dengan pesan.
Mengembalikan
Message yang mereferensikan pesan pertama yang tersedia dalam antrean.
Pengecualian
Parameter transactionType bukan salah MessageQueueTransactionType satu anggota.
Keterangan
RemoveCurrent menghapus dan mengembalikan pesan di lokasi kursor saat ini, menggunakan konteks transaksi yang ditentukan oleh transactionType parameter .
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 Anda menggunakan penjurionan antrean, menghapus pesan menyebabkan salinan disimpan dalam antrean jurnal, seperti MessageQueue metode kelas Receive .
Saat bekerja dengan antrean transaksi, pembatalan transaksi menyebabkan pesan apa pun yang dihapus oleh panggilan RemoveCurrent dikembalikan ke antrean. Penghapusan tidak dapat dibatalkan sampai transaksi dilakukan.
Ketika Anda menghapus pesan saat ini, kursor dipindahkan ke pesan berikutnya. Anda tidak perlu menelepon MoveNext setelah memanggil RemoveCurrent.
Lihat juga
Berlaku untuk
RemoveCurrent(TimeSpan)
Menghapus pesan saat ini dari antrean dan mengembalikan pesan ke aplikasi panggilan. Jika ada pesan yang akan dihapus, metode akan segera mengembalikannya. Jika tidak, metode menunggu batas waktu yang ditentukan untuk pesan baru tiba.
public:
System::Messaging::Message ^ RemoveCurrent(TimeSpan timeout);public System.Messaging.Message RemoveCurrent (TimeSpan timeout);member this.RemoveCurrent : TimeSpan -> System.Messaging.MessagePublic Function RemoveCurrent (timeout As TimeSpan) As MessageParameter
- timeout
- TimeSpan
Interval waktu untuk menunggu pesan tiba dalam antrean.
Mengembalikan
Message yang mereferensikan pesan pertama yang tersedia dalam antrean.
Pengecualian
Nilai yang ditentukan untuk timeout parameter tidak valid.
Waktu habis telah kedaluwarsa.
Keterangan
RemoveCurrent menghapus dan mengembalikan pesan di lokasi kursor saat ini. Jika kursor berada di akhir antrean, kelebihan beban metode ini menunggu hingga pesan tersedia atau interval yang ditentukan oleh parameter telah kedaluwarsa timeout .
Jika Anda menggunakan penjurionan antrean, menghapus pesan menyebabkan salinan disimpan dalam antrean jurnal, seperti MessageQueue metode kelas Receive .
Ketika Anda menghapus pesan saat ini, kursor dipindahkan ke pesan berikutnya. Anda tidak perlu menelepon MoveNext setelah memanggil RemoveCurrent.
Jika Anda memanggil kelebihan beban ini pada antrean transaksional, Antrean Pesan membuat satu transaksi internal.
Lihat juga
Berlaku untuk
RemoveCurrent(TimeSpan, MessageQueueTransaction)
Menghapus pesan saat ini dari antrean transaksi dan mengembalikan pesan ke aplikasi panggilan. Jika ada pesan yang akan dihapus, metode akan segera mengembalikannya. Jika tidak, metode menunggu batas waktu yang ditentukan untuk pesan baru tiba.
public:
System::Messaging::Message ^ RemoveCurrent(TimeSpan timeout, System::Messaging::MessageQueueTransaction ^ transaction);public System.Messaging.Message RemoveCurrent (TimeSpan timeout, System.Messaging.MessageQueueTransaction transaction);member this.RemoveCurrent : TimeSpan * System.Messaging.MessageQueueTransaction -> System.Messaging.MessagePublic Function RemoveCurrent (timeout As TimeSpan, transaction As MessageQueueTransaction) As MessageParameter
- timeout
- TimeSpan
Interval waktu untuk menunggu pesan dihapus.
- transaction
- MessageQueueTransaction
Objek MessageQueueTransaction yang menentukan konteks transaksi untuk pesan.
Mengembalikan
Message yang mereferensikan pesan pertama yang tersedia dalam antrean.
Pengecualian
Nilai yang ditentukan untuk timeout parameter tidak valid.
Parameternya transaction adalah null.
Waktu habis telah kedaluwarsa.
Keterangan
RemoveCurrent menghapus dan mengembalikan pesan di lokasi kursor saat ini. Jika kursor berada di akhir antrean, kelebihan beban metode ini menunggu hingga pesan tersedia atau interval yang ditentukan oleh parameter telah kedaluwarsa timeout .
Saat bekerja dengan antrean transaksi, pembatalan transaksi menyebabkan pesan apa pun yang dihapus oleh panggilan RemoveCurrent dikembalikan ke antrean. Penghapusan tidak dapat dibatalkan sampai transaksi dilakukan.
Jika Anda menggunakan penjurionan antrean, menghapus pesan menyebabkan salinan disimpan dalam antrean jurnal, seperti MessageQueue metode kelas Receive .
Ketika Anda menghapus pesan saat ini, kursor dipindahkan ke pesan berikutnya. Anda tidak perlu menelepon MoveNext setelah memanggil RemoveCurrent.
Lihat juga
Berlaku untuk
RemoveCurrent(TimeSpan, MessageQueueTransactionType)
Menghapus pesan saat ini dari antrean dan mengembalikan pesan ke aplikasi panggilan. Jika ada pesan untuk dihapus, metode segera mengembalikannya. Jika tidak, metode menunggu batas waktu yang ditentukan untuk pesan baru tiba.
public:
System::Messaging::Message ^ RemoveCurrent(TimeSpan timeout, System::Messaging::MessageQueueTransactionType transactionType);public System.Messaging.Message RemoveCurrent (TimeSpan timeout, System.Messaging.MessageQueueTransactionType transactionType);member this.RemoveCurrent : TimeSpan * System.Messaging.MessageQueueTransactionType -> System.Messaging.MessagePublic Function RemoveCurrent (timeout As TimeSpan, transactionType As MessageQueueTransactionType) As MessageParameter
- timeout
- TimeSpan
Interval waktu untuk menunggu pesan dihapus.
- transactionType
- MessageQueueTransactionType
Salah MessageQueueTransactionType satu nilai, yang menjelaskan jenis konteks transaksi untuk dikaitkan dengan pesan.
Mengembalikan
Message Yang mereferensikan pesan pertama yang tersedia dalam antrean.
Pengecualian
Nilai yang ditentukan untuk timeout parameter tidak valid.
Waktu habis telah kedaluwarsa.
Parameter transactionType bukan salah MessageQueueTransactionType satu anggota.
Keterangan
RemoveCurrent menghapus dan mengembalikan pesan di lokasi kursor saat ini, menggunakan konteks transaksi yang ditentukan oleh transactionType parameter . Jika kursor berada di akhir antrean, kelebihan metode ini menunggu hingga pesan tersedia atau interval yang ditentukan oleh parameter telah kedaluwarsa timeout .
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 Anda menggunakan jurnal antrean, menghapus pesan menyebabkan salinan disimpan dalam antrean jurnal, seperti MessageQueue metode kelas Receive .
Saat bekerja dengan antrean transaksi, pembatalan transaksi menyebabkan pesan apa pun yang dihapus oleh panggilan RemoveCurrent dikembalikan ke antrean. Penghapusan tidak dapat dibatalkan sampai transaksi dilakukan.
Ketika Anda menghapus pesan saat ini, kursor dipindahkan ke pesan berikutnya. Anda tidak perlu menelepon MoveNext setelah memanggil RemoveCurrent.
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