DataTableReader Sınıf

Tanım

, Bir veya daha fazla DataTableReader DataTable nesnenin içeriğini bir veya daha fazla salt okunurdur, salt ileri bir sonuç kümesi biçiminde edinir.The DataTableReader obtains the contents of one or more DataTable objects in the form of one or more read-only, forward-only result sets.

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

, Gibi DataTableReader diğer tüm veri okuyucuları gibi çalışarak, SqlDataReader DataTableReader içindeki satırlar üzerinde yineleme için sağlanmıştır DataTable .The DataTableReader works much like any other data reader, such as the SqlDataReader, except that the DataTableReader provides for iterating over rows in a DataTable. Diğer bir deyişle, bir önbellekteki satırlara yineleme sağlar.In other words, it provides for iterating over rows in a cache. Önbelleğe alınan veriler DataTableReader etkinken değiştirilebilir ve okuyucu konumunu otomatik olarak korur.The cached data can be modified while the DataTableReader is active, and the reader automatically maintains its position.

Bir DataTableReader öğesinden oluşturduğunuzda DataTable , sonuçta elde edilen nesne, DataTableReader DataTable silinmiş olarak işaretlenen satırlar hariç, oluşturulduğu verilerle aynı verilere sahip bir sonuç kümesi içerir.When you create a DataTableReader from a DataTable, the resulting DataTableReader object contains one result set with the same data as the DataTable from which it was created, except for any rows that have been marked as deleted. Sütunlar orijinaldeki aynı sırada görüntülenir DataTable .The columns appear in the same order as in the original DataTable. Döndürülen sonucun yapısı, şema ve verilerle orijinalde aynıdır DataTable .The structure of the returned result is identical in schema and data to the original DataTable. Bir DataTableReader nesnenin yöntemini çağırarak oluşturulmuş bir CreateDataReader DataSet , birden DataSet fazla tablo içeriyorsa birden çok sonuç kümesi içerir.A DataTableReader that was created by calling the CreateDataReader method of a DataSet object contains multiple result sets if the DataSet contains more than one table. Sonuçlar, DataTable nesnesinin içindeki nesnelerle aynı sırada olur DataTableCollection DataSet .The results are in the same sequence as the DataTable objects in the DataTableCollection of the DataSet object.

Döndürülen sonuç kümesi yalnızca her birinin geçerli sürümünü içerir DataRow ; silinmek üzere işaretlenen satırlar atlanır.The returned result set contains only the current version of each DataRow; rows that are marked for deletion are skipped.

, DataTableReader Kararlı bir yineleyici sağlar; diğer bir deyişle, DataTableReader temel alınan koleksiyonun boyutu yineleme sırasında değiştirilirse öğesinin içeriği geçersiz kılınmaz.The DataTableReader provides a stable iterator; that is, the contents of the DataTableReader are not invalidated if the size of the underlying collection is modified during iteration. Örneğin, koleksiyonda bir veya daha fazla satır Rows yineleme sırasında silinirse veya kaldırılırsa, içindeki geçerli konum DataTableReader uygun şekilde tutulur ve yineleyiciyi geçersiz kılmaz.For example, if one or more rows in the Rows collection are deleted or removed during iteration, the current position within the DataTableReader is maintained appropriately and it does not invalidate the iterator.

Oluşturucular

DataTableReader(DataTable)

DataTableReaderSağlanan verileri kullanarak sınıfının yeni bir örneğini başlatır DataTable .Initializes a new instance of the DataTableReader class by using data from the supplied DataTable.

DataTableReader(DataTable[])

DataTableReaderSağlanan nesne dizisini kullanarak sınıfının yeni bir örneğini başlatır DataTable .Initializes a new instance of the DataTableReader class using the supplied array of DataTable objects.

Özellikler

Depth

Öğesinin geçerli satırı için iç içe geçme derinliği DataTableReader .The depth of nesting for the current row of the DataTableReader.

FieldCount

Geçerli satırdaki sütun sayısını döndürür.Returns the number of columns in the current row.

HasRows

DataTableReaderBir veya daha fazla satır içerip içermediğini gösteren bir değer alır.Gets a value that indicates whether the DataTableReader contains one or more rows.

IsClosed

' In kapalı olup olmadığını gösteren bir değer alır DataTableReader .Gets a value that indicates whether the DataTableReader is closed.

Item[Int32]

Belirtilen sütunun değerini, sütun sırası verilen yerel biçiminde alır.Gets the value of the specified column in its native format given the column ordinal.

