OdbcDataReader Sınıf

Tanım

Ad Alanı:

System.Data.Odbc

Bütünleştirilmiş Kod:

System.Data.Odbc.dll

Paket:

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

Kaynak:

OdbcDataReader.cs

Bir veri kaynağından yalnızca iletilen 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

MarshalByRefObject

DbDataReader

OdbcDataReader

Örnekler

Aşağıdaki örnek, bir OdbcConnection, OdbcCommandve OdbcDataReaderoluşturur. Örnek, verileri okuyup konsola yazar. Son olarak, örnek öğesini ve ardından öğesini OdbcConnectionkapatırOdbcDataReader.

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 OdbcCommand yöntemini çağırmanız ExecuteReader gerekir.

OdbcDataReader kullanılırken, ilişkili OdbcConnection hizmeti ile OdbcDataReadermeşgul ve kapatma dışında başka bir işlem gerçekleştirilemezOdbcConnection. yöntemi OdbcDataReader çağrılana Close 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 ayarlanan 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ğlıdır.

IsClosed ve RecordsAffected kapatıldıktan sonra OdbcDataReader çağırabileceğiniz tek özelliklerdir. Bazen, çağrısı yapmadan önce çağrısı CloseRecordsAffectedyapmanız gerekir.

Özellikler

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çerip içermediğ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.
VisibleFieldCount	içinde DbDataReader gizlenmeyen alanların sayısını alır. (Devralındığı yer: DbDataReader)

Yöntemler

