DataTableReader Kelas

Definisi

Ruang nama:

System.Data

Rakitan:

System.Data.Common.dll

Sumber:

DataTableReader.cs

DataTableReader mendapatkan konten satu atau beberapa objek DataTable dalam bentuk satu atau beberapa set hasil baca-saja dan hanya-maju.

public ref class DataTableReader sealed : System::Data::Common::DbDataReader

public sealed class DataTableReader : System.Data.Common.DbDataReader

type DataTableReader = class
    inherit DbDataReader

Public NotInheritable Class DataTableReader
Inherits DbDataReader

Warisan

Object

MarshalByRefObject

DbDataReader

DataTableReader

Keterangan

DataTableReader berfungsi seperti pembaca data lainnya, seperti SqlDataReader, kecuali bahwa DataTableReader menyediakan untuk iterasi atas baris dalam DataTable. Dengan kata lain, ini menyediakan iterasi atas baris dalam cache. Data yang di-cache dapat dimodifikasi saat DataTableReader aktif, dan pembaca secara otomatis mempertahankan posisinya.

Saat Anda membuat DataTableReader dari DataTable, objek DataTableReader yang dihasilkan berisi satu tataan hasil dengan data yang sama dengan DataTable tempatnya dibuat, kecuali untuk baris apa pun yang telah ditandai sebagai dihapus. Kolom muncul dalam urutan yang sama seperti dalam DataTableasli. Struktur hasil yang dikembalikan identik dalam skema dan data ke DataTableasli. DataTableReader yang dibuat dengan memanggil metode CreateDataReader objek DataSet berisi beberapa kumpulan hasil jika DataSet berisi lebih dari satu tabel. Hasilnya berada dalam urutan yang sama dengan objek DataTable di DataTableCollection objek DataSet.

Kumpulan hasil yang dikembalikan hanya berisi versi saat ini dari setiap DataRow; baris yang ditandai untuk penghapusan dilewati.

DataTableReader menyediakan iterator yang stabil; artinya, konten DataTableReader tidak valid jika ukuran koleksi yang mendasar dimodifikasi selama iterasi. Misalnya, jika satu atau beberapa baris dalam koleksi Rows dihapus atau dihapus selama iterasi, posisi saat ini dalam DataTableReader dipertahankan dengan tepat dan tidak membatalkan iterator.

Konstruktor

DataTableReader(DataTable)	Menginisialisasi instans baru kelas DataTableReader dengan menggunakan data dari DataTableyang disediakan.
DataTableReader(DataTable[])	Menginisialisasi instans baru kelas DataTableReader menggunakan array objek DataTable yang disediakan.

Properti

Depth	Kedalaman bersarang untuk baris DataTableReadersaat ini.
FieldCount	Mengembalikan jumlah kolom dalam baris saat ini.
HasRows	Mendapatkan nilai yang menunjukkan apakah DataTableReader berisi satu atau beberapa baris.
IsClosed	Mendapatkan nilai yang menunjukkan apakah DataTableReader ditutup.
Item[Int32]	Mendapatkan nilai kolom yang ditentukan dalam format aslinya mengingat ordinal kolom.
Item[String]	Mendapatkan nilai kolom yang ditentukan dalam format aslinya dengan nama kolom.
RecordsAffected	Mendapatkan jumlah baris yang disisipkan, diubah, atau dihapus oleh eksekusi pernyataan SQL.
VisibleFieldCount	Mendapatkan jumlah bidang dalam DbDataReader yang tidak disembunyikan. (Diperoleh dari DbDataReader)

Metode

