SqlDataReader.GetFieldValue<T>(Int32) Metode

Definisi

Ruang nama:

Microsoft.Data.SqlClient

Rakitan:

Microsoft.Data.SqlClient.dll

Paket:

Microsoft.Data.SqlClient v5.2.0

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

public:
generic <typename T>
 override T GetFieldValue(int i);

public override T GetFieldValue<T> (int i);

override this.GetFieldValue : int -> 'T

Public Overrides Function GetFieldValue(Of T) (i As Integer) As T

Jenis parameter

T

Jenis nilai yang akan dikembalikan.

Parameter

i

Int32

Kolom yang akan diambil.

Mengembalikan

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