MessageEnumerator.RemoveCurrent Metode

Definisi

Ruang nama:

System.Messaging

Rakitan:

System.Messaging.dll

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 untuk 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 untuk 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 untuk 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 instans MessageEnumerator diambil dengan menggunakan GetMessageEnumerator2. Jangan gunakan GetMessageEnumerator untuk mengambil instans MessageEnumerator karena 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

Message yang mereferensikan pesan pertama yang tersedia dalam antrean.

Keterangan

RemoveCurrent menghapus dan mengembalikan pesan di lokasi kursor saat ini.

Jika Anda menggunakan jurnal antrean, menghapus pesan menyebabkan salinan disimpan dalam antrean jurnal, sama seperti metode Receive kelas MessageQueue.

Saat Anda menghapus pesan saat ini, kursor dipindahkan ke pesan berikutnya. Anda tidak perlu memanggil MoveNext setelah memanggil RemoveCurrent.

Jika Anda memanggil kelebihan beban ini pada antrean transaksional, Antrean Pesan akan membuat satu transaksi internal.

Lihat juga

• MoveNext()
• Current

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

Message yang mereferensikan pesan pertama yang tersedia dalam antrean.

Pengecualian

ArgumentNullException

Parameter transactionnull.

Keterangan

RemoveCurrent menghapus dan mengembalikan pesan di lokasi kursor saat ini, menggunakan konteks transaksi internal yang ditentukan oleh parameter transaction.

Jika Anda menggunakan jurnal antrean, menghapus pesan menyebabkan salinan disimpan dalam antrean jurnal, sama seperti metode Receive kelas MessageQueue.

Saat bekerja dengan antrean transaksi, pembatalan transaksi menyebabkan pesan apa pun yang dihapus oleh panggilan ke RemoveCurrent dikembalikan ke antrean. Penghapusan tidak dapat dibatalkan sampai transaksi dilakukan.

Saat Anda menghapus pesan saat ini, kursor dipindahkan ke pesan berikutnya. Anda tidak perlu memanggil MoveNext setelah memanggil RemoveCurrent.

Lihat juga

• MoveNext()
• Current
• MessageQueueTransaction

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 satu nilai MessageQueueTransactionType, yang menjelaskan jenis konteks transaksi untuk dikaitkan dengan pesan.

Mengembalikan

Message

Message yang mereferensikan pesan pertama yang tersedia dalam antrean.

Pengecualian

InvalidEnumArgumentException

Parameter transactionType bukan salah satu anggota MessageQueueTransactionType.

Keterangan

RemoveCurrent menghapus dan mengembalikan pesan di lokasi kursor saat ini, menggunakan konteks transaksi yang ditentukan oleh parameter transactionType.

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

Jika Anda menggunakan jurnal antrean, menghapus pesan menyebabkan salinan disimpan dalam antrean jurnal, sama seperti metode Receive kelas MessageQueue.

Saat bekerja dengan antrean transaksi, pembatalan transaksi menyebabkan pesan apa pun yang dihapus oleh panggilan ke RemoveCurrent dikembalikan ke antrean. Penghapusan tidak dapat dibatalkan sampai transaksi dilakukan.

Saat Anda menghapus pesan saat ini, kursor dipindahkan ke pesan berikutnya. Anda tidak perlu memanggil MoveNext setelah memanggil RemoveCurrent.

Lihat juga

• MoveNext()
• Current
• MessageQueueTransactionType

RemoveCurrent(TimeSpan)

Menghapus pesan saat ini dari antrean dan mengembalikan pesan ke aplikasi panggilan. Jika ada pesan untuk 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

Message yang mereferensikan pesan pertama yang tersedia dalam antrean.

Pengecualian

ArgumentException

Nilai yang ditentukan untuk parameter timeout tidak valid.

MessageQueueException

Batas waktu 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 timeout telah kedaluwarsa.

Jika Anda menggunakan jurnal antrean, menghapus pesan menyebabkan salinan disimpan dalam antrean jurnal, sama seperti metode Receive kelas MessageQueue.

Saat Anda menghapus pesan saat ini, kursor dipindahkan ke pesan berikutnya. Anda tidak perlu memanggil MoveNext setelah memanggil RemoveCurrent.

Jika Anda memanggil kelebihan beban ini pada antrean transaksional, Antrean Pesan akan membuat satu transaksi internal.

Lihat juga

• MoveNext()
• Current

RemoveCurrent(TimeSpan, MessageQueueTransaction)

Menghapus pesan saat ini dari antrean transaksi dan mengembalikan pesan ke aplikasi panggilan. Jika ada pesan untuk 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

Message yang mereferensikan pesan pertama yang tersedia dalam antrean.

Pengecualian

ArgumentException

Nilai yang ditentukan untuk parameter timeout tidak valid.

ArgumentNullException

Parameter transactionnull.

MessageQueueException

Batas waktu 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 timeout telah kedaluwarsa.

Saat bekerja dengan antrean transaksi, pembatalan transaksi menyebabkan pesan apa pun yang dihapus oleh panggilan ke RemoveCurrent dikembalikan ke antrean. Penghapusan tidak dapat dibatalkan sampai transaksi dilakukan.

Jika Anda menggunakan jurnal antrean, menghapus pesan menyebabkan salinan disimpan dalam antrean jurnal, sama seperti metode Receive kelas MessageQueue.

Saat Anda menghapus pesan saat ini, kursor dipindahkan ke pesan berikutnya. Anda tidak perlu memanggil MoveNext setelah memanggil RemoveCurrent.

Lihat juga

• MoveNext()
• Current
• MessageQueueTransaction

RemoveCurrent(TimeSpan, MessageQueueTransactionType)

Menghapus pesan saat ini dari antrean dan mengembalikan pesan ke aplikasi panggilan. Jika ada pesan untuk 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::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 satu nilai MessageQueueTransactionType, yang menjelaskan jenis konteks transaksi untuk dikaitkan dengan pesan.

Mengembalikan

Message

Message yang mereferensikan pesan pertama yang tersedia dalam antrean.

Pengecualian

ArgumentException

Nilai yang ditentukan untuk parameter timeout tidak valid.

MessageQueueException

Batas waktu telah kedaluwarsa.

InvalidEnumArgumentException

Parameter transactionType bukan salah satu anggota MessageQueueTransactionType.

Keterangan

RemoveCurrent menghapus dan mengembalikan pesan di lokasi kursor saat ini, menggunakan konteks transaksi yang ditentukan oleh parameter transactionType. Jika kursor berada di akhir antrean, kelebihan beban metode ini menunggu hingga pesan tersedia atau interval yang ditentukan oleh parameter timeout telah kedaluwarsa.

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

Jika Anda menggunakan jurnal antrean, menghapus pesan menyebabkan salinan disimpan dalam antrean jurnal, sama seperti metode Receive kelas MessageQueue.

Saat bekerja dengan antrean transaksi, pembatalan transaksi menyebabkan pesan apa pun yang dihapus oleh panggilan ke RemoveCurrent dikembalikan ke antrean. Penghapusan tidak dapat dibatalkan sampai transaksi dilakukan.

Saat Anda menghapus pesan saat ini, kursor dipindahkan ke pesan berikutnya. Anda tidak perlu memanggil MoveNext setelah memanggil RemoveCurrent.

Lihat juga

• MoveNext()
• Current
• MessageQueueTransactionType