DataTableReader Clase

Definición

Espacio de nombres:

System.Data

Ensamblado:

System.Data.Common.dll

Ensamblado:

System.Data.dll

Ensamblado:

netstandard.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

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

Cuando se crea un DataTableReader objeto a 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. Objeto DataTableReader que 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 DataTableCollection objeto .DataSet

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 colección durante la Rows iteración, la posición actual dentro DataTableReader de se mantiene correctamente y no invalida el iterador.

Constructores

DataTableReader(DataTable)	Inicializa una nueva instancia de la clase DataTableReader utilizando los datos del objeto DataTable proporcionado.
DataTableReader(DataTable[])	Inicializa una nueva instancia de la clase DataTableReader utilizando la matriz proporcionada de objetos DataTable.

Propiedades

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

Métodos

Close()	Cierra el objeto DataTableReader actual.
CloseAsync()	Cierra de forma asincrónica el objeto DbDataReader. (Heredado de DbDataReader)
CreateObjRef(Type)	Crea un objeto que contiene toda la información relevante necesaria para generar un proxy utilizado para comunicarse con un objeto remoto. (Heredado de MarshalByRefObject)
Dispose()	Libera todos los recursos usados por la instancia actual de la clase DbDataReader. (Heredado de DbDataReader)
Dispose(Boolean)	Libera los recursos no administrados que usa DbDataReader y, de forma opcional, libera los recursos administrados. (Heredado de DbDataReader)
DisposeAsync()	Libera de forma asincrónica todos los recursos que usa la instancia actual de la clase DbDataReader. (Heredado de DbDataReader)
Equals(Object)	Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object)
GetBoolean(Int32)	Obtiene el valor de la columna especificada como objeto Boolean.
GetByte(Int32)	Obtiene el valor de la columna especificada como un byte.
GetBytes(Int32, Int64, Byte[], Int32, Int32)	Lee una secuencia de bytes que comienza en la posición de desplazamiento de la columna especificada cargándola al búfer como una matriz, comenzando a cargar desde la posición de desplazamiento de búfer especificada.
GetChar(Int32)	Obtiene el valor de la columna especificada como un carácter.
GetChars(Int32, Int64, Char[], Int32, Int32)	Devuelve el valor de la columna especificada como una matriz de caracteres.
GetColumnSchemaAsync(CancellationToken)	Esta es la versión asincrónica de GetColumnSchema(DbDataReader). Los proveedores lo deben reemplazar con una implementación apropiada. Opcionalmente, se puede respetar cancellationToken. La implementación predeterminada invoca la llamada sincrónica a GetColumnSchema(DbDataReader) y devuelve una tarea completada. La implementación predeterminada devolverá una tarea cancelada si se pasa un cancellationToken ya cancelado. Las excepciones producidas por GetColumnSchema(DbDataReader) se comunicarán mediante la propiedad Task Exception devuelta. (Heredado de DbDataReader)
GetData(Int32)	Devuelve un lector de datos anidados 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 objeto DateTime.
GetDbDataReader(Int32)	Devuelve un objeto DbDataReader para el índice de columna solicitado que puede ser invalidado con una implementación específica del proveedor. (Heredado de DbDataReader)
GetDecimal(Int32)	Obtiene el valor de la columna especificada como objeto 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 puede utilizarse para recorrer una iteración en la colección de elementos.
GetFieldType(Int32)	Obtiene el objeto Type que es el tipo de datos del objeto.
GetFieldValue<T>(Int32)	Obtiene el valor de la columna especificada con el tipo solicitado. (Heredado de DbDataReader)
GetFieldValueAsync<T>(Int32)	Obtiene de manera asincrónica el valor de la columna especificada con el tipo solicitado. (Heredado de DbDataReader)
GetFieldValueAsync<T>(Int32, CancellationToken)	Obtiene de manera asincrónica el valor de la columna especificada con el 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 global único (GUID).
GetHashCode()	Sirve 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 con signo de 32 bits.
GetInt64(Int32)	Obtiene el valor de la columna especificada como un entero de 64 bits con signo.
GetLifetimeService()	Obsoleto. 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 objeto String.
GetOrdinal(String)	Obtiene el índice de columna a partir del nombre de la columna determinado.
GetProviderSpecificFieldType(Int32)	Obtiene el tipo de la columna especificada en el formato específico del proveedor.
GetProviderSpecificValue(Int32)	Obtiene el valor de la columna especificada en el formato específico del proveedor.
GetProviderSpecificValues(Object[])	Rellena la matriz proporcionada de información de tipo específico del proveedor para todas las columnas del objeto DataTableReader.
GetSchemaTable()	Devuelve un objeto DataTable que describe los metadatos de columna del DataTableReader.
GetSchemaTableAsync(CancellationToken)	Esta es la versión asincrónica de GetSchemaTable(). Los proveedores lo deben reemplazar con una implementación apropiada. Opcionalmente, se puede respetar cancellationToken. La implementación predeterminada invoca la llamada sincrónica a GetSchemaTable() y devuelve una tarea completada. La implementación predeterminada devolverá una tarea cancelada si se pasa un cancellationToken ya cancelado. Las excepciones producidas por GetSchemaTable() se comunicarán mediante la propiedad Task Exception devuelta. (Heredado de DbDataReader)
GetStream(Int32)	Obtiene un flujo 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()	Obsoleto. 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 no existentes o que faltan.
IsDBNullAsync(Int32)	Obtiene de manera asincrónica un valor que indica si la columna contiene valores no existentes o que faltan. (Heredado de DbDataReader)
IsDBNullAsync(Int32, CancellationToken)	Obtiene de manera asincrónica un valor que indica si la columna contiene valores no existentes o que faltan. (Heredado de DbDataReader)
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
MemberwiseClone(Boolean)	Crea una copia superficial del objeto MarshalByRefObject actual. (Heredado de MarshalByRefObject)
NextResult()	Avanza el objeto DataTableReader al conjunto de resultados siguiente, si hay alguno.
NextResultAsync()	Hace avanzar de manera asincrónica el lector hasta el resultado siguiente cuando se leen los resultados de un lote de instrucciones. (Heredado de DbDataReader)
NextResultAsync(CancellationToken)	Hace avanzar de manera asincrónica el lector hasta el resultado siguiente cuando se leen los resultados de un lote de instrucciones. (Heredado de DbDataReader)
Read()	Desplaza DataTableReader al siguiente registro.
ReadAsync()	Hace avanzar de manera asincrónica el lector hasta el siguiente registro de un conjunto de resultados. (Heredado de DbDataReader)
ReadAsync(CancellationToken)	Hace avanzar de manera asincrónica el lector hasta el 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

