DataTableReader Sınıf

Tanım

DataTableReader, bir veya daha fazla DataTable nesnesinin içeriğini bir veya daha fazla salt okunur, ileri yönlü sonuç kümesi şeklinde 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 gibi diğer tüm veri okuyucuları gibi SqlDataReaderçalışır, ancak DataTableReader içindeki satırlar DataTableüzerinde yineleme sağlar. Başka bir deyişle, önbellekteki satırlar üzerinde yineleme sağlar. Önbelleğe alınan veriler etkinken DataTableReader değiştirilebilir ve okuyucu konumunu otomatik olarak korur.

bir öğesinden DataTableoluşturduğunuzdaDataTableReader, sonuçta elde edilen DataTableReader nesne, silinmiş olarak işaretlenmiş tüm satırlar dışında oluşturulduğu verilerle aynı veriye DataTable sahip 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ı şemada ve verilerde özgün DataTableile aynıdır. Bir DataTableReader nesnenin CreateDataReaderDataSet yöntemi çağrılarak oluşturulan, birden çok tablo içeriyorsa birden çok sonuç kümesi DataSet içerir. Sonuçlar, nesnenin DataTable içindeki nesnelerle DataTableCollection aynı sıradadır DataSet .

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

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

Oluşturucular

Name Description
DataTableReader(DataTable)

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

DataTableReader(DataTable[])

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

Özellikler

Name Description
Depth

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

FieldCount

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

HasRows

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

IsClosed

öğesinin kapatılıp kapatılmadığını DataTableReader 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

içinde DbDataReader gizli olmayan alanların sayısını alır.

(Devralındığı yer: DbDataReader)

Yöntemler

Name Description
Close()

Geçerli DataTableReaderöğesini 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()

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

(Devralındığı yer: DbDataReader)
Dispose(Boolean)

tarafından DbDataReader 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()

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 olarak Booleanalı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.

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 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 olarak Decimalalı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)

Type Nesnenin veri türü olan öğesini 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()

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 olarak Stringalı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 içindeki tüm sütunlar DataTableReaderiçin sağlayıcıya özgü tür bilgileriyle doldurur.

GetSchemaTable()

sütun meta verilerini DataTableaçıklayan bir DataTableReader döndürür.

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

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 nesnenin sığ bir kopyasını oluşturur.

(Devralındığı yer: MarshalByRefObject)
NextResult()

varsa öğesini 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()

öğesini 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ı

Name Description
IDataRecord.GetData(Int32)

Bu üyenin açıklaması için bkz GetData(Int32). .

(Devralındığı yer: DbDataReader)

Uzantı Metotları

Name Description
AsParallel(IEnumerable)

Sorgunun paralelleştirilmesini etkinleştirir.

AsQueryable(IEnumerable)

bir IEnumerable öğesine IQueryabledönüştürür.

CanGetColumnSchema(DbDataReader)

Sütun şemasını DbDataReader alıp alamayacağını gösteren bir değer alır.

Cast<TResult>(IEnumerable)

öğesinin IEnumerable öğelerini belirtilen türe yazar.

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.

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.

GetColumnSchema(DbDataReader)

bir DbColumniçin sütun şemasını (DbDataReaderkoleksiyon) alır.

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)

İ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 ö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.

OfType<TResult>(IEnumerable)

Belirtilen türe göre bir IEnumerable öğesinin öğelerini filtreler.

Şunlara uygulanır