Close()	Menutup DataTableReadersaat ini.
CloseAsync()	Menutup objek DbDataReader secara asinkron. (Diperoleh dari DbDataReader)
CreateObjRef(Type)	Membuat objek yang berisi semua informasi relevan yang diperlukan untuk menghasilkan proksi yang digunakan untuk berkomunikasi dengan objek jarak jauh. (Diperoleh dari MarshalByRefObject)
Dispose()	Merilis semua sumber daya yang digunakan oleh instans kelas DbDataReader saat ini. (Diperoleh dari DbDataReader)
Dispose(Boolean)	Merilis sumber daya yang tidak dikelola yang digunakan oleh DbDataReader dan secara opsional merilis sumber daya terkelola. (Diperoleh dari DbDataReader)
DisposeAsync()	Secara asinkron merilis semua sumber daya yang digunakan oleh instans kelas DbDataReader saat ini. (Diperoleh dari DbDataReader)
Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
GetBoolean(Int32)	Mendapatkan nilai kolom yang ditentukan sebagai Boolean.
GetByte(Int32)	Mendapatkan nilai kolom yang ditentukan sebagai byte.
GetBytes(Int32, Int64, Byte[], Int32, Int32)	Membaca aliran byte yang dimulai pada offset kolom yang ditentukan ke dalam buffer sebagai array yang dimulai pada offset buffer yang ditentukan.
GetChar(Int32)	Mendapatkan nilai kolom yang ditentukan sebagai karakter.
GetChars(Int32, Int64, Char[], Int32, Int32)	Mengembalikan nilai kolom yang ditentukan sebagai array karakter.
GetColumnSchemaAsync(CancellationToken)	Ini adalah versi asinkron dari GetColumnSchema(DbDataReader). Penyedia harus mengambil alih dengan implementasi yang sesuai. cancellationToken dapat secara opsional dihormati. Implementasi default memanggil panggilan GetColumnSchema(DbDataReader) sinkron dan mengembalikan tugas yang telah selesai. Implementasi default akan mengembalikan tugas yang dibatalkan jika melewati cancellationTokenyang sudah dibatalkan. Pengecualian yang dilemparkan oleh GetColumnSchema(DbDataReader) akan dikomunikasikan melalui properti Pengecualian Tugas yang dikembalikan. (Diperoleh dari DbDataReader)
GetData(Int32)	Mengembalikan pembaca data berlapis untuk kolom yang diminta. (Diperoleh dari DbDataReader)
GetDataTypeName(Int32)	Mendapatkan string yang mewakili jenis data kolom yang ditentukan.
GetDateTime(Int32)	Mendapatkan nilai kolom yang ditentukan sebagai objek DateTime.
GetDbDataReader(Int32)	Mengembalikan objek DbDataReader untuk ordinal kolom yang diminta yang dapat ditimpa dengan implementasi khusus penyedia. (Diperoleh dari DbDataReader)
GetDecimal(Int32)	Mendapatkan nilai kolom yang ditentukan sebagai Decimal.
GetDouble(Int32)	Mendapatkan nilai kolom sebagai angka titik mengambang presisi ganda.
GetEnumerator()	Mengembalikan enumerator yang dapat digunakan untuk melakukan iterasi melalui kumpulan item.
GetFieldType(Int32)	Mendapatkan Type yang merupakan jenis data objek.
GetFieldValue<T>(Int32)	Mendapatkan nilai kolom yang ditentukan sebagai jenis yang diminta. (Diperoleh dari DbDataReader)
GetFieldValueAsync<T>(Int32)	Secara asinkron mendapatkan nilai kolom yang ditentukan sebagai jenis yang diminta. (Diperoleh dari DbDataReader)
GetFieldValueAsync<T>(Int32, CancellationToken)	Secara asinkron mendapatkan nilai kolom yang ditentukan sebagai jenis yang diminta. (Diperoleh dari DbDataReader)
GetFloat(Int32)	Mendapatkan nilai kolom yang ditentukan sebagai angka titik mengambang presisi tunggal.
GetGuid(Int32)	Mendapatkan nilai kolom yang ditentukan sebagai pengidentifikasi unik global (GUID).
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetInt16(Int32)	Mendapatkan nilai kolom yang ditentukan sebagai bilangan bulat bertanda tangan 16-bit.
GetInt32(Int32)	Mendapatkan nilai kolom yang ditentukan sebagai bilangan bulat bertanda tangan 32-bit.
GetInt64(Int32)	Mendapatkan nilai kolom yang ditentukan sebagai bilangan bulat bertanda tangan 64-bit.
GetLifetimeService()	Kedaluwarsa. Mengambil objek layanan seumur hidup saat ini yang mengontrol kebijakan seumur hidup untuk instans ini. (Diperoleh dari MarshalByRefObject)
GetName(Int32)	Mendapatkan nilai kolom yang ditentukan sebagai String.
GetOrdinal(String)	Mendapatkan kolom ordinal, dengan nama kolom.
GetProviderSpecificFieldType(Int32)	Mendapatkan jenis kolom yang ditentukan dalam format khusus penyedia.
GetProviderSpecificValue(Int32)	Mendapatkan nilai kolom yang ditentukan dalam format khusus penyedia.
GetProviderSpecificValues(Object[])	Mengisi array yang disediakan dengan informasi jenis khusus penyedia untuk semua kolom di DataTableReader.
GetSchemaTable()	Mengembalikan DataTable yang menjelaskan metadata kolom DataTableReader.
GetSchemaTableAsync(CancellationToken)	Ini adalah versi asinkron dari GetSchemaTable(). Penyedia harus mengambil alih dengan implementasi yang sesuai. cancellationToken dapat secara opsional dihormati. Implementasi default memanggil panggilan GetSchemaTable() sinkron dan mengembalikan tugas yang telah selesai. Implementasi default akan mengembalikan tugas yang dibatalkan jika melewati cancellationTokenyang sudah dibatalkan. Pengecualian yang dilemparkan oleh GetSchemaTable() akan dikomunikasikan melalui properti Pengecualian Tugas yang dikembalikan. (Diperoleh dari DbDataReader)
GetStream(Int32)	Mendapatkan aliran untuk mengambil data dari kolom yang ditentukan. (Diperoleh dari DbDataReader)
GetString(Int32)	Mendapatkan nilai kolom yang ditentukan sebagai string.
GetTextReader(Int32)	Mendapatkan pembaca teks untuk mengambil data dari kolom. (Diperoleh dari DbDataReader)
GetType()	Mendapatkan Type instans saat ini. (Diperoleh dari Object)
GetValue(Int32)	Mendapatkan nilai kolom yang ditentukan dalam format aslinya.
GetValues(Object[])	Mengisi array objek dengan nilai kolom baris saat ini.
InitializeLifetimeService()	Kedaluwarsa. Mendapatkan objek layanan seumur hidup untuk mengontrol kebijakan seumur hidup untuk instans ini. (Diperoleh dari MarshalByRefObject)
IsDBNull(Int32)	Mendapatkan nilai yang menunjukkan apakah kolom berisi nilai yang tidak ada atau hilang.
IsDBNullAsync(Int32)	Secara asinkron mendapatkan nilai yang menunjukkan apakah kolom berisi nilai yang tidak ada atau hilang. (Diperoleh dari DbDataReader)
IsDBNullAsync(Int32, CancellationToken)	Secara asinkron mendapatkan nilai yang menunjukkan apakah kolom berisi nilai yang tidak ada atau hilang. (Diperoleh dari DbDataReader)
MemberwiseClone()	Membuat salinan dangkal dari Objectsaat ini. (Diperoleh dari Object)
MemberwiseClone(Boolean)	Membuat salinan dangkal objek MarshalByRefObject saat ini. (Diperoleh dari MarshalByRefObject)
NextResult()	Memajukan DataTableReader ke tataan hasil berikutnya, jika ada.
NextResultAsync()	Secara asinkron memajukan pembaca ke hasil berikutnya saat membaca hasil batch pernyataan. (Diperoleh dari DbDataReader)
NextResultAsync(CancellationToken)	Secara asinkron memajukan pembaca ke hasil berikutnya saat membaca hasil batch pernyataan. (Diperoleh dari DbDataReader)
Read()	Memajukan DataTableReader ke rekaman berikutnya.
ReadAsync()	Secara asinkron memajukan pembaca ke rekaman berikutnya dalam kumpulan hasil. (Diperoleh dari DbDataReader)
ReadAsync(CancellationToken)	Secara asinkron memajukan pembaca ke rekaman berikutnya dalam kumpulan hasil. (Diperoleh dari DbDataReader)
ToString()	Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object)

