DbCommand.ExecuteScalarAsync Metode

Definisi

Ruang nama:

System.Data.Common

Rakitan:

System.Data.Common.dll

Mengimplementasikan versi ExecuteScalar()asinkron , tetapi mengembalikan secara sinkron, memblokir utas Task panggilan.

Overload

ExecuteScalarAsync()

Versi asinkron , ExecuteScalar()yang menjalankan perintah dan mengembalikan kolom pertama dari baris pertama dalam tataan hasil pertama yang dikembalikan. Semua kolom, baris, dan tataan hasil lainnya diabaikan. ExecuteScalarAsync(CancellationToken) Memanggil dengan CancellationToken.None.

ExecuteScalarAsync(CancellationToken)

Ini adalah versi asinkron dari ExecuteScalar(). Penyedia harus mengambil alih dengan implementasi yang sesuai. Token pembatalan dapat diabaikan secara opsional. Implementasi default memanggil metode sinkron ExecuteScalar() 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 oleh ExecuteScalar akan dikomunikasikan melalui properti Pengecualian Tugas yang dikembalikan. Jangan memanggil metode dan properti DbCommand objek lain sampai Tugas yang dikembalikan selesai.

Keterangan

Untuk informasi selengkapnya tentang pemrograman asinkron, lihat Pemrograman Asinkron.

ExecuteScalarAsync()

Sumber:

DbCommand.cs

Versi asinkron , ExecuteScalar()yang menjalankan perintah dan mengembalikan kolom pertama dari baris pertama dalam tataan hasil pertama yang dikembalikan. Semua kolom, baris, dan tataan hasil lainnya diabaikan.

ExecuteScalarAsync(CancellationToken) Memanggil dengan CancellationToken.None.

public:
 System::Threading::Tasks::Task<System::Object ^> ^ ExecuteScalarAsync();

public System.Threading.Tasks.Task<object?> ExecuteScalarAsync ();

member this.ExecuteScalarAsync : unit -> System.Threading.Tasks.Task<obj>

Public Function ExecuteScalarAsync () As Task(Of Object)

Mengembalikan

Task<Object>

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

Lihat juga

• Ringkasan ADO.NET

ExecuteScalarAsync(CancellationToken)

Sumber:

DbCommand.cs

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

Implementasi default memanggil metode sinkron ExecuteScalar() 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 oleh ExecuteScalar 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<System::Object ^> ^ ExecuteScalarAsync(System::Threading::CancellationToken cancellationToken);

public virtual System.Threading.Tasks.Task<object?> ExecuteScalarAsync (System.Threading.CancellationToken cancellationToken);

abstract member ExecuteScalarAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<obj>
override this.ExecuteScalarAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<obj>

Public Overridable Function ExecuteScalarAsync (cancellationToken As CancellationToken) As Task(Of Object)

Parameter

cancellationToken

CancellationToken

Token untuk membatalkan operasi asinkron.

Mengembalikan

Task<Object>

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

Lihat juga

• Ringkasan ADO.NET