DbCommand.ExecuteScalarAsync 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.
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 |
Keterangan
Untuk informasi selengkapnya tentang pemrograman asinkron, lihat Pemrograman Asinkron.
ExecuteScalarAsync()
- Sumber:
- DbCommand.cs
- Sumber:
- DbCommand.cs
- 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 ();public System.Threading.Tasks.Task<object?> ExecuteScalarAsync ();member this.ExecuteScalarAsync : unit -> System.Threading.Tasks.Task<obj>Public Function ExecuteScalarAsync () As Task(Of Object)Mengembalikan
Tugas yang mewakili operasi asinkron.
Pengecualian
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
Berlaku untuk
ExecuteScalarAsync(CancellationToken)
- Sumber:
- DbCommand.cs
- Sumber:
- DbCommand.cs
- 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);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
Tugas yang mewakili operasi asinkron.
Pengecualian
Terjadi kesalahan saat menjalankan perintah.
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().
