DataTableReader Clase

Definición

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

Comentarios

Funciona de manera muy similar a cualquier otro lector de datos, SqlDataReadercomo, con la DataTableReader excepción de que proporciona iteración en las filas de. DataTable DataTableReaderThe DataTableReader works much like any other data reader, such as the SqlDataReader, except that the DataTableReader provides for iterating over rows in a DataTable. En otras palabras, proporciona la iteración en las filas de una memoria caché.In other words, it provides for iterating over rows in a cache. Los datos almacenados en caché se pueden modificar mientras DataTableReader está activo y el lector mantiene su posición automáticamente.The cached data can be modified while the DataTableReader is active, and the reader automatically maintains its position.

Cuando se crea un DataTableReader a partir DataTablede un, DataTableReader el objeto resultante contiene un conjunto de resultados con los mismos DataTable datos que el desde el que se creó, excepto para las filas que se hayan marcado como eliminadas.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. Las columnas aparecen en el mismo orden que en el original DataTable.The columns appear in the same order as in the original DataTable. La estructura del resultado devuelto es idéntica en el esquema y los datos al DataTableoriginal.The structure of the returned result is identical in schema and data to the original DataTable. Que se creó mediante una llamada al CreateDataReader método de un DataSet objeto que contiene varios conjuntos de resultados DataSet si contiene más de una tabla. DataTableReaderA 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. Los resultados se encuentran en la misma secuencia que DataTable los objetos DataTableCollection del del DataSet objeto.The results are in the same sequence as the DataTable objects in the DataTableCollection of the DataSet object.

El conjunto de resultados devuelto solo contiene la versión actual DataRowde cada; se omiten las filas marcadas para su eliminación.The returned result set contains only the current version of each DataRow; rows that are marked for deletion are skipped.

Proporciona un iterador estable; es decir, el contenido DataTableReader de no se invalida si se modifica el tamaño de la colección subyacente durante la iteración. DataTableReaderThe 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. Por ejemplo, si se eliminan o quitan Rows una o más filas de la colección durante la iteración, la DataTableReader posición actual dentro del se mantiene de forma adecuada y no invalida el iterador.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.

Constructores

DataTableReader(DataTable)

Inicializa una nueva instancia de la clase DataTableReader utilizando los datos del objeto DataTable proporcionado.Initializes a new instance of the DataTableReader class by using data from the supplied DataTable.

DataTableReader(DataTable[])

Inicializa una nueva instancia de la clase DataTableReader utilizando la matriz proporcionada de objetos DataTable.Initializes a new instance of the DataTableReader class using the supplied array of DataTable objects.

Propiedades

Depth

Profundidad del anidamiento para la fila actual del objeto DataTableReader.The depth of nesting for the current row of the DataTableReader.

FieldCount

Devuelve el número de columnas de la fila actual.Returns the number of columns in the current row.

HasRows

Obtiene un valor que indica si DataTableReader contiene una o varias filas.Gets a value that indicates whether the DataTableReader contains one or more rows.

IsClosed

Obtiene un valor que indica si el objeto DataTableReader está cerrado.Gets a value that indicates whether the DataTableReader is closed.

Item[Int32]

Obtiene el valor de la columna especificada en su formato nativo si se da el índice de columna.Gets the value of the specified column in its native format given the column ordinal.

Item[String]

Obtiene el valor de la columna especificada en su formato nativo si se da el nombre de la columna.Gets the value of the specified column in its native format given the column name.

RecordsAffected

Obtiene el número de filas insertadas, modificadas o eliminadas al ejecutar la instrucción SQL.Gets the number of rows inserted, changed, or deleted by execution of the SQL statement.

VisibleFieldCount

Obtiene el número de campos de DbDataReader que no están ocultos.Gets the number of fields in the DbDataReader that are not hidden.

(Heredado de DbDataReader)

Métodos

Close()

Cierra el objeto DataTableReader actual.Closes the current DataTableReader.

CloseAsync()

Cierra de forma asincrónica el objeto DbDataReader.Asynchronously closes the DbDataReader object.

(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.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Heredado de MarshalByRefObject)
Dispose()

Libera todos los recursos usados por la instancia actual de la clase DbDataReader.Releases all resources used by the current instance of the DbDataReader class.

(Heredado de DbDataReader)
Dispose(Boolean)

