SqlBatch.ExecuteScalarAsync(CancellationToken) 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.
Versi asinkron dari ExecuteScalar(), yang menjalankan batch dan mengembalikan kolom pertama dari baris pertama dalam tataan hasil pertama yang dikembalikan. Semua kolom, baris, dan tataan hasil lainnya diabaikan.
public override System.Threading.Tasks.Task<object> ExecuteScalarAsync(System.Threading.CancellationToken cancellationToken = default);
override this.ExecuteScalarAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<obj>
Public Overrides Function ExecuteScalarAsync (Optional cancellationToken As CancellationToken = Nothing) As Task(Of Object)
Parameter
- cancellationToken
- CancellationToken
Token untuk membatalkan operasi asinkron.
Mengembalikan
Kolom pertama baris pertama dalam tataan hasil pertama.
Pengecualian
Terjadi kesalahan saat menjalankan batch.
Token pembatalan dibatalkan. Pengecualian ini disimpan ke dalam tugas yang dikembalikan.
Keterangan
Metode ini mendapat manfaat dari ExecuteScalarAsync(CancellationToken), dan semua pengecualian yang diharapkan dari metode itu juga berlaku di sini. Jika pengecualian disimpan ke dalam tugas yang dikembalikan, pengecualian tersebut akan dilemparkan saat tugas ditunggu. Pengecualian penggunaan, seperti ArgumentException, masih dilemparkan secara sinkron.