DbDataReader.GetFieldValueAsync Metode

Definisi

Ruang nama:

System.Data.Common

Rakitan:

System.Data.Common.dll

Secara asinkron mendapatkan nilai kolom yang ditentukan sebagai jenis yang diminta.

Overload

GetFieldValueAsync<T>(Int32)	Secara asinkron mendapatkan nilai kolom yang ditentukan sebagai jenis yang diminta.
GetFieldValueAsync<T>(Int32, CancellationToken)	Secara asinkron mendapatkan nilai kolom yang ditentukan sebagai jenis yang diminta.

GetFieldValueAsync<T>(Int32)

Sumber:

DbDataReader.cs

Secara asinkron mendapatkan nilai kolom yang ditentukan sebagai jenis yang diminta.

public:
generic <typename T>
 System::Threading::Tasks::Task<T> ^ GetFieldValueAsync(int ordinal);

public System.Threading.Tasks.Task<T> GetFieldValueAsync<T> (int ordinal);

member this.GetFieldValueAsync : int -> System.Threading.Tasks.Task<'T>

Public Function GetFieldValueAsync(Of T) (ordinal As Integer) As Task(Of T)

Jenis parameter

T

Jenis nilai yang akan dikembalikan.

Parameter

ordinal

Int32

Ordinal kolom berbasis nol.

Mengembalikan

Task<T>

Tugas yang Result berisi nilai kolom yang ditentukan.

Pengecualian

InvalidOperationException

Koneksi terputus atau ditutup selama pengambilan data.

-atau-

Pembaca data ditutup selama pengambilan data.

-atau-

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

-atau-

Mencoba membaca kolom yang dibaca sebelumnya dalam mode berurutan.

-atau-

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

IndexOutOfRangeException

Indeks kolom di luar rentang.

InvalidCastException

Nilai yang dikembalikan oleh database tidak cocok atau tidak dapat ditransmisikan ke T.

Keterangan

Metode asinkron ini hanya diperlukan untuk menghindari pemblokiran utas panggilan ketika pembaca dibuat dalam mode berurutan.

Jika mode berurutan tidak ditentukan, semua nilai kolom harus tersedia dalam memori setiap kali ReadAsync selesai, dan memanggil versi sinkron metode tidak boleh memblokir utas panggilan.

Implementasi default metode asinkron ini memanggil rekan sinkronnya dan mengembalikan Tugas yang telah selesai, yang berpotensi memblokir utas panggilan.

Penyedia data yang mendukung pemrograman asinkron harus mengambil alih implementasi default menggunakan operasi I/O asinkron.

Metode dan properti lain dari objek DbDataReader tidak boleh dipanggil saat Tugas yang dikembalikan belum selesai.

GetFieldValueAsync<T>(Int32, CancellationToken)

Sumber:

DbDataReader.cs

Secara asinkron mendapatkan nilai kolom yang ditentukan sebagai jenis yang diminta.

public:
generic <typename T>
 virtual System::Threading::Tasks::Task<T> ^ GetFieldValueAsync(int ordinal, System::Threading::CancellationToken cancellationToken);

public virtual System.Threading.Tasks.Task<T> GetFieldValueAsync<T> (int ordinal, System.Threading.CancellationToken cancellationToken);

abstract member GetFieldValueAsync : int * System.Threading.CancellationToken -> System.Threading.Tasks.Task<'T>
override this.GetFieldValueAsync : int * System.Threading.CancellationToken -> System.Threading.Tasks.Task<'T>

Public Overridable Function GetFieldValueAsync(Of T) (ordinal As Integer, cancellationToken As CancellationToken) As Task(Of T)

Jenis parameter

T

Jenis nilai yang akan dikembalikan.

Parameter

ordinal

Int32

Ordinal kolom berbasis nol.

cancellationToken

CancellationToken

Token untuk membatalkan operasi asinkron.

Mengembalikan

Task<T>

Tugas yang Result berisi nilai kolom yang ditentukan.

Pengecualian

InvalidOperationException

Koneksi terputus atau ditutup selama pengambilan data.

-atau-

Pembaca data ditutup selama pengambilan data.

-atau-

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

-atau-

Mencoba membaca kolom yang dibaca sebelumnya dalam mode berurutan.

-atau-

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

IndexOutOfRangeException

Indeks kolom di luar rentang.

InvalidCastException

Nilai yang dikembalikan oleh database tidak cocok atau tidak dapat ditransmisikan ke T.

OperationCanceledException

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

Keterangan

Metode asinkron ini hanya diperlukan untuk menghindari pemblokiran utas panggilan ketika pembaca dibuat dalam mode berurutan.

Jika mode berurutan tidak ditentukan, semua nilai kolom harus tersedia dalam memori setiap kali ReadAsync selesai, dan memanggil versi sinkron metode tidak boleh memblokir utas panggilan.

Implementasi default metode asinkron ini memanggil rekan sinkronnya dan mengembalikan Tugas yang telah selesai, yang berpotensi memblokir utas panggilan. Implementasi default juga mengembalikan tugas yang dibatalkan jika melewati token pembatalan yang sudah dibatalkan.

Penyedia data yang mendukung pemrograman asinkron harus mengambil alih implementasi default menggunakan operasi I/O asinkron.

Metode ini menerima token pembatalan yang dapat digunakan untuk meminta operasi dibatalkan lebih awal. Implementasi dapat mengabaikan permintaan ini.

Metode dan properti lain dari objek DbDataReader tidak boleh dipanggil saat Tugas yang dikembalikan belum selesai.