Libera los recursos no administrados que usa DbDataReader y, de forma opcional, libera los recursos administrados.Releases the unmanaged resources used by the DbDataReader and optionally releases the managed resources.

(Heredado de DbDataReader)
DisposeAsync()

Libera de forma asincrónica todos los recursos que usa la instancia actual de la clase DbDataReader.Asynchronously releases all resources used by the current instance of the DbDataReader class.

(Heredado de DbDataReader)
Equals(Object)

Determina si el objeto especificado es igual al objeto actual.Determines whether the specified object is equal to the current object.

(Heredado de Object)
GetBoolean(Int32)

Obtiene el valor de la columna especificada como objeto Boolean.Gets the value of the specified column as a Boolean.

GetByte(Int32)

Obtiene el valor de la columna especificada como un byte.Gets the value of the specified column as a 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.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)

Obtiene el valor de la columna especificada como un carácter.Gets the value of the specified column as a character.

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

Devuelve el valor de la columna especificada como una matriz de caracteres.Returns the value of the specified column as a character array.

GetData(Int32)

Devuelve un lector de datos anidados para la columna solicitada.Returns a nested data reader for the requested column.

(Heredado de DbDataReader)
GetDataTypeName(Int32)

Obtiene una cadena que representa el tipo de datos de la columna especificada.Gets a string representing the data type of the specified column.

GetDateTime(Int32)

Obtiene el valor de la columna especificada como un objeto DateTime.Gets the value of the specified column as a DateTime object.

GetDbDataReader(Int32)

Devuelve un objeto DbDataReader para el índice de columna solicitado que puede ser invalidado con una implementación específica del proveedor.Returns a DbDataReader object for the requested column ordinal that can be overridden with a provider-specific implementation.

(Heredado de DbDataReader)
GetDecimal(Int32)

Obtiene el valor de la columna especificada como objeto Decimal.Gets the value of the specified column as a Decimal.

GetDouble(Int32)

Obtiene el valor de la columna como un número de punto flotante de precisión doble.Gets the value of the column as a double-precision floating point number.

GetEnumerator()

Devuelve un enumerador que puede utilizarse para recorrer una iteración en la colección de elementos.Returns an enumerator that can be used to iterate through the item collection.

GetFieldType(Int32)

Obtiene el objeto Type que es el tipo de datos del objeto.Gets the Type that is the data type of the object.

GetFieldValue<T>(Int32)

Obtiene el valor de la columna especificada con el tipo solicitado.Gets the value of the specified column as the requested type.

(Heredado de DbDataReader)
GetFieldValueAsync<T>(Int32)

Obtiene de manera asincrónica el valor de la columna especificada con el tipo solicitado.Asynchronously gets the value of the specified column as the requested type.

(Heredado de DbDataReader)
GetFieldValueAsync<T>(Int32, CancellationToken)

Obtiene de manera asincrónica el valor de la columna especificada con el tipo solicitado.Asynchronously gets the value of the specified column as the requested type.

(Heredado de DbDataReader)
GetFloat(Int32)

Obtiene el valor de la columna especificada como un número de punto flotante de precisión sencilla.Gets the value of the specified column as a single-precision floating point number.

GetGuid(Int32)

Obtiene el valor de la columna especificada como un identificador global único (GUID).Gets the value of the specified column as a globally-unique identifier (GUID).

GetHashCode()

Sirve como función hash predeterminada.Serves as the default hash function.

(Heredado de Object)
GetInt16(Int32)

Obtiene el valor de la columna especificada como un entero de 16 bits con signo.Gets the value of the specified column as a 16-bit signed integer.

GetInt32(Int32)

Obtiene el valor de la columna especificada como un entero con signo de 32 bits.Gets the value of the specified column as a 32-bit signed integer.

GetInt64(Int32)

Obtiene el valor de la columna especificada como un entero de 64 bits con signo.Gets the value of the specified column as a 64-bit signed integer.

GetLifetimeService()

Recupera el objeto de servicio de duración actual que controla la directiva de duración de esta instancia.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Heredado de MarshalByRefObject)
GetName(Int32)

Obtiene el valor de la columna especificada como objeto String.Gets the value of the specified column as a String.

GetOrdinal(String)

Obtiene el índice de columna a partir del nombre de la columna determinado.Gets the column ordinal, given the name of the column.

