DbDataReader.GetFieldValueAsync Metode
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
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
- Sumber:
- DbDataReader.cs
- 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
Tugas yang Result berisi nilai kolom yang ditentukan.
Pengecualian
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.
Indeks kolom di luar rentang.
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.
Berlaku untuk
GetFieldValueAsync<T>(Int32, CancellationToken)
- Sumber:
- DbDataReader.cs
- Sumber:
- DbDataReader.cs
- 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
Tugas yang Result berisi nilai kolom yang ditentukan.
Pengecualian
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.
Indeks kolom di luar rentang.
Nilai yang dikembalikan oleh database tidak cocok atau tidak dapat ditransmisikan ke T
.
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.