Close()	OdbcDataReader Nesneyi kapatır.
CloseAsync()	Nesneyi zaman uyumsuz olarak kapatır DbDataReader . (Devralındığı yer: DbDataReader)
CreateObjRef(Type)	Uzak bir nesneyle iletişim kurmak için kullanılan bir ara sunucu oluşturmak için gereken tüm ilgili bilgileri içeren bir nesne oluşturur. (Devralındığı yer: MarshalByRefObject)
Dispose()	DbDataReader sınıfının geçerli örneği tarafından kullanılan tüm kaynakları serbest bırakır. (Devralındığı yer: DbDataReader)
Dispose(Boolean)	DbDataReader tarafından kullanılan yönetilmeyen kaynakları serbest bırakır ve yönetilen kaynakları isteğe bağlı olarak serbest bırakır. (Devralındığı yer: DbDataReader)
DisposeAsync()	Sınıfın geçerli örneği DbDataReader tarafından kullanılan tüm kaynakları zaman uyumsuz olarak serbest bırakır. (Devralındığı yer: DbDataReader)
Equals(Object)	Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler. (Devralındığı yer: Object)
GetBoolean(Int32)	Belirtilen sütunun değerini Boole değeri 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 bayt akışını bir dizi olarak 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.
GetColumnSchemaAsync(CancellationToken)	Bu, zaman uyumsuz sürümüdür GetColumnSchema(DbDataReader). Sağlayıcılar uygun bir uygulamayla geçersiz kılmalıdır. cancellationToken isteğe bağlı olarak kabul edilebilir. Varsayılan uygulama zaman uyumlu GetColumnSchema(DbDataReader) çağrıyı çağırır ve tamamlanmış bir görev döndürür. Varsayılan uygulama, zaten iptal edilmiş bir geçirildiyse iptal edilmiş cancellationTokenbir görev döndürür. tarafından GetColumnSchema(DbDataReader) oluşan özel durumlar, döndürülen Görev Özel Durumu özelliği aracılığıyla iletilecektir. (Devralındığı yer: DbDataReader)
GetData(Int32)	İstenen sütun için iç içe veri okuyucu döndürür. (Devralındığı yer: DbDataReader)
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.
GetDbDataReader(Int32)	DbDataReader İstenen sütun sıralı için sağlayıcıya özgü bir uygulamayla geçersiz kılınabilecek bir nesne döndürür. (Devralındığı yer: DbDataReader)
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)	Nesnenin Type veri türü olan öğesini alır.
GetFieldValue<T>(Int32)	Belirtilen sütunun değerini istenen tür olarak alır. (Devralındığı yer: DbDataReader)
GetFieldValueAsync<T>(Int32)	Belirtilen sütunun değerini istenen tür olarak zaman uyumsuz olarak alır. (Devralındığı yer: DbDataReader)
GetFieldValueAsync<T>(Int32, CancellationToken)	Belirtilen sütunun değerini istenen tür olarak zaman uyumsuz olarak alır. (Devralındığı yer: DbDataReader)
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 bir tanımlayıcı (GUID) olarak alır.
GetHashCode()	Varsayılan karma işlevi işlevi görür. (Devralındığı yer: Object)
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 işaretli tamsayı olarak alır.
GetLifetimeService()	Geçersiz. Bu örnek için yaşam süresi ilkesini denetleen geçerli yaşam süresi hizmet nesnesini alır. (Devralındığı yer: MarshalByRefObject)
GetName(Int32)	Belirtilen sütunun adını alır.
GetOrdinal(String)	Sütunun adı verilip sütun sırasını alır.
GetProviderSpecificFieldType(Int32)	Belirtilen sütunun sağlayıcıya özgü türünü alır. (Devralındığı yer: DbDataReader)
GetProviderSpecificValue(Int32)	Belirtilen sütunun değerini sağlayıcıya özgü bir türün örneği olarak alır. (Devralındığı yer: DbDataReader)
GetProviderSpecificValues(Object[])	Geçerli satır için koleksiyondaki sağlayıcıya özgü tüm öznitelik sütunlarını alır. (Devralındığı yer: DbDataReader)
GetSchemaTable()	sütun meta verilerini OdbcDataReaderaçıklayan bir DataTable döndürür.
GetSchemaTableAsync(CancellationToken)	Bu, zaman uyumsuz sürümüdür GetSchemaTable(). Sağlayıcılar uygun bir uygulamayla geçersiz kılmalıdır. cancellationToken isteğe bağlı olarak kabul edilebilir. Varsayılan uygulama zaman uyumlu GetSchemaTable() çağrıyı çağırır ve tamamlanmış bir görev döndürür. Varsayılan uygulama, zaten iptal edilmiş bir geçirildiyse iptal edilmiş cancellationTokenbir görev döndürür. tarafından GetSchemaTable() oluşan özel durumlar, döndürülen Görev Özel Durumu özelliği aracılığıyla iletilecektir. (Devralındığı yer: DbDataReader)
GetStream(Int32)	Belirtilen sütundan veri almak için bir akış alır. (Devralındığı yer: DbDataReader)
GetString(Int32)	Belirtilen sütunun değerini olarak Stringalır.
GetTextReader(Int32)	Sütundan veri almak için bir metin okuyucu alır. (Devralındığı yer: DbDataReader)
GetTime(Int32)	Belirtilen sütunun değerini nesne TimeSpan olarak alır.
GetType()	Type Geçerli örneğini alır. (Devralındığı yer: Object)
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.
InitializeLifetimeService()	Geçersiz. Bu örneğin yaşam süresi ilkesini denetlemek için bir yaşam süresi hizmet nesnesi alır. (Devralındığı yer: MarshalByRefObject)
IsDBNull(Int32)	Sütunun var olmayan veya eksik değerler içerip içermediğini gösteren bir değer alır.
IsDBNullAsync(Int32)	Zaman uyumsuz olarak, sütunun var olmayan veya eksik değerler içerdiğini belirten bir değer alır. (Devralındığı yer: DbDataReader)
IsDBNullAsync(Int32, CancellationToken)	Zaman uyumsuz olarak, sütunun var olmayan veya eksik değerler içerdiğini belirten bir değer alır. (Devralındığı yer: DbDataReader)
MemberwiseClone()	Geçerli Objectöğesinin sığ bir kopyasını oluşturur. (Devralındığı yer: Object)
MemberwiseClone(Boolean)	Geçerli MarshalByRefObject nesnenin sığ bir kopyasını oluşturur. (Devralındığı yer: MarshalByRefObject)
NextResult()	Batch SQL deyimlerinin OdbcDataReader sonuçlarını okurken öğesini sonraki sonuca ilerler.
NextResultAsync()	Bir deyim toplu işleminin sonuçlarını okurken okuyucuyu zaman uyumsuz olarak sonraki sonuca ilerler. (Devralındığı yer: DbDataReader)
NextResultAsync(CancellationToken)	Bir deyim toplu işleminin sonuçlarını okurken okuyucuyu zaman uyumsuz olarak sonraki sonuca ilerler. (Devralındığı yer: DbDataReader)
Read()	öğesini OdbcDataReader sonraki kayda ilerler.
ReadAsync()	Zaman uyumsuz olarak okuyucuyu bir sonuç kümesindeki bir sonraki kayda ilerler. (Devralındığı yer: DbDataReader)
ReadAsync(CancellationToken)	Zaman uyumsuz olarak okuyucuyu bir sonuç kümesindeki bir sonraki kayda ilerler. (Devralındığı yer: DbDataReader)
ToString()	Geçerli nesneyi temsil eden dizeyi döndürür. (Devralındığı yer: Object)

Belirtik Arabirim Kullanımları

