DataTableReader Clase

Definición

El DataTableReader obtiene el contenido de uno o varios objetos DataTable en forma de uno o varios conjuntos de resultados 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

Comentarios

El DataTableReader funciona de forma muy similar a cualquier otro lector de datos, como el SqlDataReader, excepto que el DataTableReader proporciona iteración en las 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 el DataTableReader está activo y el lector mantiene automáticamente su posición.

Al crear un DataTableReader a partir de un DataTable, el objeto de DataTableReader resultante contiene un conjunto de resultados con los mismos datos que el DataTable desde el que se creó, excepto para las filas que se han marcado como eliminadas. Las columnas aparecen en el mismo orden que en el DataTableoriginal. La estructura del resultado devuelto es idéntica en el esquema y los datos con el DataTableoriginal. Un DataTableReader que se creó llamando al método CreateDataReader de un objeto DataSet contiene varios conjuntos de resultados si el DataSet contiene más de una tabla. Los resultados se encuentran en la misma secuencia que los objetos DataTable del DataTableCollection del 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.

El DataTableReader proporciona un iterador estable; es decir, el contenido del DataTableReader no 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 Rows durante la iteración, la posición actual dentro del DataTableReader se mantiene correctamente y no invalida el iterador.

Constructores

DataTableReader(DataTable)

Inicializa una nueva instancia de la clase DataTableReader mediante el uso de datos del DataTableproporcionado.

DataTableReader(DataTable[])

Inicializa una nueva instancia de la clase DataTableReader mediante la matriz proporcionada de objetos DataTable.

Propiedades

Depth

Profundidad de anidamiento para la fila actual del DataTableReader.

FieldCount

Devuelve el número de columnas de la fila actual.

HasRows

Obtiene un valor que indica si el DataTableReader contiene una o varias filas.

IsClosed

Obtiene un valor que indica si el 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 la DbDataReader que no están ocultos.

(Heredado de DbDataReader)

Métodos

Close()

Cierra el DataTableReaderactual.

CloseAsync()

Cierra de forma asincrónica el objeto DbDataReader.

(Heredado de DbDataReader)
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 clase DbDataReader.

(Heredado de DbDataReader)
Dispose(Boolean)

Libera los recursos no administrados usados por el DbDataReader y, opcionalmente, libera los recursos administrados.

(Heredado de DbDataReader)
DisposeAsync()

Libera de forma asincrónica todos los recursos utilizados por la instancia actual de la clase DbDataReader.

(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 un 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.

GetColumnSchemaAsync(CancellationToken)

Esta es la versión asincrónica de GetColumnSchema(DbDataReader). Los proveedores deben invalidar con una implementación adecuada. Opcionalmente, se puede respetar el cancellationToken. La implementación predeterminada invoca la llamada GetColumnSchema(DbDataReader) sincrónica y devuelve una tarea completada. La implementación predeterminada devolverá una tarea cancelada si se pasa una cancellationTokenya cancelada. Las excepciones producidas por GetColumnSchema(DbDataReader) se comunicarán a través de la propiedad Task Exception devuelta.

(Heredado de DbDataReader)
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 objeto DateTime.

GetDbDataReader(Int32)

Devuelve un objeto DbDataReader 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 un 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 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 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()
Obsoletos.

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 un 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 la DataTableReader.

GetSchemaTable()

Devuelve un DataTable que describe los metadatos de columna del DataTableReader.

GetSchemaTableAsync(CancellationToken)

Esta es la versión asincrónica de GetSchemaTable(). Los proveedores deben invalidar con una implementación adecuada. Opcionalmente, se puede respetar el cancellationToken. La implementación predeterminada invoca la llamada GetSchemaTable() sincrónica y devuelve una tarea completada. La implementación predeterminada devolverá una tarea cancelada si se pasa una cancellationTokenya cancelada. Las excepciones producidas por GetSchemaTable() se comunicarán a través de la propiedad Task Exception devuelta.

(Heredado de DbDataReader)
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()
Obsoletos.

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 MarshalByRefObject actual.

(Heredado de MarshalByRefObject)
NextResult()

Desplaza el DataTableReader al 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 el DataTableReader al 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

IDataRecord.GetData(Int32)

Para obtener una descripción de este miembro, consulte GetData(Int32).

(Heredado de DbDataReader)

Métodos de extensión

CanGetColumnSchema(DbDataReader)

Obtiene un valor que indica si un DbDataReader puede obtener un esquema de columna.

GetColumnSchema(DbDataReader)

Obtiene el esquema de columna ( colecciónDbColumn) de un DbDataReader.

GetBoolean(DbDataReader, String)

Obtiene el valor de la columna especificada como booleano.

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 anidado 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 un Decimal.

GetDouble(DbDataReader, String)

Obtiene el valor de la columna especificada como un número de punto flotante de precisión doble.

GetFieldType(DbDataReader, String)

Obtiene el tipo de datos de la columna especificada.

GetFieldValue<T>(DbDataReader, String)

Obtiene el valor de la columna especificada como tipo solicitado.

GetFieldValueAsync<T>(DbDataReader, String, CancellationToken)

Obtiene de forma asincrónica el valor de la columna especificada como 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 un 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 de 32 bits con signo.

GetInt64(DbDataReader, String)

Obtiene el valor de la columna especificada como un entero de 64 bits con signo.

GetProviderSpecificFieldType(DbDataReader, String)

Obtiene el tipo específico del proveedor de la columna especificada.

GetProviderSpecificValue(DbDataReader, String)

Obtiene el valor de la columna especificada como una instancia de un tipo específico del proveedor.

GetStream(DbDataReader, String)

Obtiene una secuencia 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 inexistentes o que faltan.

IsDBNullAsync(DbDataReader, String, CancellationToken)

Obtiene de forma asincrónica un valor que indica si la columna contiene valores inexistentes o que faltan.

Cast<TResult>(IEnumerable)

Convierte los elementos de un IEnumerable al tipo especificado.

OfType<TResult>(IEnumerable)

Filtra los elementos de un IEnumerable en función de un tipo especificado.

AsParallel(IEnumerable)

Habilita la paralelización de una consulta.

AsQueryable(IEnumerable)

Convierte un IEnumerable en un IQueryable.

ConfigureAwait(IAsyncDisposable, Boolean)

Configura cómo se realizarán las esperas en las tareas devueltas desde un descartable asincrónico.

Se aplica a