DbBatch.ExecuteNonQueryAsync(CancellationToken) Metode

  • Referensi

Definisi

Ruang nama:
System.Data.Common
Rakitan:
System.Data.Common.dll
Sumber:
DbBatch.cs
Sumber:
DbBatch.cs
Sumber:
DbBatch.cs

Ini adalah versi asinkron dari ExecuteNonQuery(). Penyedia harus mengambil alih dengan implementasi yang sesuai. Token pembatalan dapat diabaikan secara opsional.

Implementasi default memanggil metode sinkron ExecuteNonQuery() dan mengembalikan tugas yang selesai, memblokir utas panggilan. Implementasi default akan mengembalikan tugas yang dibatalkan jika melewati token pembatalan yang sudah dibatalkan. Pengecualian yang dilemparkan ExecuteNonQuery() akan dikomunikasikan melalui properti Pengecualian Tugas yang dikembalikan.

Jangan memanggil metode dan properti DbCommand objek lain sampai Tugas yang dikembalikan selesai.

public abstract System.Threading.Tasks.Task<int> ExecuteNonQueryAsync (System.Threading.CancellationToken cancellationToken = default);
abstract member ExecuteNonQueryAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<int>
Public MustOverride Function ExecuteNonQueryAsync (Optional cancellationToken As CancellationToken = Nothing) As Task(Of Integer)

Parameter

cancellationToken
CancellationToken

Token untuk membatalkan operasi asinkron.

Mengembalikan

Task<Int32>

Tugas yang mewakili operasi asinkron.

Pengecualian

DbException

Terjadi kesalahan saat menjalankan batch.

OperationCanceledException

Token pembatalan dibatalkan. Pengecualian ini disimpan ke dalam tugas yang dikembalikan.

Keterangan

Untuk informasi selengkapnya tentang pemrograman asinkron, lihat Pemrograman Asinkron.

Metode ini disimpan dalam tugas yang menampilkan semua pengecualian non-penggunaan yang dapat dilemparkan oleh rekan sinkron metode. Jika pengecualian disimpan ke dalam tugas yang dikembalikan, pengecualian tersebut akan dilemparkan saat tugas ditunggu. Pengecualian penggunaan, seperti ArgumentException, masih dilemparkan secara sinkron. Untuk pengecualian yang disimpan, lihat pengecualian yang dilemparkan oleh ExecuteNonQuery().

Berlaku untuk

Lihat juga