Item[String]

Belirtilen sütunun değerini, sütun adı verilen yerel biçiminde alır.Gets the value of the specified column in its native format given the column name.

RecordsAffected

SQL deyimindeki yürütme tarafından yerleştirilen, değiştirilen veya silinen satır sayısını alır.Gets the number of rows inserted, changed, or deleted by execution of the SQL statement.

VisibleFieldCount

İçindeki gizli olmayan alan sayısını alır DbDataReader .Gets the number of fields in the DbDataReader that are not hidden.

(Devralındığı yer: DbDataReader)

Yöntemler

Close()

Geçerli bir kapatır DataTableReader .Closes the current DataTableReader.

CloseAsync()

Nesneyi zaman uyumsuz olarak kapatır DbDataReader .Asynchronously closes the DbDataReader object.

(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 bilgileri içeren bir nesne oluşturur.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(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.Releases all resources used by the current instance of the DbDataReader class.

(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.Releases the unmanaged resources used by the DbDataReader and optionally releases the managed resources.

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

Zaman uyumsuz olarak, sınıfın geçerli örneği tarafından kullanılan tüm kaynakları serbest bırakır DbDataReader .Asynchronously releases all resources used by the current instance of the DbDataReader class.

(Devralındığı yer: DbDataReader)
Equals(Object)

Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler.Determines whether the specified object is equal to the current object.

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

Belirtilen sütunun değerini olarak alır Boolean .Gets the value of the specified column as a Boolean.

GetByte(Int32)

Belirtilen sütunun değerini bayt olarak alır.Gets the value of the specified column as a byte.

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

Belirtilen bir sütunda başlayan bir bayt akışını, belirtilen arabellek uzaklığında başlayan bir dizi olarak arabelleğe okur.Reads a stream of bytes starting at the specified column offset into the buffer as an array starting at the specified buffer offset.

GetChar(Int32)

Belirtilen sütunun değerini bir karakter olarak alır.Gets the value of the specified column as a character.

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

Belirtilen sütunun değerini bir karakter dizisi olarak döndürür.Returns the value of the specified column as a character array.

GetColumnSchemaAsync(CancellationToken)

Bu, öğesinin zaman uyumsuz sürümüdür GetColumnSchema(DbDataReader) .This is the asynchronous version of GetColumnSchema(DbDataReader). Sağlayıcılar uygun bir uygulamayla geçersiz kılmalıdır.Providers should override with an appropriate implementation. cancellationTokenİsteğe bağlı olarak bu kabul edilebilir.The cancellationToken can optionally be honored. Varsayılan uygulama, zaman uyumlu GetColumnSchema(DbDataReader) aramayı çağırır ve tamamlanan bir görev döndürür.The default implementation invokes the synchronous GetColumnSchema(DbDataReader) call and returns a completed task. Zaten iptal edildiyse, varsayılan uygulama iptal edilen bir görev döndürür cancellationToken .The default implementation will return a cancelled task if passed an already cancelled cancellationToken. Tarafından oluşturulan özel durumlar GetColumnSchema(DbDataReader) , döndürülen görev özel durumu özelliği aracılığıyla iletilecektir.Exceptions thrown by GetColumnSchema(DbDataReader) will be communicated via the returned Task Exception property.

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

İstenen sütun için iç içe geçmiş bir veri okuyucusu döndürür.Returns a nested data reader for the requested column.

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

Belirtilen sütunun veri türünü temsil eden bir dize alır.Gets a string representing the data type of the specified column.

GetDateTime(Int32)

Belirtilen sütunun değerini bir nesne olarak alır DateTime .Gets the value of the specified column as a DateTime object.

GetDbDataReader(Int32)

DbDataReaderSağlayıcıya özgü bir uygulamayla geçersiz kılınabilen istenen sütun sırası için bir nesne döndürür.Returns a DbDataReader object for the requested column ordinal that can be overridden with a provider-specific implementation.

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

Belirtilen sütunun değerini olarak alır Decimal .Gets the value of the specified column as a Decimal.

GetDouble(Int32)

Sütunun değerini çift duyarlıklı kayan noktalı sayı olarak alır.Gets the value of the column as a double-precision floating point number.

GetEnumerator()

Öğe koleksiyonunu yinelemek için kullanılabilecek bir Numaralandırıcı döndürür.Returns an enumerator that can be used to iterate through the item collection.

GetFieldType(Int32)

TypeNesnenin veri türü olan öğesini alır.Gets the Type that is the data type of the object.

GetFieldValue<T>(Int32)

Belirtilen sütunun değerini istenen tür olarak alır.Gets the value of the specified column as the requested type.

(Devralındığı yer: DbDataReader)
GetFieldValueAsync<T>(Int32)

Belirtilen sütunun değerini, istenen tür olarak zaman uyumsuz olarak alır.Asynchronously gets the value of the specified column as the requested type.

(Devralındığı yer: DbDataReader)
GetFieldValueAsync<T>(Int32, CancellationToken)

Belirtilen sütunun değerini, istenen tür olarak zaman uyumsuz olarak alır.Asynchronously gets the value of the specified column as the requested type.

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

Belirtilen sütunun değerini tek duyarlıklı kayan noktalı sayı olarak alır.Gets the value of the specified column as a single-precision floating point number.

GetGuid(Int32)

Belirtilen sütunun değerini genel olarak benzersiz bir tanımlayıcı (GUID) olarak alır.Gets the value of the specified column as a globally-unique identifier (GUID).

GetHashCode()

Varsayılan karma işlevi olarak işlev görür.Serves as the default hash function.

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

Belirtilen sütunun değerini, 16 bit işaretli bir tamsayı olarak alır.Gets the value of the specified column as a 16-bit signed integer.

GetInt32(Int32)

Belirtilen sütunun değerini 32 bitlik işaretli bir tamsayı olarak alır.Gets the value of the specified column as a 32-bit signed integer.

GetInt64(Int32)

Belirtilen sütunun değerini 64 bitlik işaretli bir tamsayı olarak alır.Gets the value of the specified column as a 64-bit signed integer.

GetLifetimeService()

Bu örnek için ömür ilkesini denetleyen geçerli ömür hizmeti nesnesini alır.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Devralındığı yer: MarshalByRefObject)
GetName(Int32)

Belirtilen sütunun değerini olarak alır String .Gets the value of the specified column as a String.

GetOrdinal(String)

Sütunun adı verildiğinde sütun sıra sayısını alır.Gets the column ordinal, given the name of the column.

GetProviderSpecificFieldType(Int32)

Belirtilen sütunun türünü sağlayıcıya özgü biçimde alır.Gets the type of the specified column in provider-specific format.

GetProviderSpecificValue(Int32)

Sağlayıcıya özgü biçimde belirtilen sütunun değerini alır.Gets the value of the specified column in provider-specific format.

GetProviderSpecificValues(Object[])

Sağlanan diziyi, içindeki tüm sütunlar için sağlayıcıya özgü tür bilgileriyle doldurur DataTableReader .Fills the supplied array with provider-specific type information for all the columns in the DataTableReader.

GetSchemaTable()

DataTableÖğesinin sütun meta verilerini açıklayan bir döndürür DataTableReader .Returns a DataTable that describes the column metadata of the DataTableReader.

GetSchemaTableAsync(CancellationToken)

Bu, öğesinin zaman uyumsuz sürümüdür GetSchemaTable() .This is the asynchronous version of GetSchemaTable(). Sağlayıcılar uygun bir uygulamayla geçersiz kılmalıdır.Providers should override with an appropriate implementation. cancellationTokenİsteğe bağlı olarak bu kabul edilebilir.The cancellationToken can optionally be honored. Varsayılan uygulama, zaman uyumlu GetSchemaTable() aramayı çağırır ve tamamlanan bir görev döndürür.The default implementation invokes the synchronous GetSchemaTable() call and returns a completed task. Zaten iptal edildiyse, varsayılan uygulama iptal edilen bir görev döndürür cancellationToken .The default implementation will return a cancelled task if passed an already cancelled cancellationToken. Tarafından oluşturulan özel durumlar GetSchemaTable() , döndürülen görev özel durumu özelliği aracılığıyla iletilecektir.Exceptions thrown by GetSchemaTable() will be communicated via the returned Task Exception property.

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

Belirtilen sütundan verileri almak için bir akış alır.Gets a stream to retrieve data from the specified column.

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

Belirtilen sütunun değerini bir dize olarak alır.Gets the value of the specified column as a string.

GetTextReader(Int32)

Sütundan veri almak için bir metin okuyucu alır.Gets a text reader to retrieve data from the column.

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

TypeGeçerli örneği alır.Gets the Type of the current instance.

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

Belirtilen sütunun değerini yerel biçiminde alır.Gets the value of the specified column in its native format.

GetValues(Object[])

Nesne dizisini geçerli satırın sütun değerleriyle doldurur.Populates an array of objects with the column values of the current row.

InitializeLifetimeService()

Bu örnek için ömür ilkesini denetlemek üzere bir ömür hizmeti nesnesi alır.Obtains a lifetime service object to control the lifetime policy for this instance.

(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.Gets a value that indicates whether the column contains non-existent or missing values.

IsDBNullAsync(Int32)

Zaman uyumsuz olarak sütunun var olmayan veya eksik değerler içerip içermediğini gösteren bir değer alır.Asynchronously gets a value that indicates whether the column contains non-existent or missing values.

(Devralındığı yer: DbDataReader)
IsDBNullAsync(Int32, CancellationToken)

Zaman uyumsuz olarak sütunun var olmayan veya eksik değerler içerip içermediğini gösteren bir değer alır.Asynchronously gets a value that indicates whether the column contains non-existent or missing values.

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

Geçerli bir basit kopyasını oluşturur Object .Creates a shallow copy of the current Object.

(Devralındığı yer: Object)
MemberwiseClone(Boolean)

Geçerli nesnenin basit bir kopyasını oluşturur MarshalByRefObject .Creates a shallow copy of the current MarshalByRefObject object.

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

Varsa, DataTableReader sonraki sonuç kümesine ilerler.Advances the DataTableReader to the next result set, if any.

NextResultAsync()

Bir toplu iş deyimlerinin sonuçlarını okurken, okuyucuyu zaman uyumsuz bir sonraki sonuca ilerletir.Asynchronously advances the reader to the next result when reading the results of a batch of statements.

(Devralındığı yer: DbDataReader)
NextResultAsync(CancellationToken)

Bir toplu iş deyimlerinin sonuçlarını okurken, okuyucuyu zaman uyumsuz bir sonraki sonuca ilerletir.Asynchronously advances the reader to the next result when reading the results of a batch of statements.

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

DataTableReaderSonraki kayda ilerletir.Advances the DataTableReader to the next record.

ReadAsync()

Zaman uyumsuz olarak, bir sonuç kümesinde okuyucuyu bir sonraki kayda ilerletir.Asynchronously advances the reader to the next record in a result set.

(Devralındığı yer: DbDataReader)
ReadAsync(CancellationToken)

Zaman uyumsuz olarak, bir sonuç kümesinde okuyucuyu bir sonraki kayda ilerletir.Asynchronously advances the reader to the next record in a result set.

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

Geçerli nesneyi temsil eden dizeyi döndürür.Returns a string that represents the current object.

(Devralındığı yer: Object)

Belirtik Arabirim Kullanımları

IDataReader.Close()

Bu üyenin açıklaması için bkz Close() ..For a description of this member, see Close().

(Devralındığı yer: DbDataReader)
IDataReader.GetSchemaTable()

Bu üyenin açıklaması için bkz GetSchemaTable() ..For a description of this member, see GetSchemaTable().

(Devralındığı yer: DbDataReader)
IDataRecord.GetData(Int32)

Bu üyenin açıklaması için bkz GetData(Int32) ..For a description of this member, see GetData(Int32).

(Devralındığı yer: DbDataReader)

Uzantı Metotları

CanGetColumnSchema(DbDataReader)

Bir DbDataReader sütunun bir sütun şeması alıp yükleyemeyeceğini gösteren bir değer alır.Gets a value that indicates whether a DbDataReader can get a column schema.

GetColumnSchema(DbDataReader)

Bir için sütun şemasını ( DbColumn koleksiyon) alır DbDataReader .Gets the column schema (DbColumn collection) for a DbDataReader.

GetBoolean(DbDataReader, String)

Belirtilen sütunun değerini Boole olarak alır.Gets the value of the specified column as a Boolean.

GetByte(DbDataReader, String)

Belirtilen sütunun değerini bayt olarak alır.Gets the value of the specified column as a byte.

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

Belirtilen dizinden başlayarak belirtilen sütundan belirtilen sayıda baytı okur ve arabellekteki belirli bir konumdan başlayan bir arabelleğe yazar.Reads a specified number of bytes from the specified column starting at a specified index and writes them to a buffer starting at a specified position in the buffer.

GetChar(DbDataReader, String)

Belirtilen sütunun değerini tek bir karakter olarak alır.Gets the value of the specified column as a single character.

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

Belirtilen bir dizinden başlayarak belirtilen sütundan belirtilen sayıda karakteri okur ve belirli bir konumdan başlayarak bir arabelleğe yazar.Reads a specified number of characters from a specified column starting at a specified index, and writes them to a buffer starting at a specified position.

GetData(DbDataReader, String)

İstenen sütun için iç içe geçmiş bir veri okuyucusu döndürür.Returns a nested data reader for the requested column.

GetDataTypeName(DbDataReader, String)

Belirtilen sütunun veri türünün adını alır.Gets name of the data type of the specified column.

GetDateTime(DbDataReader, String)

Belirtilen sütunun değerini bir nesne olarak alır DateTime .Gets the value of the specified column as a DateTime object.

GetDecimal(DbDataReader, String)

Belirtilen sütunun değerini olarak alır Decimal .Gets the value of the specified column as a Decimal.

GetDouble(DbDataReader, String)

Belirtilen sütunun değerini çift duyarlıklı kayan noktalı sayı olarak alır.Gets the value of the specified column as a double-precision floating point number.

GetFieldType(DbDataReader, String)

Belirtilen sütunun veri türünü alır.Gets the data type of the specified column.

GetFieldValue<T>(DbDataReader, String)

Belirtilen sütunun değerini istenen tür olarak alır.Gets the value of the specified column as the requested type.

GetFieldValueAsync<T>(DbDataReader, String, CancellationToken)

Belirtilen sütunun değerini, istenen tür olarak zaman uyumsuz olarak alır.Asynchronously gets the value of the specified column as the requested type.

GetFloat(DbDataReader, String)

Belirtilen sütunun değerini tek duyarlıklı kayan noktalı sayı olarak alır.Gets the value of the specified column as a single-precision floating point number.

GetGuid(DbDataReader, String)

Belirtilen sütunun değerini bir genel benzersiz tanımlayıcı (GUID) olarak alır.Gets the value of the specified column as a globally unique identifier (GUID).

GetInt16(DbDataReader, String)

Belirtilen sütunun değerini, 16 bit işaretli bir tamsayı olarak alır.Gets the value of the specified column as a 16-bit signed integer.

GetInt32(DbDataReader, String)

Belirtilen sütunun değerini 32 bitlik işaretli bir tamsayı olarak alır.Gets the value of the specified column as a 32-bit signed integer.

GetInt64(DbDataReader, String)

Belirtilen sütunun değerini 64 bitlik işaretli bir tamsayı olarak alır.Gets the value of the specified column as a 64-bit signed integer.

GetProviderSpecificFieldType(DbDataReader, String)

Belirtilen sütunun sağlayıcıya özgü türünü alır.Gets the provider-specific type of the specified column.

GetProviderSpecificValue(DbDataReader, String)

Belirtilen sütunun değerini, sağlayıcıya özgü bir tür örneği olarak alır.Gets the value of the specified column as an instance of a provider-specific type.

GetStream(DbDataReader, String)

Belirtilen sütundan verileri almak için bir akış alır.Gets a stream to retrieve data from the specified column.

GetString(DbDataReader, String)

Belirtilen sütunun değerini bir örneği olarak alır String .Gets the value of the specified column as an instance of String.

GetTextReader(DbDataReader, String)

Sütundan veri almak için bir metin okuyucu alır.Gets a text reader to retrieve data from the column.

GetValue(DbDataReader, String)

Belirtilen sütunun değerini bir örneği olarak alır Object .Gets the value of the specified column as an instance of Object.

IsDBNull(DbDataReader, String)

Sütunda varolmayan veya eksik değerler içerip içermediğini gösteren bir değer alır.Gets a value that indicates whether the column contains nonexistent or missing values.

IsDBNullAsync(DbDataReader, String, CancellationToken)

Zaman uyumsuz olarak sütunun var olmayan veya eksik değerler içerip içermediğini gösteren bir değer alır.Asynchronously gets a value that indicates whether the column contains non-existent or missing values.

Cast<TResult>(IEnumerable)

Öğesinin öğelerini IEnumerable belirtilen türe yayınlar.Casts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable)

Öğesinin öğelerini IEnumerable belirtilen bir türe göre filtreler.Filters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable)

Bir sorgunun paralelleştirilmesini mümkün hale getirme.Enables parallelization of a query.

AsQueryable(IEnumerable)

Bir IEnumerable öğesine dönüştürür IQueryable .Converts an IEnumerable to an IQueryable.

ConfigureAwait(IAsyncDisposable, Boolean)

Zaman uyumsuz bir atılabilir döndürülen görevlerin ne kadar beklediğini yapılandırır.Configures how awaits on the tasks returned from an async disposable are performed.

Şunlara uygulanır