DataTableReader Clase

Definición

Espacio de nombres:

System.Data

Ensamblado:

System.Data.dll

El DataTableReader obtiene el contenido de uno o más objetos DataTable con formato de uno o más conjuntos de solo lectura y de solo avance.

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

Herencia

Object

MarshalByRefObject

DbDataReader

DataTableReader

Comentarios

Funciona DataTableReader de forma muy similar a cualquier otro lector de datos, como SqlDataReader, excepto que proporciona DataTableReader para iterar sobre filas de un DataTable. En otras palabras, proporciona iteración sobre filas en una memoria caché. Los datos almacenados en caché se pueden modificar mientras está DataTableReader activo y el lector mantiene automáticamente su posición.

Cuando se crea a DataTableReader partir de , DataTableel objeto resultante DataTableReader contiene un conjunto de resultados con los mismos datos que el desde el DataTable que se creó, excepto para las filas marcadas como eliminadas. Las columnas aparecen en el mismo orden que en el original DataTable. La estructura del resultado devuelto es idéntica en el esquema y los datos con el original DataTable. Que DataTableReader se creó llamando al CreateDataReader método de un DataSet objeto contiene varios conjuntos de resultados si DataSet contiene más de una tabla. Los resultados se encuentran en la misma secuencia que los DataTable objetos del DataTableCollectionDataSet objeto .

El conjunto de resultados devuelto contiene solo la versión actual de cada DataRow; se omiten las filas marcadas para su eliminación.

DataTableReader proporciona un iterador estable; es decir, el contenido de no DataTableReader se invalida si el tamaño de la colección subyacente se modifica durante la iteración. Por ejemplo, si se eliminan o quitan una o varias filas de la Rows colección durante la iteración, la posición actual dentro DataTableReader de se mantiene correctamente y no invalida el iterador.

Constructores

Nombre	Description
DataTableReader(DataTable)	Inicializa una nueva instancia de la DataTableReader clase mediante el uso de datos del proporcionado DataTable.
DataTableReader(DataTable[])	Inicializa una nueva instancia de la DataTableReader clase utilizando la matriz de DataTable objetos proporcionada.

Propiedades

Nombre	Description
Depth	Profundidad de anidamiento para la fila actual de DataTableReader.
FieldCount	Devuelve el número de columnas de la fila actual.
HasRows	Obtiene un valor que indica si contiene DataTableReader una o varias filas.
IsClosed	Obtiene un valor que indica si DataTableReader está cerrado.
Item[Int32]	Obtiene el valor de la columna especificada en su formato nativo según el ordinal de columna.
Item[String]	Obtiene el valor de la columna especificada en su formato nativo según el nombre de columna.
RecordsAffected	Obtiene el número de filas insertadas, modificadas o eliminadas por la ejecución de la instrucción SQL.
VisibleFieldCount	Obtiene el número de campos de que DbDataReader no están ocultos. (Heredado de DbDataReader)

Métodos