GetProviderSpecificFieldType(Int32)

Obtiene el tipo de la columna especificada en el formato específico del proveedor.Gets the type of the specified column in provider-specific format.

GetProviderSpecificValue(Int32)

Obtiene el valor de la columna especificada en el formato específico del proveedor.Gets the value of the specified column in provider-specific format.

GetProviderSpecificValues(Object[])

Rellena la matriz proporcionada de información de tipo específico del proveedor para todas las columnas del objeto DataTableReader.Fills the supplied array with provider-specific type information for all the columns in the DataTableReader.

GetSchemaTable()

Devuelve un objeto DataTable que describe los metadatos de columna del DataTableReader.Returns a DataTable that describes the column metadata of the DataTableReader.

GetStream(Int32)

Obtiene un flujo para recuperar datos de la columna especificada.Gets a stream to retrieve data from the specified column.

(Heredado de DbDataReader)
GetString(Int32)

Obtiene el valor de la columna especificada como una cadena.Gets the value of the specified column as a string.

GetTextReader(Int32)

Obtiene un lector de texto para recuperar datos de la columna.Gets a text reader to retrieve data from the column.

(Heredado de DbDataReader)
GetType()

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

(Heredado de Object)
GetValue(Int32)

Obtiene el valor de la columna especificada en su formato nativo.Gets the value of the specified column in its native format.

GetValues(Object[])

Rellena una matriz de objetos con los valores de columna de la fila actual.Populates an array of objects with the column values of the current row.

InitializeLifetimeService()

Obtiene un objeto de servicio de duración para controlar la directiva de duración de esta instancia.Obtains a lifetime service object to control the lifetime policy for this instance.

(Heredado de MarshalByRefObject)
IsDBNull(Int32)

Obtiene un valor que indica si la columna contiene valores no existentes o que faltan.Gets a value that indicates whether the column contains non-existent or missing values.

IsDBNullAsync(Int32)

Obtiene de manera asincrónica un valor que indica si la columna contiene valores no existentes o que faltan.Asynchronously gets a value that indicates whether the column contains non-existent or missing values.

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

(Heredado de DbDataReader)
MemberwiseClone()

Crea una copia superficial del Object actual.Creates a shallow copy of the current Object.

(Heredado de Object)
MemberwiseClone(Boolean)

Crea una copia superficial del objeto MarshalByRefObject actual.Creates a shallow copy of the current MarshalByRefObject object.

(Heredado de MarshalByRefObject)
NextResult()

Avanza el objeto DataTableReader al conjunto de resultados siguiente, si hay alguno.Advances the DataTableReader to the next result set, if any.

NextResultAsync()

Hace avanzar de manera asincrónica el lector hasta el resultado siguiente cuando se leen los resultados de un lote de instrucciones.Asynchronously advances the reader to the next result when reading the results of a batch of statements.

(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.Asynchronously advances the reader to the next result when reading the results of a batch of statements.

(Heredado de DbDataReader)
Read()

Desplaza DataTableReader al siguiente registro.Advances the DataTableReader to the next record.

ReadAsync()

Hace avanzar de manera asincrónica el lector hasta el siguiente registro de un conjunto de resultados.Asynchronously advances the reader to the next record in a result set.

(Heredado de DbDataReader)
ReadAsync(CancellationToken)

Hace avanzar de manera asincrónica el lector hasta el siguiente registro de un conjunto de resultados.Asynchronously advances the reader to the next record in a result set.

(Heredado de DbDataReader)
ToString()

Devuelve un valor de tipo string que representa el objeto actual.Returns a string that represents the current object.

(Heredado de Object)

Implementaciones de interfaz explícitas

IDataReader.Close()

Para una descripción de este miembro, vea Close().For a description of this member, see Close().

(Heredado de DbDataReader)
IDataReader.GetSchemaTable()

Para una descripción de este miembro, vea GetSchemaTable().For a description of this member, see GetSchemaTable().

(Heredado de DbDataReader)
IDataRecord.GetData(Int32)

Para una descripción de este miembro, vea GetData(Int32).For a description of this member, see 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.Gets a value that indicates whether a DbDataReader can get a column schema.

GetColumnSchema(DbDataReader)

Obtiene el esquema de columna (colección DbColumn) para DbDataReader.Gets the column schema (DbColumn collection) for a DbDataReader.

GetBoolean(DbDataReader, String)

Obtiene el valor de la columna especificada como tipo Boolean.Gets the value of the specified column as a Boolean.

GetByte(DbDataReader, String)

Obtiene el valor de la columna especificada como un byte.Gets the value of the specified column as a 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.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)

