Aracılığıyla paylaş


DataTableReader Sınıf

Tanım

DataTableReader, bir veya daha fazla DataTable nesnesinin içeriğini bir veya daha fazla salt okunur, salt iletme sonuç kümesi biçiminde alır.

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
Devralma

Açıklamalar

DataTableReader, SqlDataReadergibi diğer tüm veri okuyucular gibi çalışır, ancak DataTableReader bir DataTableiçindeki satırlar üzerinde yineleme sağlar. Başka bir deyişle, önbellekteki satırlar üzerinde yineleme sağlar. Önbelleğe alınan veriler, DataTableReader etkinken değiştirilebilir ve okuyucu konumunu otomatik olarak korur.

bir DataTablebir DataTableReader oluşturduğunuzda, sonuçta elde edilen DataTableReader nesnesi, silinmiş olarak işaretlenmiş tüm satırlar dışında oluşturulduğu DataTable ile aynı verileri içeren bir sonuç kümesi içerir. Sütunlar özgün DataTableile aynı sırada görünür. Döndürülen sonucun yapısı şema ve verilerde özgün DataTableaynıdır. bir DataSet nesnesinin CreateDataReader yöntemi çağrılarak oluşturulan bir DataTableReader, DataSet birden çok tablo içeriyorsa birden çok sonuç kümesi içerir. Sonuçlar, DataSet nesnesinin DataTableCollectionDataTable nesneleriyle aynı sıradadır.

Döndürülen sonuç kümesi her DataRowyalnızca geçerli sürümünü içerir; silinmek üzere işaretlenmiş satırlar atlanır.

DataTableReader kararlı bir yineleyici sağlar; başka bir ifadeyle, temel alınan koleksiyonun boyutu yineleme sırasında değiştirilirse DataTableReader içeriği geçersiz kılınmıyor. Örneğin, Rows koleksiyonundaki bir veya daha fazla satır yineleme sırasında silinir veya kaldırılırsa, DataTableReader içindeki geçerli konum uygun şekilde korunur ve yineleyiciyi geçersiz kılmaz.

Oluşturucular

DataTableReader(DataTable)

Sağlanan DataTableverilerini kullanarak DataTableReader sınıfının yeni bir örneğini başlatır.

DataTableReader(DataTable[])

Sağlanan DataTable nesneleri dizisini kullanarak DataTableReader sınıfının yeni bir örneğini başlatır.

Özellikler

Depth

DataTableReadergeçerli satırı için iç içe yerleştirme derinliği.

FieldCount

Geçerli satırdaki sütun sayısını döndürür.

HasRows

DataTableReader bir veya daha fazla satır içerdiğini gösteren bir değer alır.

IsClosed

DataTableReader kapatılıp kapatılmadığını gösteren bir değer alır.

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 eklenen, değiştirilen 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()

Geçerli DataTableReaderkapatı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)
GetBoolean(Int32)

Belirtilen sütunun değerini Booleanolarak alır.

GetByte(Int32)

Belirtilen sütunun değerini bayt olarak alır.

GetBytes(Int32, Int64, Byte[], Int32, Int32)

Belirtilen sütun uzaklığında başlayan bayt akışını, belirtilen arabellek uzaklığından başlayan bir dizi olarak arabelleğe okur.

GetChar(Int32)

Belirtilen sütunun değerini karakter olarak alır.

GetChars(Int32, Int64, Char[], Int32, Int32)

Belirtilen sütunun değerini karakter dizisi olarak döndürür.

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 cancellationTokengeç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)

İstenen sütun için iç içe veri okuyucu döndürür.

(Devralındığı yer: DbDataReader)
GetDataTypeName(Int32)

Belirtilen sütunun veri türünü temsil eden bir dize 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 Decimalolarak alır.

GetDouble(Int32)

Sütunun değerini çift duyarlıklı kayan nokta sayısı olarak alır.

GetEnumerator()

Öğe koleksiyonunda yinelemek için kullanılabilecek bir numaralandırıcı 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 nokta numarası 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 değerini Stringolarak alır.

GetOrdinal(String)

Sütunun adı verilen sıra sütununu alır.

GetProviderSpecificFieldType(Int32)

Belirtilen sütunun türünü sağlayıcıya özgü biçimde alır.

GetProviderSpecificValue(Int32)

Belirtilen sütunun değerini sağlayıcıya özgü biçimde alır.

GetProviderSpecificValues(Object[])

Sağlanan diziyi, DataTableReaderiçindeki tüm sütunlar için sağlayıcıya özgü tür bilgileriyle doldurur.

GetSchemaTable()

DataTableReadersü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 cancellationTokengeç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 dize olarak alır.

GetTextReader(Int32)

Sütundan veri almak için bir metin okuyucu alır.

(Devralındığı yer: DbDataReader)
GetType()

Geçerli örneğin Type alır.

(Devralındığı yer: Object)
GetValue(Int32)

Belirtilen 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çerdiğ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()

varsa, DataTableReader sonraki sonuç kümesine 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()

DataTableReader 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)

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 IEnumerableIQueryabledö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