OdbcDataReader Sınıf

Başvuru

Tanım

Ad Alanı:: System.Data.Odbc

Bütünleştirilmiş Kod:: System.Data.Odbc.dll

Bütünleştirilmiş Kod:: System.Data.dll

Paket:: System.Data.Odbc v8.0.0

Paket:: System.Data.Odbc v9.0.0-rc.1.24431.7

Kaynak:: OdbcDataReader.cs

Kaynak:: OdbcDataReader.cs

Kaynak:: OdbcDataReader.cs

Kaynak:: OdbcDataReader.cs

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

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 ref class OdbcDataReader sealed : MarshalByRefObject, IDisposable, System::Collections::IEnumerable, System::Data::IDataReader

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

public sealed class OdbcDataReader : MarshalByRefObject, IDisposable, System.Collections.IEnumerable, System.Data.IDataReader

type OdbcDataReader = class
    inherit DbDataReader

type OdbcDataReader = class
    inherit MarshalByRefObject
    interface IDataReader
    interface IDataRecord
    interface IDisposable
    interface IEnumerable

Public NotInheritable Class OdbcDataReader
Inherits DbDataReader

Public NotInheritable Class OdbcDataReader
Inherits MarshalByRefObject
Implements IDataReader, IDisposable, IEnumerable

Devralma: Object

MarshalByRefObject

DbDataReader
OdbcDataReader

Devralma: Object

MarshalByRefObject
OdbcDataReader

Uygulamalar: IEnumerable IDataReader IDataRecord IDisposable

Örnekler

Aşağıdaki örnek bir OdbcConnection, bir OdbcCommandve bir OdbcDataReaderoluşturur. Örnek, verileri okuyarak konsola yazar. Son olarak, örnek OdbcDataReaderve ardından OdbcConnectionkapatır.

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

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

OdbcDataReader kullanılırken, ilişkili OdbcConnection OdbcDataReaderhizmet etmekle meşgul ve OdbcConnection kapatmak dışında başka hiçbir işlem gerçekleştirilemez. OdbcDataReader Close yöntemi çağrılana kadar bu durum söz konusudur. Örneğin, Closeçağrısından sonraya 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 OdbcDataReaderkullanıcısı tarafından görülebilir. Ancak, kesin davranış hem sürücü hem de zamanlama bağımlıdır.

IsClosed ve RecordsAffected, OdbcDataReader kapatıldıktan sonra çağırabileceğiniz tek özelliklerdir. Bazen, RecordsAffectedçağırabilmeniz için önce Close'ı çağırmanı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	OdbcDataReader bir veya daha fazla satır içerdiğini gösteren bir değer alır.
IsClosed	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	DbDataReader gizli olmayan alan sayısını alır. (Devralındığı yer: DbDataReader)

Yöntemler