Nombre	Description
Close()	Cierra el objeto actual DataTableReader.
CreateObjRef(Type)	Crea un objeto que contiene toda la información pertinente necesaria para generar un proxy usado para comunicarse con un objeto remoto. (Heredado de MarshalByRefObject)
Dispose()	Libera todos los recursos usados por la instancia actual de la DbDataReader clase . (Heredado de DbDataReader)
Dispose(Boolean)	Libera los recursos no administrados utilizados por DbDataReader y, opcionalmente, libera los recursos administrados. (Heredado de DbDataReader)
Equals(Object)	Determina si el objeto especificado es igual al objeto actual. (Heredado de Object)
GetBoolean(Int32)	Obtiene el valor de la columna especificada como .Boolean
GetByte(Int32)	Obtiene el valor de la columna especificada como un byte.
GetBytes(Int32, Int64, Byte[], Int32, Int32)	Lee un flujo de bytes a partir del desplazamiento de columna especificado en el búfer como una matriz que comienza en el desplazamiento del búfer especificado.
GetChar(Int32)	Obtiene el valor de la columna especificada como carácter.
GetChars(Int32, Int64, Char[], Int32, Int32)	Devuelve el valor de la columna especificada como una matriz de caracteres.
GetData(Int32)	Devuelve un lector de datos anidado para la columna solicitada. (Heredado de DbDataReader)
GetDataTypeName(Int32)	Obtiene una cadena que representa el tipo de datos de la columna especificada.
GetDateTime(Int32)	Obtiene el valor de la columna especificada como un DateTime objeto .
GetDbDataReader(Int32)	Devuelve un DbDataReader objeto para el ordinal de columna solicitado que se puede invalidar con una implementación específica del proveedor. (Heredado de DbDataReader)
GetDecimal(Int32)	Obtiene el valor de la columna especificada como .Decimal
GetDouble(Int32)	Obtiene el valor de la columna como un número de punto flotante de precisión doble.
GetEnumerator()	Devuelve un enumerador que se puede usar para recorrer en iteración la colección de elementos.
GetFieldType(Int32)	Obtiene el Type objeto que es el tipo de datos del objeto .
GetFieldValue<T>(Int32)	Obtiene el valor de la columna especificada como tipo solicitado. (Heredado de DbDataReader)
GetFieldValueAsync<T>(Int32, CancellationToken)	Obtiene de forma asincrónica el valor de la columna especificada como tipo solicitado. (Heredado de DbDataReader)
GetFieldValueAsync<T>(Int32)	Obtiene de forma asincrónica el valor de la columna especificada como tipo solicitado. (Heredado de DbDataReader)
GetFloat(Int32)	Obtiene el valor de la columna especificada como un número de punto flotante de precisión sencilla.
GetGuid(Int32)	Obtiene el valor de la columna especificada como un identificador único global (GUID).
GetHashCode()	Actúa como la función hash predeterminada. (Heredado de Object)
GetInt16(Int32)	Obtiene el valor de la columna especificada como un entero de 16 bits con signo.
GetInt32(Int32)	Obtiene el valor de la columna especificada como un entero de 32 bits con signo.
GetInt64(Int32)	Obtiene el valor de la columna especificada como un entero de 64 bits con signo.
GetLifetimeService()	Recupera el objeto de servicio de duración actual que controla la directiva de duración de esta instancia. (Heredado de MarshalByRefObject)
GetName(Int32)	Obtiene el valor de la columna especificada como .String
GetOrdinal(String)	Obtiene el ordinal de columna, dado el nombre de la columna.
GetProviderSpecificFieldType(Int32)	Obtiene el tipo de la columna especificada en formato específico del proveedor.
GetProviderSpecificValue(Int32)	Obtiene el valor de la columna especificada en formato específico del proveedor.
GetProviderSpecificValues(Object[])	Rellena la matriz proporcionada con información de tipo específica del proveedor para todas las columnas de DataTableReader.
GetSchemaTable()	Devuelve un DataTable objeto que describe los metadatos de columna de .DataTableReader
GetStream(Int32)	Obtiene una secuencia para recuperar datos de la columna especificada. (Heredado de DbDataReader)
GetString(Int32)	Obtiene el valor de la columna especificada como una cadena.
GetTextReader(Int32)	Obtiene un lector de texto para recuperar datos de la columna. (Heredado de DbDataReader)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
GetValue(Int32)	Obtiene el valor de la columna especificada en su formato nativo.
GetValues(Object[])	Rellena una matriz de objetos con los valores de columna de la fila actual.
InitializeLifetimeService()	Obtiene un objeto de servicio de duración para controlar la directiva de duración de esta instancia. (Heredado de MarshalByRefObject)
IsDBNull(Int32)	Obtiene un valor que indica si la columna contiene valores inexistentes o que faltan.
IsDBNullAsync(Int32, CancellationToken)	Obtiene de forma asincrónica un valor que indica si la columna contiene valores inexistentes o que faltan. (Heredado de DbDataReader)
IsDBNullAsync(Int32)	Obtiene de forma asincrónica un valor que indica si la columna contiene valores inexistentes o que faltan. (Heredado de DbDataReader)
MemberwiseClone()	Crea una copia superficial del Objectactual. (Heredado de Object)
MemberwiseClone(Boolean)	Crea una copia superficial del objeto actual MarshalByRefObject . (Heredado de MarshalByRefObject)
NextResult()	Avanza al DataTableReader siguiente conjunto de resultados, si existe.
NextResultAsync()	Avanza de forma asincrónica el lector al siguiente resultado al leer los resultados de un lote de instrucciones. (Heredado de DbDataReader)
NextResultAsync(CancellationToken)	Avanza de forma asincrónica el lector al siguiente resultado al leer los resultados de un lote de instrucciones. (Heredado de DbDataReader)
Read()	Avanza hasta DataTableReader el siguiente registro.
ReadAsync()	Avanza de forma asincrónica el lector al siguiente registro de un conjunto de resultados. (Heredado de DbDataReader)
ReadAsync(CancellationToken)	Avanza de forma asincrónica el lector al siguiente registro de un conjunto de resultados. (Heredado de DbDataReader)
ToString()	Devuelve una cadena que representa el objeto actual. (Heredado de Object)

Implementaciones de interfaz explícitas

Nombre	Description
IDataRecord.GetData(Int32)	Para obtener una descripción de este miembro, vea GetData(Int32). (Heredado de DbDataReader)

Métodos de extensión

Nombre	Description
AsParallel(IEnumerable)	Habilita la paralelización de una consulta.
AsQueryable(IEnumerable)	Convierte un IEnumerable en un IQueryable.
CanGetColumnSchema(DbDataReader)	Obtiene un valor que indica si un DbDataReader objeto puede obtener un esquema de columna.
Cast<TResult>(IEnumerable)	Convierte los elementos de un IEnumerable al tipo especificado.
GetColumnSchema(DbDataReader)	Obtiene el esquema de columna (DbColumn colección) de un DbDataReaderobjeto .
OfType<TResult>(IEnumerable)	Filtra los elementos de un IEnumerable en función de un tipo especificado.