IDataRecord.GetData(Int32)

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

Métodos de extensión

CanGetColumnSchema(DbDataReader)	Obtiene un valor que indica si DbDataReader puede obtener un esquema de columna.
GetColumnSchema(DbDataReader)	Obtiene el esquema de columna (colección DbColumn) para DbDataReader.
GetBoolean(DbDataReader, String)	Obtiene el valor de la columna especificada como tipo Boolean.
GetByte(DbDataReader, String)	Obtiene el valor de la columna especificada como un byte.
GetBytes(DbDataReader, String, Int64, Byte[], Int32, Int32)	Lee un número especificado de bytes de la columna especificada a partir de un índice especificado, y los escribe en un búfer a partir de una posición especificada en el búfer.
GetChar(DbDataReader, String)	Obtiene el valor de la columna especificada como un solo carácter.
GetChars(DbDataReader, String, Int64, Char[], Int32, Int32)	Lee un número especificado de caracteres de una columna especificada a partir de un índice especificado, y los escribe en un búfer a partir de una posición especificada.
GetData(DbDataReader, String)	Devuelve un lector de datos anidados para la columna solicitada.
GetDataTypeName(DbDataReader, String)	Obtiene el nombre del tipo de datos de la columna especificada.
GetDateTime(DbDataReader, String)	Obtiene el valor de la columna especificada como un objeto DateTime.
GetDecimal(DbDataReader, String)	Obtiene el valor de la columna especificada como objeto Decimal.
GetDouble(DbDataReader, String)	Obtiene el valor de la columna especificada como un número de punto flotante de doble precisión.
GetFieldType(DbDataReader, String)	Obtiene el tipo de datos de la columna especificada.
GetFieldValue<T>(DbDataReader, String)	Obtiene el valor de la columna especificada con el tipo solicitado.
GetFieldValueAsync<T>(DbDataReader, String, CancellationToken)	Obtiene de manera asincrónica el valor de la columna especificada con el tipo solicitado.
GetFloat(DbDataReader, String)	Obtiene el valor de la columna especificada como un número de punto flotante de precisión sencilla.
GetGuid(DbDataReader, String)	Obtiene el valor de la columna especificada como identificador único global (GUID).
GetInt16(DbDataReader, String)	Obtiene el valor de la columna especificada como un entero de 16 bits con signo.
GetInt32(DbDataReader, String)	Obtiene el valor de la columna especificada como un entero con signo de 32 bits.
GetInt64(DbDataReader, String)	Obtiene el valor de la columna especificada como un entero de 64 bits con signo.
GetProviderSpecificFieldType(DbDataReader, String)	Devuelve el tipo específico del proveedor de la columna especificada.
GetProviderSpecificValue(DbDataReader, String)	Obtiene el valor de la columna especificada como instancia de un tipo específico del proveedor.
GetStream(DbDataReader, String)	Obtiene un flujo para recuperar datos de la columna especificada.
GetString(DbDataReader, String)	Obtiene el valor de la columna especificada como una instancia de String.
GetTextReader(DbDataReader, String)	Obtiene un lector de texto para recuperar datos de la columna.
GetValue(DbDataReader, String)	Obtiene el valor de la columna especificada como una instancia de Object.
IsDBNull(DbDataReader, String)	Obtiene un valor que indica si la columna contiene valores que no existen o ausentes.
IsDBNullAsync(DbDataReader, String, CancellationToken)	Obtiene de manera asincrónica un valor que indica si la columna contiene valores no existentes o que faltan.
Cast<TResult>(IEnumerable)	Convierte los elementos de IEnumerable en el tipo especificado.
OfType<TResult>(IEnumerable)	Filtra los elementos de IEnumerable en función de un tipo especificado.
AsParallel(IEnumerable)	Habilita la paralelización de una consulta.
AsQueryable(IEnumerable)	Convierte una interfaz IEnumerable en IQueryable.
ConfigureAwait(IAsyncDisposable, Boolean)	Configura la forma en la que se realizan las expresiones await en las tareas devueltas desde un elemento asincrónico descartable.