DbCommand.ExecuteNonQueryAsync Metode

Definisi

Ruang nama:

System.Data.Common

Rakitan:

System.Data.Common.dll

Metode ini mengimplementasikan versi ExecuteNonQuery()asinkron , tetapi mengembalikan secara sinkron, memblokir utas Task panggilan.

Overload

ExecuteNonQueryAsync(CancellationToken)

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.

ExecuteNonQueryAsync()

Versi asinkron dari ExecuteNonQuery(), yang menjalankan perintah terhadap objek koneksinya, mengembalikan jumlah baris yang terpengaruh. ExecuteNonQueryAsync(CancellationToken) Memanggil dengan CancellationToken.None.

Keterangan

Untuk informasi selengkapnya tentang pemrograman asinkron, lihat Pemrograman Asinkron.

ExecuteNonQueryAsync(CancellationToken)

Sumber:

DbCommand.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:
 virtual System::Threading::Tasks::Task<int> ^ ExecuteNonQueryAsync(System::Threading::CancellationToken cancellationToken);

public virtual System.Threading.Tasks.Task<int> ExecuteNonQueryAsync (System.Threading.CancellationToken cancellationToken);

abstract member ExecuteNonQueryAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<int>
override this.ExecuteNonQueryAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<int>

Public Overridable Function ExecuteNonQueryAsync (cancellationToken As CancellationToken) 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 perintah.

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().

Lihat juga

• Ringkasan ADO.NET

ExecuteNonQueryAsync()

Sumber:

DbCommand.cs

Versi asinkron dari ExecuteNonQuery(), yang menjalankan perintah terhadap objek koneksinya, mengembalikan jumlah baris yang terpengaruh.

ExecuteNonQueryAsync(CancellationToken) Memanggil dengan CancellationToken.None.

public:
 System::Threading::Tasks::Task<int> ^ ExecuteNonQueryAsync();

public System.Threading.Tasks.Task<int> ExecuteNonQueryAsync ();

member this.ExecuteNonQueryAsync : unit -> System.Threading.Tasks.Task<int>

Public Function ExecuteNonQueryAsync () As Task(Of Integer)

Mengembalikan

Task<Int32>

Tugas yang mewakili operasi asinkron.

Pengecualian

DbException

Terjadi kesalahan saat menjalankan perintah.

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().

Lihat juga

• Ringkasan ADO.NET