Obtiene el valor de la columna especificada como un único carácter.Gets the value of the specified column as a single character.

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

Devuelve un lector de datos anidados para la columna solicitada.Returns a nested data reader for the requested column.

GetDataTypeName(DbDataReader, String)

Obtiene el nombre del tipo de datos de la columna especificada.Gets name of the data type of the specified column.

GetDateTime(DbDataReader, String)

Obtiene el valor de la columna especificada como un objeto DateTime.Gets the value of the specified column as a DateTime object.

GetDecimal(DbDataReader, String)

Obtiene el valor de la columna especificada como objeto Decimal.Gets the value of the specified column as a Decimal.

GetDouble(DbDataReader, String)

Obtiene el valor de la columna especificada como un número de punto flotante de precisión doble.Gets the value of the specified column as a double-precision floating point number.

GetFieldType(DbDataReader, String)

Obtiene el tipo de datos de la columna especificada.Gets the data type of the specified column.

GetFieldValue<T>(DbDataReader, String)

Obtiene el valor de la columna especificada con el tipo solicitado.Gets the value of the specified column as the requested type.

GetFieldValueAsync<T>(DbDataReader, String, CancellationToken)

Obtiene de manera asincrónica el valor de la columna especificada con el tipo solicitado.Asynchronously gets the value of the specified column as the requested type.

GetFloat(DbDataReader, String)

Obtiene el valor de la columna especificada como un número de punto flotante de precisión sencilla.Gets the value of the specified column as a single-precision floating point number.

GetGuid(DbDataReader, String)

Obtiene el valor de la columna especificada en forma de identificador global único (GUID).Gets the value of the specified column as a globally unique identifier (GUID).

GetInt16(DbDataReader, String)

Obtiene el valor de la columna especificada como un entero de 16 bits con signo.Gets the value of the specified column as a 16-bit signed integer.

GetInt32(DbDataReader, String)

Obtiene el valor de la columna especificada como un entero con signo de 32 bits.Gets the value of the specified column as a 32-bit signed integer.

GetInt64(DbDataReader, String)

Obtiene el valor de la columna especificada como un entero de 64 bits con signo.Gets the value of the specified column as a 64-bit signed integer.

GetProviderSpecificFieldType(DbDataReader, String)

Devuelve el tipo específico del proveedor de la columna especificada.Gets the provider-specific type of the specified column.

GetProviderSpecificValue(DbDataReader, String)

Obtiene el valor de la columna especificada como instancia de un tipo específico del proveedor.Gets the value of the specified column as an instance of a provider-specific type.

GetStream(DbDataReader, String)

Obtiene un flujo para recuperar datos de la columna especificada.Gets a stream to retrieve data from the specified column.

GetString(DbDataReader, String)

Obtiene el valor de la columna especificada como una instancia de String.Gets the value of the specified column as an instance of String.

GetTextReader(DbDataReader, String)

Obtiene un lector de texto para recuperar datos de la columna.Gets a text reader to retrieve data from the column.

GetValue(DbDataReader, String)

Obtiene el valor de la columna especificada como una instancia de Object.Gets the value of the specified column as an instance of Object.

IsDBNull(DbDataReader, String)

Obtiene un valor que indica si la columna contiene valores que no existen o ausentes.Gets a value that indicates whether the column contains nonexistent or missing values.

IsDBNullAsync(DbDataReader, String, CancellationToken)

Obtiene de manera asincrónica un valor que indica si la columna contiene valores no existentes o que faltan.Asynchronously gets a value that indicates whether the column contains non-existent or missing values.

Cast<TResult>(IEnumerable)

Convierte los elementos de IEnumerable en el tipo especificado.Casts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable)

Filtra los elementos de IEnumerable en función de un tipo especificado.Filters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable)

Habilita la paralelización de una consulta.Enables parallelization of a query.

AsQueryable(IEnumerable)

Convierte una interfaz IEnumerable en IQueryable.Converts an IEnumerable to an IQueryable.

Se aplica a