OdbcDataReader Kelas

Definisi

Ruang nama:

System.Data.Odbc

Rakitan:

System.Data.Odbc.dll

Paket:

System.Data.Odbc v9.0.0-preview.3.24172.9

Sumber:

OdbcDataReader.cs

Menyediakan cara membaca aliran baris data terusan saja dari sumber data. Kelas ini tidak dapat diwariskan.

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

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

type OdbcDataReader = class
    inherit DbDataReader

Public NotInheritable Class OdbcDataReader
Inherits DbDataReader

Warisan

Object

MarshalByRefObject

DbDataReader

OdbcDataReader

Contoh

Contoh berikut membuat OdbcConnection, , OdbcCommanddan OdbcDataReader. Contohnya membaca data, menulisnya ke konsol. Akhirnya, contoh menutup OdbcDataReader, lalu OdbcConnection.

public static void ReadData(string connectionString)
{
    string queryString = "SELECT DISTINCT CustomerID FROM Orders";

    using (OdbcConnection connection = new OdbcConnection(connectionString))
    {
        OdbcCommand command = new OdbcCommand(queryString, connection);

        connection.Open();

        // Execute the DataReader and access the data.
        OdbcDataReader reader = command.ExecuteReader();
        while (reader.Read())
        {
            Console.WriteLine("CustomerID={0}", reader[0]);
        }

        // Call Close when done reading.
        reader.Close();
    }
}

Public Sub ReadData(ByVal connectionString As String)
    Dim queryString As String = "SELECT DISTINCT CustomerID FROM Orders"

    Using connection As New OdbcConnection(connectionString)
        Dim command As New OdbcCommand(queryString, connection)

        connection.Open()

        Dim reader As OdbcDataReader = command.ExecuteReader()

        While reader.Read()
            Console.WriteLine("CustomerID={0}", reader(0).ToString)
        End While

        ' Call Close when done reading.
        reader.Close()
    End Using
End Sub

Keterangan

Untuk membuat OdbcDataReader, Anda harus memanggil ExecuteReader metode OdbcCommand objek, alih-alih langsung menggunakan konstruktor.

OdbcDataReader Saat sedang digunakan, yang terkait OdbcConnection sibuk melayani OdbcDataReader, dan tidak ada operasi lain yang dapat dilakukan selain OdbcConnection menutupnya. Ini adalah kasus sampai Close metode dipanggil OdbcDataReader . Misalnya, Anda tidak dapat mengambil parameter output hingga setelah Anda memanggil Close.

Perubahan yang dilakukan pada hasil yang ditetapkan oleh proses atau utas lain saat data sedang dibaca mungkin terlihat oleh pengguna OdbcDataReader. Namun, perilaku yang tepat adalah driver dan waktu tergantung.

IsClosed dan RecordsAffected adalah satu-satunya properti yang dapat Anda panggil setelah OdbcDataReader ditutup. Terkadang, Anda harus menelepon Close sebelum dapat memanggil RecordsAffected.

Properti

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

Metode

