DataTableReader Sınıf

Tanım

Ad Alanı:

System.Data

Bütünleştirilmiş Kod:

System.Data.Common.dll

Bütünleştirilmiş Kod:

System.Data.dll

Bütünleştirilmiş Kod:

netstandard.dll

, DataTableReader bir veya daha fazla DataTable nesnenin içeriğini bir veya daha fazla salt okunur, yalnızca ileriye doğru 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

Object

MarshalByRefObject

DbDataReader

DataTableReader

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 CreateDataReader DataSet yöntemi çağrılarak oluşturulan, birden çok tablo içeriyorsa birden çok sonuç kümesi DataSet içerir. Sonuçlar, nesnenin içindeki nesnelerle DataTable DataTableCollection DataSet aynı sıradadır.

Döndürülen sonuç kümesi her birinin 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 koleksiyonun DataTableReader boyutu yineleme sırasında değiştirilirse içeriğinin geçersiz kılınmaması. Örneğin, koleksiyondaki Rows bir veya daha fazla satır yineleme sırasında silinir veya kaldırılırsa içindeki geçerli konum DataTableReader uygun şekilde korunur ve yineleyiciyi geçersiz kılmaz.

Oluşturucular

DataTableReader(DataTable)	Sağlanan DataTableöğesinden verileri kullanarak sınıfının yeni bir örneğini DataTableReader 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

Depth	öğesinin 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çerip içermediğini DataTableReader belirten bir değer alır.
IsClosed	öğesinin kapatılıp kapatılmadığını DataTableReader belirten bir değer alır.
Item[Int32]	Belirtilen sütunun değerini, sütun sırasıyla verilen 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 gizlenmeyen alanların sayısını alır. (Devralındığı yer: DbDataReader)

Yöntemler

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()	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 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.
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)	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 yineleme yapmak için kullanılabilecek bir numaralandırıcı döndürür.
GetFieldType(Int32)	Nesnenin Type 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)	Belirtilen sütunun değerini zaman uyumsuz olarak istenen tür olarak alır. (Devralındığı yer: DbDataReader)
GetFieldValueAsync<T>(Int32, CancellationToken)	Belirtilen sütunun değerini zaman uyumsuz olarak istenen tür olarak alır. (Devralındığı yer: DbDataReader)
GetFloat(Int32)	Belirtilen sütunun değerini tek duyarlıklı kayan nokta sayısı 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 işaretli tamsayı olarak alır.
GetLifetimeService()	Kullanımdan kalktı. 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ı verilip sütun sırasını 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 DataTableReadertüm sütunlar için sağlayıcıya özgü tür bilgileriyle doldurur.
GetSchemaTable()	sütun meta verilerini DataTableReaderaçı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 dize olarak alır.
GetTextReader(Int32)	Sütundan veri almak için bir metin okuyucu alır. (Devralındığı yer: DbDataReader)
GetType()	Type Geçerli örneğini 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()	Kullanımdan kalktı. 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 değerler mi yoksa eksik değerler mi içerdiğ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()	varsa öğesini DataTableReader sonraki sonuç kümesine 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 DataTableReader 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)	İstenen tür olarak belirtilen sütunun değerini alır.
GetFieldValueAsync<T>(DbDataReader, String, CancellationToken)	Belirtilen sütunun değerini zaman uyumsuz olarak istenen tür olarak alır.
GetFloat(DbDataReader, String)	Belirtilen sütunun değerini tek duyarlıklı kayan nokta sayısı 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 belirten 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)	Bir öğesinin IEnumerable öğelerini belirtilen türe göre filtreler.
AsParallel(IEnumerable)	Sorgunun paralelleştirilmesini sağlar.
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ırıyor.