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 dengan IsDBNull(Int32). 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=trueditentukan dalam string koneksi.

IndexOutOfRangeException

Mencoba membaca kolom yang tidak ada.

SqlNullValueException

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

InvalidCastException

Ttidak 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	Ganda	Float
Guid	Int16	Int32	Int64
SqlBoolean	SqlByte	SqlDateTime	SqlDecimal
SqlDouble	SqlGuid	SqlInt16	SqlInt32
SqlInt64	SqlMoney	SqlSingle	SqlString
String	UDT, yang dapat berupa jenis CLR apa pun yang ditandai dengan SqlUserDefinedTypeAttribute.

Untuk informasi selengkapnya, lihat Dukungan Streaming SqlClient.