OdbcDataReader Sınıf

Tanım

Ad Alanı:

System.Data.Odbc

Bütünleştirilmiş Kod:

System.Data.Odbc.dll

Paket:

System.Data.Odbc v11.0.0-preview.4.26230.115

Kaynak:

OdbcDataReader.cs

Bir veri kaynağından yalnızca ileriye doğru veri satırları akışını okumanın bir yolunu sağlar. Bu sınıf devralınamaz.

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

Devralma

Object

DbDataReader

OdbcDataReader

Örnekler

Aşağıdaki örnek, bir OdbcConnection, OdbcCommandve oluşturur OdbcDataReader. Örnek, verileri okuyarak konsola yazar. Son olarak, örnek öğesini ve ardından öğesini OdbcDataReaderkapatırOdbcConnection.

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

Açıklamalar

oluşturmak OdbcDataReaderiçin, doğrudan bir oluşturucu kullanmak yerine nesnesinin ExecuteReader yöntemini çağırmanız OdbcCommand gerekir.

OdbcDataReader kullanılırken, ilişkili OdbcConnection hizmeti ile OdbcDataReadermeşgul ve kapatma dışında başka hiçbir işlem gerçekleştirilemezOdbcConnection. yöntemi Close çağrılana OdbcDataReader kadar bu durum söz konusudur. Örneğin, çağrısından Closesonraya kadar çıkış parametrelerini alamazsınız.

Veriler okunurken başka bir işlem veya iş parçacığı tarafından bir sonuç kümesinde yapılan değişiklikler, kullanıcı tarafından OdbcDataReadergörülebilir. Ancak, kesin davranış hem sürücü hem de zamanlama bağımlıdır.

IsClosed ve RecordsAffected kapatıldıktan sonra OdbcDataReader çağırabileceğiniz tek özelliklerdir. Bazen, çağırabilmeniz için önce öğesini aramanız CloseRecordsAffectedgerekir.

Özellikler

Name	Description
Depth	Geçerli satır için iç içe yerleştirme derinliğini gösteren bir değer alır.
FieldCount	Geçerli satırdaki sütun sayısını alır.
HasRows	öğesinin bir veya daha fazla satır içerdiğini OdbcDataReader belirten bir değer alır.
IsClosed	öğesinin OdbcDataReader kapatılıp kapatılmadığını gösterir.
Item[Int32]	Belirtilen sütunun değerini, sütun sırasıyla yerel biçiminde alır.
Item[String]	Belirtilen sütunun değerini, sütun adı verilen yerel biçiminde alır.
RecordsAffected	SQL deyiminin yürütülmesiyle değiştirilen, eklenen veya silinen satır sayısını alır.

Yöntemler

Name	Description
Close()	OdbcDataReader Nesneyi kapatır.
GetBoolean(Int32)	Belirtilen sütunun değerini Boole olarak alır.
GetByte(Int32)	Belirtilen sütunun değerini bayt olarak alır.
GetBytes(Int32, Int64, Byte[], Int32, Int32)	Belirli bir arabellek uzaklığından başlayarak belirtilen sütun uzaklığından arabelleğe dizi olarak bayt akışını okur.
GetChar(Int32)	Belirtilen sütunun değerini karakter olarak alır.
GetChars(Int32, Int64, Char[], Int32, Int32)	Belirli bir arabellek uzaklığından başlayarak belirtilen sütun uzaklığından arabelleğe dizi olarak bir karakter akışı okur.
GetDataTypeName(Int32)	Kaynak veri türünün adını alır.
GetDate(Int32)	Belirtilen sütunun değerini nesne DateTime olarak alır.
GetDateTime(Int32)	Belirtilen sütunun değerini nesne DateTime olarak alır.
GetDecimal(Int32)	Belirtilen sütunun değerini nesne Decimal olarak alır.
GetDouble(Int32)	Belirtilen sütunun değerini çift duyarlıklı kayan noktalı sayı olarak alır.
GetEnumerator()	Veri okuyucudaki satırlar arasında yineleme yapmak için kullanılabilecek bir IEnumerator döndürür.
GetFieldType(Int32)	Type Nesnenin veri türü olan öğesini alır.
GetFloat(Int32)	Belirtilen sütunun değerini tek duyarlıklı kayan noktalı sayı olarak alır.
GetGuid(Int32)	Belirtilen sütunun değerini genel olarak benzersiz tanımlayıcı (GUID) olarak alır.
GetInt16(Int32)	Belirtilen sütunun değerini 16 bit imzalı tamsayı olarak alır.
GetInt32(Int32)	Belirtilen sütunun değerini 32 bit imzalı tamsayı olarak alır.
GetInt64(Int32)	Belirtilen sütunun değerini 64 bit imzalı tamsayı olarak alır.
GetName(Int32)	Belirtilen sütunun adını alır.
GetOrdinal(String)	Sütunun adı verilen sıra sütununu alır.
GetSchemaTable()	sütun meta verilerini DataTableaçıklayan bir OdbcDataReader döndürür.
GetString(Int32)	Belirtilen sütunun değerini olarak Stringalır.
GetTime(Int32)	Belirtilen sütunun değerini nesne TimeSpan olarak alır.
GetValue(Int32)	Belirtilen sıradaki sütunun değerini yerel biçiminde alır.
GetValues(Object[])	Bir nesne dizisini geçerli satırın sütun değerleriyle doldurur.
IsDBNull(Int32)	Sütunun var olmayan veya eksik değerler içerip içermediğini gösteren bir değer alır.
NextResult()	Toplu SQL deyimlerinin OdbcDataReader sonuçlarını okurken öğesini sonraki sonuca ilerler.
Read()	öğesini OdbcDataReader sonraki kayda ilerler.

Ayrıca bkz.

• Veri Adaptörleri (DataAdapters) ve Veri Okuyucular (DataReaders)