SqlDataReader.GetFieldValueAsync<T>(Int32, CancellationToken) Metode

Definisi

Ruang nama:
System.Data.SqlClient
Rakitan:
System.Data.dll

Secara asinkron mendapatkan nilai kolom yang ditentukan sebagai jenis. GetFieldValue<T>(Int32) adalah versi sinkron dari metode ini.

public:
generic <typename T>
 override System::Threading::Tasks::Task<T> ^ GetFieldValueAsync(int i, System::Threading::CancellationToken cancellationToken);
public override System.Threading.Tasks.Task<T> GetFieldValueAsync<T>(int i, System.Threading.CancellationToken cancellationToken);
override this.GetFieldValueAsync : int * System.Threading.CancellationToken -> System.Threading.Tasks.Task<'T>
Public Overrides Function GetFieldValueAsync(Of T) (i As Integer, cancellationToken As CancellationToken) As Task(Of T)

Jenis parameter

T

Jenis nilai yang akan dikembalikan.

Parameter

i
Int32

Kolom yang akan diambil.

cancellationToken
CancellationToken

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

Mengembalikan

Task<T>

Objek jenis yang dikembalikan.

Pengecualian

InvalidOperationException

Koneksi terputus 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=true ditentukan dalam string koneksi.

IndexOutOfRangeException

Mencoba membaca kolom yang tidak ada.

SqlNullValueException

Nilai kolom null (IsDBNull(Int32) == true), mengambil jenis non-SQL.

InvalidCastException

T tidak cocok dengan jenis yang dikembalikan oleh SQL Server atau tidak dapat ditransmisikan.

OperationCanceledException

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

Keterangan

T bisa menjadi salah satu jenis berikut:

Boolean, Byte, Char, DateTime, DateTimeOffset, Desimal, Double, Float, Guid, Int16, Int32, Int64, SqlBoolean, SqlByte, SqlDateTime, SqlDecimal, SqlDouble, SqlGuid, SqlInt16, SqlInt32, SqlInt64, SqlMoney, SqlSingle, SqlString, String, atau UDT (jenis CLR apa pun yang ditandai dengan SqlUserDefinedTypeAttribute).

Untuk informasi selengkapnya, lihat Dukungan Streaming SqlClient.

Berlaku untuk