IDataRecord.GetData(Int32)

Bu üyenin açıklaması için bkz GetData(Int32). . (Devralındığı yer: DbDataReader)

Uzantı Metotları

CanGetColumnSchema(DbDataReader)	bir sütun şeması alıp DbDataReader alamayacağını belirten bir değer alır.
GetColumnSchema(DbDataReader)	bir DbDataReaderiçin sütun şemasını (DbColumnkoleksiyon) alır.
GetBoolean(DbDataReader, String)	Belirtilen sütunun değerini Boole değeri olarak alır.
GetByte(DbDataReader, String)	Belirtilen sütunun değerini bayt olarak alır.
GetBytes(DbDataReader, String, Int64, Byte[], Int32, Int32)	Belirtilen dizinden başlayarak belirtilen sütundan belirtilen sayıda bayt okur ve bunları arabellekte belirtilen konumdan başlayan bir arabelleğe yazar.
GetChar(DbDataReader, String)	Belirtilen sütunun değerini tek bir karakter olarak alır.
GetChars(DbDataReader, String, Int64, Char[], Int32, Int32)	Belirtilen bir dizinden başlayarak belirtilen sütundan belirtilen sayıda karakteri okur ve bunları belirtilen konumdan başlayan bir arabelleğe yazar.
GetData(DbDataReader, String)	İstenen sütun için iç içe veri okuyucu döndürür.
GetDataTypeName(DbDataReader, String)	Belirtilen sütunun veri türünün adını alır.
GetDateTime(DbDataReader, String)	Belirtilen sütunun değerini nesne DateTime olarak alır.
GetDecimal(DbDataReader, String)	Belirtilen sütunun değerini olarak Decimalalır.
GetDouble(DbDataReader, String)	Belirtilen sütunun değerini çift duyarlıklı kayan nokta numarası olarak alır.
GetFieldType(DbDataReader, String)	Belirtilen sütunun veri türünü alır.
GetFieldValue<T>(DbDataReader, String)	Belirtilen sütunun değerini istenen tür olarak alır.
GetFieldValueAsync<T>(DbDataReader, String, CancellationToken)	Belirtilen sütunun değerini istenen tür olarak zaman uyumsuz olarak alır.
GetFloat(DbDataReader, String)	Belirtilen sütunun değerini tek duyarlıklı kayan nokta numarası olarak alır.
GetGuid(DbDataReader, String)	Belirtilen sütunun değerini genel olarak benzersiz bir tanımlayıcı (GUID) olarak alır.
GetInt16(DbDataReader, String)	Belirtilen sütunun değerini 16 bit imzalı tamsayı olarak alır.
GetInt32(DbDataReader, String)	Belirtilen sütunun değerini 32 bit imzalı tamsayı olarak alır.
GetInt64(DbDataReader, String)	Belirtilen sütunun değerini 64 bit işaretli tamsayı olarak alır.
GetProviderSpecificFieldType(DbDataReader, String)	Belirtilen sütunun sağlayıcıya özgü türünü alır.
GetProviderSpecificValue(DbDataReader, String)	Belirtilen sütunun değerini sağlayıcıya özgü bir türün örneği olarak alır.
GetStream(DbDataReader, String)	Belirtilen sütundan veri almak için bir akış alır.
GetString(DbDataReader, String)	Belirtilen sütunun değerini örneği Stringolarak alır.
GetTextReader(DbDataReader, String)	Sütundan veri almak için bir metin okuyucu alır.
GetValue(DbDataReader, String)	Belirtilen sütunun değerini örneği Objectolarak alır.
IsDBNull(DbDataReader, String)	Sütunun var olmayan veya eksik değerler içerip içermediğini gösteren bir değer alır.
IsDBNullAsync(DbDataReader, String, CancellationToken)	Zaman uyumsuz olarak, sütunun var olmayan veya eksik değerler içerdiğini belirten bir değer alır.
Cast<TResult>(IEnumerable)	öğesinin IEnumerable öğelerini belirtilen türe atar.
OfType<TResult>(IEnumerable)	Öğesinin IEnumerable öğelerini belirtilen türe göre filtreler.
AsParallel(IEnumerable)	Sorgunun paralelleştirilmesini etkinleştirir.
AsQueryable(IEnumerable)	bir IEnumerable öğesini öğesine IQueryabledönüştürür.
ConfigureAwait(IAsyncDisposable, Boolean)	Zaman uyumsuz bir atılabilir öğeden döndürülen görevlerde awaits işleminin nasıl gerçekleştirildiğini yapılandıran.

Ayrıca bkz.

• DataAdapters ve DataReaders