Close()	OdbcDataReader Menutup objek .
CloseAsync()	Menutup objek secara DbDataReader 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 DbDataReader kelas saat ini. (Diperoleh dari DbDataReader)
Dispose(Boolean)	Merilis sumber daya tidak terkelola 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 DbDataReader kelas 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 dari offset kolom yang ditentukan ke dalam buffer sebagai array, dimulai dari offset buffer tertentu.
GetChar(Int32)	Mendapatkan nilai kolom yang ditentukan sebagai karakter.
GetChars(Int32, Int64, Char[], Int32, Int32)	Membaca aliran karakter dari offset kolom yang ditentukan ke dalam buffer sebagai array, dimulai pada offset buffer tertentu.
GetColumnSchemaAsync(CancellationToken)	Ini adalah versi asinkron dari GetColumnSchema(DbDataReader). Penyedia harus mengambil alih dengan implementasi yang sesuai. cancellationToken secara opsional dapat dihormati. Implementasi default memanggil panggilan sinkron GetColumnSchema(DbDataReader) dan mengembalikan tugas yang selesai. Implementasi default akan mengembalikan tugas yang dibatalkan jika lulus yang sudah dibatalkan cancellationToken. Pengecualian yang dilemparkan 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 nama jenis data sumber.
GetDate(Int32)	Mendapatkan nilai kolom yang ditentukan sebagai DateTime objek.
GetDateTime(Int32)	Mendapatkan nilai kolom yang ditentukan sebagai DateTime objek.
GetDbDataReader(Int32)	Mengembalikan DbDataReader objek untuk ordinal kolom yang diminta yang dapat ditimpa dengan implementasi khusus penyedia. (Diperoleh dari DbDataReader)
GetDecimal(Int32)	Mendapatkan nilai kolom yang ditentukan sebagai Decimal objek.
GetDouble(Int32)	Mendapatkan nilai kolom yang ditentukan sebagai angka floating-point presisi ganda.
GetEnumerator()	Mengembalikan yang IEnumerator dapat digunakan untuk mengulangi baris dalam pembaca data.
GetFieldType(Int32)	Type Mendapatkan 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 floating-point 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 nama kolom yang ditentukan.
GetOrdinal(String)	Mendapatkan ordinal kolom, dengan nama kolom.
GetProviderSpecificFieldType(Int32)	Mendapatkan jenis khusus penyedia dari kolom yang ditentukan. (Diperoleh dari DbDataReader)
GetProviderSpecificValue(Int32)	Mendapatkan nilai kolom yang ditentukan sebagai instans jenis khusus penyedia. (Diperoleh dari DbDataReader)
GetProviderSpecificValues(Object[])	Mendapatkan semua kolom atribut khusus penyedia dalam koleksi untuk baris saat ini. (Diperoleh dari DbDataReader)
GetSchemaTable()	Mengembalikan yang DataTable menjelaskan metadata kolom dari OdbcDataReader.
GetSchemaTableAsync(CancellationToken)	Ini adalah versi asinkron dari GetSchemaTable(). Penyedia harus mengambil alih dengan implementasi yang sesuai. cancellationToken secara opsional dapat dihormati. Implementasi default memanggil panggilan sinkron GetSchemaTable() dan mengembalikan tugas yang selesai. Implementasi default akan mengembalikan tugas yang dibatalkan jika lulus yang sudah dibatalkan cancellationToken. Pengecualian yang dilemparkan 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)
GetTime(Int32)	Mendapatkan nilai kolom yang ditentukan sebagai TimeSpan objek.
GetType()	Mendapatkan instans Type saat ini. (Diperoleh dari Object)
GetValue(Int32)	Mendapatkan nilai kolom pada ordinal 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 yang saat ini Object. (Diperoleh dari Object)
MemberwiseClone(Boolean)	Membuat salinan dangkal objek saat ini MarshalByRefObject . (Diperoleh dari MarshalByRefObject)
NextResult()	Memajukan OdbcDataReader ke hasil berikutnya saat membaca hasil pernyataan SQL batch.
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 OdbcDataReader 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 bisa DbDataReader mendapatkan skema kolom.
GetColumnSchema(DbDataReader)	Mendapatkan skema kolom (DbColumn koleksi) 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 sejumlah karakter tertentu dari kolom tertentu yang dimulai dari 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 jenis data dari kolom yang ditentukan.
GetDateTime(DbDataReader, String)	Mendapatkan nilai kolom yang ditentukan sebagai DateTime objek.
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 jenis 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 floating 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)	Mentransmisikan elemen dari IEnumerable ke jenis yang ditentukan.
OfType<TResult>(IEnumerable)	Memfilter elemen berdasarkan IEnumerable jenis tertentu.
AsParallel(IEnumerable)	Mengaktifkan paralelisasi kueri.
AsQueryable(IEnumerable)	Mengonversi menjadi IEnumerableIQueryable.
ConfigureAwait(IAsyncDisposable, Boolean)	Mengonfigurasi bagaimana menunggu tugas yang dikembalikan dari asinkron sekali pakai dilakukan.

Lihat juga

• DataAdapters dan DataReaders