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.Message
Public Function RemoveCurrent () As Message
Mengembalikan
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.Message
Public Function RemoveCurrent (transaction As MessageQueueTransaction) As Message
Parameter
- 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.Message
Public Function RemoveCurrent (transactionType As MessageQueueTransactionType) As Message
Parameter
- 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.Message
Public Function RemoveCurrent (timeout As TimeSpan) As Message
Parameter
- 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.Message
Public Function RemoveCurrent (timeout As TimeSpan, transaction As MessageQueueTransaction) As Message
Parameter
- 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.Message
Public Function RemoveCurrent (timeout As TimeSpan, transactionType As MessageQueueTransactionType) As Message
Parameter
- 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.