Implementasi Antarmuka Eksplisit

IDataRecord.GetData(Int32)

Untuk deskripsi anggota ini, lihat GetData(Int32). (Diperoleh dari DbDataReader)

Metode Ekstensi

CanGetColumnSchema(DbDataReader)	Mendapatkan nilai yang menunjukkan apakah DbDataReader bisa mendapatkan skema kolom.
GetColumnSchema(DbDataReader)	Mendapatkan skema kolom (koleksiDbColumn) untuk DbDataReader.
GetBoolean(DbDataReader, String)	Mendapatkan nilai kolom yang ditentukan sebagai Boolean.
GetByte(DbDataReader, String)	Mendapatkan nilai kolom yang ditentukan sebagai byte.
GetBytes(DbDataReader, String, Int64, Byte[], Int32, Int32)	Membaca jumlah byte tertentu dari kolom yang ditentukan mulai dari indeks tertentu dan menulisnya ke buffer yang dimulai pada posisi tertentu di buffer.
GetChar(DbDataReader, String)	Mendapatkan nilai kolom yang ditentukan sebagai satu karakter.
GetChars(DbDataReader, String, Int64, Char[], Int32, Int32)	Membaca jumlah karakter tertentu dari kolom tertentu yang dimulai pada indeks tertentu, dan menulisnya ke buffer yang dimulai pada posisi tertentu.
GetData(DbDataReader, String)	Mengembalikan pembaca data berlapis untuk kolom yang diminta.
GetDataTypeName(DbDataReader, String)	Mendapatkan nama tipe data kolom yang ditentukan.
GetDateTime(DbDataReader, String)	Mendapatkan nilai kolom yang ditentukan sebagai objek DateTime.
GetDecimal(DbDataReader, String)	Mendapatkan nilai kolom yang ditentukan sebagai Decimal.
GetDouble(DbDataReader, String)	Mendapatkan nilai kolom yang ditentukan sebagai angka titik mengambang presisi ganda.
GetFieldType(DbDataReader, String)	Mendapatkan tipe data kolom yang ditentukan.
GetFieldValue<T>(DbDataReader, String)	Mendapatkan nilai kolom yang ditentukan sebagai jenis yang diminta.
GetFieldValueAsync<T>(DbDataReader, String, CancellationToken)	Secara asinkron mendapatkan nilai kolom yang ditentukan sebagai jenis yang diminta.
GetFloat(DbDataReader, String)	Mendapatkan nilai kolom yang ditentukan sebagai angka titik mengambang presisi tunggal.
GetGuid(DbDataReader, String)	Mendapatkan nilai kolom yang ditentukan sebagai pengidentifikasi unik global (GUID).
GetInt16(DbDataReader, String)	Mendapatkan nilai kolom yang ditentukan sebagai bilangan bulat bertanda tangan 16-bit.
GetInt32(DbDataReader, String)	Mendapatkan nilai kolom yang ditentukan sebagai bilangan bulat bertanda tangan 32-bit.
GetInt64(DbDataReader, String)	Mendapatkan nilai kolom yang ditentukan sebagai bilangan bulat bertanda tangan 64-bit.
GetProviderSpecificFieldType(DbDataReader, String)	Mendapatkan jenis khusus penyedia dari kolom yang ditentukan.
GetProviderSpecificValue(DbDataReader, String)	Mendapatkan nilai kolom yang ditentukan sebagai instans jenis khusus penyedia.
GetStream(DbDataReader, String)	Mendapatkan aliran untuk mengambil data dari kolom yang ditentukan.
GetString(DbDataReader, String)	Mendapatkan nilai kolom yang ditentukan sebagai instans String.
GetTextReader(DbDataReader, String)	Mendapatkan pembaca teks untuk mengambil data dari kolom.
GetValue(DbDataReader, String)	Mendapatkan nilai kolom yang ditentukan sebagai instans Object.
IsDBNull(DbDataReader, String)	Mendapatkan nilai yang menunjukkan apakah kolom berisi nilai yang tidak ada atau hilang.
IsDBNullAsync(DbDataReader, String, CancellationToken)	Secara asinkron mendapatkan nilai yang menunjukkan apakah kolom berisi nilai yang tidak ada atau hilang.
Cast<TResult>(IEnumerable)	Melemparkan elemen IEnumerable ke jenis yang ditentukan.
OfType<TResult>(IEnumerable)	Memfilter elemen IEnumerable berdasarkan jenis tertentu.
AsParallel(IEnumerable)	Mengaktifkan paralelisasi kueri.
AsQueryable(IEnumerable)	Mengonversi IEnumerable menjadi IQueryable.
ConfigureAwait(IAsyncDisposable, Boolean)	Mengonfigurasi bagaimana menunggu tugas yang dikembalikan dari asinkron sekali pakai akan dilakukan.