Close()	OdbcDataReader nesnesini kapatır.
CloseAsync()	DbDataReader nesnesini zaman uyumsuz olarak kapatır. (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 isteğe bağlı olarak yönetilen kaynakları serbest bırakır. (Devralındığı yer: DbDataReader)
DisposeAsync()	DbDataReader sınıfının geçerli örneği 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)
Finalize()	Nesnenin, atık toplama tarafından geri kazanılmadan önce kaynakları boşaltmaya ve diğer temizleme işlemlerini gerçekleştirmeye çalışmasına izin verir.
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.
GetColumnSchemaAsync(CancellationToken)	Bu, GetColumnSchema(DbDataReader)zaman uyumsuz sürümüdür. 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ısını çağırır ve tamamlanmış bir görev döndürür. Varsayılan uygulama, zaten iptal edilmiş bir `cancellationToken`geçirilirse iptal edilmiş bir görev döndürür. GetColumnSchema(DbDataReader) tarafından oluşan özel durumlar, döndürülen Görev Özel Durumu özelliği aracılığıyla iletilecektir. (Devralındığı yer: DbDataReader)
GetData(Int32)	Belirtilen sütun sıralı için bir IDataReader döndürür.
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 DateTime nesnesi olarak alır.
GetDateTime(Int32)	Belirtilen sütunun değerini DateTime nesnesi olarak alır.
GetDbDataReader(Int32)	İstenen sütun sıralı için sağlayıcıya özgü bir uygulamayla geçersiz kılınabilecek bir DbDataReader nesnesi döndürür. (Devralındığı yer: DbDataReader)
GetDecimal(Int32)	Belirtilen sütunun değerini Decimal nesnesi 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 veri türü olan Type alır.
GetFieldValue<T>(Int32)	İstenen tür olarak belirtilen sütunun değerini 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)
GetFieldValueAsync<T>(Int32)	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 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 imzalı 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ı verilen sıra sütununu 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()	OdbcDataReadersütun meta verilerini açıklayan bir DataTable döndürür.
GetSchemaTableAsync(CancellationToken)	Bu, GetSchemaTable()zaman uyumsuz sürümüdür. 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ısını çağırır ve tamamlanmış bir görev döndürür. Varsayılan uygulama, zaten iptal edilmiş bir `cancellationToken`geçirilirse iptal edilmiş bir görev döndürür. GetSchemaTable() tarafından 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 Stringolarak alı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 TimeSpan nesnesi olarak alır.
GetType()	Geçerli örneğin Type 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, 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)
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)
MemberwiseClone()	Geçerli Objectbasit bir kopyasını oluşturur. (Devralındığı yer: Object)
MemberwiseClone(Boolean)	Geçerli MarshalByRefObject nesnesinin sığ bir kopyasını oluşturur. (Devralındığı yer: MarshalByRefObject)
NextResult()	Batch SQL deyimlerinin sonuçlarını okurken OdbcDataReader sonraki sonuca ilerler.
NextResultAsync()	Bir grup deyimin sonuçlarını okurken okuyucuyu zaman uyumsuz olarak sonraki sonuca ilerler. (Devralındığı yer: DbDataReader)
NextResultAsync(CancellationToken)	Bir grup deyimin sonuçlarını okurken okuyucuyu zaman uyumsuz olarak sonraki sonuca ilerler. (Devralındığı yer: DbDataReader)
Read()	OdbcDataReader sonraki kayda ilerler.
ReadAsync()	Okuyucuyu zaman uyumsuz olarak sonuç kümesindeki bir sonraki kayda ilerler. (Devralındığı yer: DbDataReader)
ReadAsync(CancellationToken)	Okuyucuyu zaman uyumsuz olarak sonuç kümesindeki bir sonraki kayda ilerler. (Devralındığı yer: DbDataReader)
ToString()	Geçerli nesneyi temsil eden bir dize 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)

IDisposable.Dispose()

Bu API, ürün altyapısını destekler ve doğrudan kodunuzdan kullanıma yönelik değildir.

OdbcDataReader sınıfının geçerli örneği tarafından kullanılan tüm kaynakları serbest bırakır.

IEnumerable.GetEnumerator()

Bu API, ürün altyapısını destekler ve doğrudan kodunuzdan kullanıma yönelik değildir.

Bir koleksiyonda yineleyen bir numaralandırıcı döndürür.

Uzantı Metotları

CanGetColumnSchema(DbDataReader)	bir DbDataReader sütun şeması alıp alamayacağını gösteren bir değer alır.
GetColumnSchema(DbDataReader)	bir DbDataReaderiçin sütun şemasını (DbColumn koleksiyonu) alır.
GetBoolean(DbDataReader, String)	Belirtilen sütunun değerini Boole 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 sütundan belirtilen sayıda karakteri belirtilen bir dizinden başlayarak okur ve belirtilen konumdan başlayarak 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 DateTime nesnesi olarak alır.
GetDecimal(DbDataReader, String)	Belirtilen sütunun değerini Decimalolarak alı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)	İstenen tür olarak belirtilen sütunun değerini 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 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 imzalı 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 Stringörneği olarak alır.
GetTextReader(DbDataReader, String)	Sütundan veri almak için bir metin okuyucu alır.
GetValue(DbDataReader, String)	Belirtilen sütunun değerini Objectörneği olarak 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)	Bir IEnumerable öğelerini belirtilen türe yayınlar.
OfType<TResult>(IEnumerable)	Bir IEnumerable öğelerini belirtilen türe göre filtreler.
AsParallel(IEnumerable)	Sorgunun paralelleştirilmesini etkinleştirir.
AsQueryable(IEnumerable)	bir IEnumerable 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ştirileceğini yapılandırılır.

Şunlara uygulanır

Ayrıca bkz.

DataAdapters ve DataReaders

Aracılığıyla paylaş