DbDataReader Clase

Definición

Espacio de nombres:

System.Data.Common

Ensamblado:

System.Data.Common.dll

Source:

DbDataReader.cs

Lee un flujo de filas de solo avance de un origen de datos.

public ref class DbDataReader abstract : MarshalByRefObject, IAsyncDisposable, IDisposable, System::Collections::IEnumerable, System::Data::IDataReader

public abstract class DbDataReader : MarshalByRefObject, IAsyncDisposable, IDisposable, System.Collections.IEnumerable, System.Data.IDataReader

type DbDataReader = class
    inherit MarshalByRefObject
    interface IEnumerable
    interface IDataReader
    interface IDataRecord
    interface IDisposable
    interface IAsyncDisposable

Public MustInherit Class DbDataReader
Inherits MarshalByRefObject
Implements IAsyncDisposable, IDataReader, IDisposable, IEnumerable

Herencia

Object

MarshalByRefObject

DbDataReader

Derivado

System.Data.DataTableReader

System.Data.EntityClient.EntityDataReader

System.Data.Odbc.OdbcDataReader

System.Data.OleDb.OleDbDataReader

System.Data.SqlClient.SqlDataReader

Implementaciones

IEnumerable IDisposable IDataReader IDataRecord IAsyncDisposable

Constructores

DbDataReader()

Inicializa una nueva instancia de la clase DbDataReader.

Propiedades

Depth	Obtiene un valor que indica la profundidad del anidamiento de la fila actual.
FieldCount	Cuando se reemplaza en una clase derivada, obtiene el número de columnas de la fila actual.
HasRows	Cuando se reemplaza en una clase derivada, obtiene un valor que indica si este DbDataReader contiene una o varias filas.
IsClosed	Cuando se reemplaza en una clase derivada, obtiene un valor que indica si el DbDataReader está cerrado.
Item[Int32]	Cuando se reemplaza en una clase derivada, obtiene el valor de la columna especificada como una instancia de Object.
Item[String]	Cuando se reemplaza en una clase derivada, obtiene el valor de la columna especificada como una instancia de Object.
RecordsAffected	Cuando se reemplaza en una clase derivada, obtiene el número de filas modificadas, insertadas 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.

Métodos

