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

Definisi

Ruang nama:

Microsoft.Data.SqlClient

Rakitan:

Microsoft.Data.SqlClient.dll

Paket:

Microsoft.Data.SqlClient v5.2.0

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 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<T>

Objek jenis yang dikembalikan.

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.

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 dilemparkan.

Keterangan

T bisa menjadi salah satu jenis berikut:

Boolean	Byte	Char	DateOnly (.NET 6 atau yang lebih baru)
DateTime	DateTimeOffset	Desimal	Ganda
Float	Guid	Int16	Int32
Int64	SqlBoolean	SqlByte	SqlDateTime
SqlDecimal	SqlDouble	SqlGuid	SqlInt16
SqlInt32	SqlInt64	SqlMoney	SqlSingle
SqlString	Stream	String	TextReader
TimeOnly (.NET 6 atau yang lebih baru)	XmlReader		UDT, yang dapat berupa jenis CLR apa pun yang ditandai dengan SqlUserDefinedTypeAttribute.

Untuk informasi selengkapnya, lihat Dukungan Streaming SqlClient.