SqlDataReader.IsDBNullAsync(Int32, CancellationToken) Metode

Definisi

Ruang nama:

System.Data.SqlClient

Rakitan:

System.Data.dll

Versi asinkron , IsDBNull(Int32)yang mendapatkan nilai yang menunjukkan apakah kolom berisi nilai yang tidak ada atau hilang.

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<bool> ^ IsDBNullAsync(int i, System::Threading::CancellationToken cancellationToken);

public override System.Threading.Tasks.Task<bool> IsDBNullAsync (int i, System.Threading.CancellationToken cancellationToken);

override this.IsDBNullAsync : int * System.Threading.CancellationToken -> System.Threading.Tasks.Task<bool>

Public Overrides Function IsDBNullAsync (i As Integer, cancellationToken As CancellationToken) As Task(Of Boolean)

Parameter

i

Int32

Kolom berbasis nol yang akan diambil.

cancellationToken

CancellationToken

Instruksi pembatalan, yang menyebarluaskan pemberitahuan bahwa operasi harus dibatalkan. Ini tidak menjamin pembatalan. Pengaturan CancellationToken.None membuat metode ini setara dengan IsDBNull(Int32). Tugas yang dikembalikan harus ditandai sebagai dibatalkan.

Mengembalikan

Task<Boolean>

true jika nilai kolom yang ditentukan setara dengan DBNull jika tidak false.

Pengecualian

InvalidOperationException

Koneksi turun atau ditutup selama pengambilan data.

SqlDataReader ditutup selama pengambilan data.

Tidak ada data yang siap dibaca (misalnya, yang pertama Read() belum dipanggil, atau dikembalikan salah).

Mencoba membaca kolom yang dibaca sebelumnya dalam mode berurutan.

Ada operasi asinkron yang sedang berlangsung. Ini berlaku untuk semua metode Get* saat berjalan dalam mode berurutan, karena dapat dipanggil saat membaca aliran.

Context Connection=trueditentukan dalam string koneksi.

IndexOutOfRangeException

Mencoba membaca kolom yang tidak ada.

OperationCanceledException

Token pembatalan dibatalkan. Pengecualian ini disimpan ke dalam tugas yang dikembalikan.

Keterangan

Untuk informasi selengkapnya, lihat Dukungan Streaming SqlClient.

Metode ini disimpan dalam tugas yang mengembalikan 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 IsDBNull(Int32).