Close()	Cierra el objeto DbDataReader.
CloseAsync()	Cierra de forma asincrónica el objeto 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.
Dispose(Boolean)	Libera los recursos no administrados usados por el DbDataReader y, opcionalmente, libera los recursos administrados.
DisposeAsync()	Libera de forma asincrónica todos los recursos utilizados por la instancia actual de la clase DbDataReader.
Equals(Object)	Determina si el objeto especificado es igual al objeto actual. (Heredado de Object)
GetBoolean(Int32)	Cuando se reemplaza en una clase derivada, obtiene el valor de la columna especificada como booleano.
GetByte(Int32)	Cuando se reemplaza en una clase derivada, obtiene el valor de la columna especificada como un byte.
GetBytes(Int32, Int64, Byte[], Int32, Int32)	Cuando se reemplaza en una clase derivada, 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(Int32)	Cuando se reemplaza en una clase derivada, obtiene el valor de la columna especificada como un carácter único.
GetChars(Int32, Int64, Char[], Int32, Int32)	Cuando se reemplaza en una clase derivada, 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.
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.
GetData(Int32)	Devuelve un lector de datos anidado para la columna solicitada.
GetDataTypeName(Int32)	Cuando se reemplaza en una clase derivada, obtiene el nombre del tipo de datos de la columna especificada.
GetDateTime(Int32)	Cuando se reemplaza en una clase derivada, 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.
GetDecimal(Int32)	Cuando se reemplaza en una clase derivada, obtiene el valor de la columna especificada como un Decimal.
GetDouble(Int32)	Cuando se reemplaza en una clase derivada, obtiene el valor de la columna especificada como un número de punto flotante de precisión doble.
GetEnumerator()	Cuando se reemplaza en una clase derivada, devuelve un enumerador que se puede usar para recorrer en iteración las filas del lector de datos.
GetFieldType(Int32)	Cuando se reemplaza en una clase derivada, obtiene el tipo de datos de la columna especificada.
GetFieldValue<T>(Int32)	Obtiene el valor de la columna especificada como tipo solicitado.
GetFieldValueAsync<T>(Int32)	Obtiene de forma asincrónica el valor de la columna especificada como tipo solicitado.
GetFieldValueAsync<T>(Int32, CancellationToken)	Obtiene de forma asincrónica el valor de la columna especificada como tipo solicitado.
GetFloat(Int32)	Cuando se reemplaza en una clase derivada, obtiene el valor de la columna especificada como un número de punto flotante de precisión sencilla.
GetGuid(Int32)	Cuando se reemplaza en una clase derivada, 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)	Cuando se reemplaza en una clase derivada, obtiene el valor de la columna especificada como un entero de 16 bits con signo.
GetInt32(Int32)	Cuando se reemplaza en una clase derivada, obtiene el valor de la columna especificada como un entero de 32 bits con signo.
GetInt64(Int32)	Cuando se reemplaza en una clase derivada, 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)	Cuando se reemplaza en una clase derivada, obtiene el nombre de la columna, dada la ordinal de columna de base cero.
GetOrdinal(String)	Cuando se reemplaza en una clase derivada, obtiene la columna ordinal según el nombre de la columna.
GetProviderSpecificFieldType(Int32)	Obtiene el tipo específico del proveedor de la columna especificada.
GetProviderSpecificValue(Int32)	Obtiene el valor de la columna especificada como una instancia de un tipo específico del proveedor.
GetProviderSpecificValues(Object[])	Obtiene todas las columnas de atributo específicas del proveedor de la colección para la fila actual.
GetSchemaTable()	Devuelve un DataTable que describe los metadatos de columna del DbDataReader. Devuelve null si el comando ejecutado no devolvió ningún conjunto de resultados o después de NextResult() devuelve false.
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.
GetStream(Int32)	Obtiene una secuencia para recuperar datos de la columna especificada.
GetString(Int32)	Cuando se reemplaza en una clase derivada, obtiene el valor de la columna especificada como una instancia de String.
GetTextReader(Int32)	Obtiene un lector de texto para recuperar datos de la columna.
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
GetValue(Int32)	Cuando se reemplaza en una clase derivada, obtiene el valor de la columna especificada como una instancia de Object.
GetValues(Object[])	Cuando se reemplaza en una clase derivada, 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)	Cuando se reemplaza en una clase derivada, obtiene un valor que indica si la columna contiene valores inexistentes o que faltan.
IsDBNullAsync(Int32)	Obtiene de forma asincrónica 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.
MemberwiseClone()	Crea una copia superficial del Objectactual. (Heredado de Object)
MemberwiseClone(Boolean)	Crea una copia superficial del objeto MarshalByRefObject actual. (Heredado de MarshalByRefObject)
NextResult()	Cuando se reemplaza en una clase derivada, avanza el lector al siguiente resultado al leer los resultados de un lote de instrucciones.
NextResultAsync()	Avanza de forma asincrónica el lector al siguiente resultado al leer los resultados de un lote de instrucciones.
NextResultAsync(CancellationToken)	Avanza de forma asincrónica el lector al siguiente resultado al leer los resultados de un lote de instrucciones.
Read()	Cuando se invalida en una clase derivada, avanza el lector al siguiente registro de un conjunto de resultados.
ReadAsync()	Avanza de forma asincrónica el lector al siguiente registro de un conjunto de resultados.
ReadAsync(CancellationToken)	Avanza de forma asincrónica el lector al siguiente registro de un conjunto de resultados.
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).

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.

Consulte también

• DbProviderFactories (ADO.NET)
• información general de ADO.NET