SqlCommand.ExecuteScalarAsync(CancellationToken) Metode

Definisi

Ruang nama:

Microsoft.Data.SqlClient

Rakitan:

Microsoft.Data.SqlClient.dll

Paket:

Microsoft.Data.SqlClient v5.2.0

Versi asinkron , ExecuteScalar() yang menjalankan kueri secara asinkron dan mengembalikan kolom pertama dari baris pertama dalam tataan hasil yang dikembalikan oleh kueri. Kolom atau baris tambahan diabaikan.

Token pembatalan dapat digunakan untuk meminta agar operasi ditinggalkan sebelum batas waktu perintah berlalu. Pengecualian akan dilaporkan melalui objek Tugas yang dikembalikan.

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

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

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

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

Parameter

cancellationToken

CancellationToken

Instruksi pembatalan.

Mengembalikan

Task<Object>

Tugas yang mewakili operasi asinkron.

Pengecualian

ArgumentException

Nilai yang tidak valid CommandBehavior .

InvalidCastException

Selain SqlDbTypeBiner atau VarBinary digunakan ketika Value diatur ke Stream . Untuk informasi selengkapnya tentang streaming, lihat Dukungan Streaming SqlClient.

-atau-

Selain SqlDbTypeChar, NChar, NVarChar, VarChar, atau Xml digunakan saat Value diatur ke TextReader .

-atau-

Selain SqlDbTypeXml digunakan ketika Value diatur ke XmlReader .

InvalidOperationException

Memanggil ExecuteScalarAsync(CancellationToken) lebih dari sekali untuk instans yang sama sebelum penyelesaian tugas.

-atau-

Ditutup SqlConnection atau dihilangkan selama operasi streaming. Untuk informasi selengkapnya tentang streaming, lihat Dukungan Streaming SqlClient.

SqlException

SQL Server mengembalikan kesalahan saat menjalankan teks perintah.

-atau-

Waktu habis terjadi selama operasi streaming. Untuk informasi selengkapnya tentang streaming, lihat Dukungan Streaming SqlClient.

IOException

Terjadi kesalahan dalam Stream objek , XmlReader atau TextReader selama operasi streaming. Untuk informasi selengkapnya tentang streaming, lihat Dukungan Streaming SqlClient.

ObjectDisposedException

Objek Stream , XmlReader atau TextReader ditutup selama operasi streaming. Untuk informasi selengkapnya tentang streaming, lihat Dukungan Streaming SqlClient.

Keterangan

Untuk informasi selengkapnya tentang pemrograman asinkron di Penyedia Data .NET Framework untuk SQL Server, lihat Pemrograman Asinkron.

Catatan

Untuk kueri yang berjalan lama di server, pertimbangkan untuk menggunakan ExecuteScalar karena masalah yang diketahui dengan membatalkan kueri melalui token pembatalan. Selain itu, pertimbangkan untuk membatalkan eksekusi menggunakan metode .Cancel