OleDbDataReader Clase

Definición

Proporciona el modo de lectura de una secuencia de filas de datos de tipo sólo avance de un origen de datos. Esta clase no puede heredarse.

public ref class OleDbDataReader sealed : System::Data::Common::DbDataReader
public ref class OleDbDataReader sealed : MarshalByRefObject, IDisposable, System::Collections::IEnumerable, System::Data::IDataReader
public sealed class OleDbDataReader : System.Data.Common.DbDataReader
public sealed class OleDbDataReader : MarshalByRefObject, IDisposable, System.Collections.IEnumerable, System.Data.IDataReader
type OleDbDataReader = class
    inherit DbDataReader
type OleDbDataReader = class
    inherit MarshalByRefObject
    interface IDataReader
    interface IDisposable
    interface IDataRecord
    interface IEnumerable
Public NotInheritable Class OleDbDataReader
Inherits DbDataReader
Public NotInheritable Class OleDbDataReader
Inherits MarshalByRefObject
Implements IDataReader, IDisposable, IEnumerable
Herencia
OleDbDataReader
Herencia
Herencia
OleDbDataReader
Implementaciones

Ejemplos

En el ejemplo siguiente se crea , OleDbConnectiony OleDbCommand.OleDbDataReader En el ejemplo se leen los datos y se escribe en la consola. Por último, el ejemplo cierra OleDbDataReader y, a continuación, .OleDbConnection

public static void ReadData(string connectionString, string queryString)
{
    using (OleDbConnection connection = new OleDbConnection(connectionString))
    {
        OleDbCommand command = new OleDbCommand(queryString, connection);

        connection.Open();
        OleDbDataReader reader = command.ExecuteReader();

        while (reader.Read())
        {
            Console.WriteLine(reader[0].ToString());
        }
        reader.Close();
    }
}
Public Sub ReadData(ByVal connectionString As String, _
    ByVal queryString As String)
    Using connection As New OleDbConnection(connectionString)
        Dim command As New OleDbCommand(queryString, connection)

        connection.Open()

        Dim reader As OleDbDataReader = command.ExecuteReader()
        While reader.Read()
            Console.WriteLine(reader(0).ToString())
        End While
        reader.Close()
    End Using
End Sub

Comentarios

Para crear , OleDbDataReaderdebe llamar al ExecuteReader método del OleDbCommand objeto , en lugar de usar directamente un constructor.

Antes de cerrar OleDbConnection, primero cierre el OleDbDataReader objeto . También debe cerrar el OleDbDataReader objeto si planea volver a usar un OleDbCommand objeto . Por ejemplo, no se pueden recuperar parámetros de salida hasta después de llamar a Close.

Los cambios que otro proceso o subproceso realicen en un conjunto de resultados mientras se leen datos pueden ser visibles para el usuario de la OleDbDataReader. Sin embargo, el comportamiento exacto depende de la sincronización.

IsClosed y RecordsAffected son las únicas propiedades a las que se puede llamar una vez cerrada la OleDbDataReader. Aunque se puede tener acceso a la RecordsAffected propiedad mientras OleDbDataReader existe, llame Close siempre a antes de devolver el valor de RecordsAffected para garantizar un valor devuelto preciso.

Propiedades

Depth

Obtiene un valor que indica la profundidad del anidamiento de la fila actual.

FieldCount

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

HasRows

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

IsClosed

Indica si el lector de datos 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 cambiadas, insertadas o eliminadas mediante la ejecución de la instrucción SQL.

VisibleFieldCount

Obtiene el número de campos de OleDbDataReader que no están ocultos.

Métodos

Close()

Cierra el objeto OleDbDataReader.

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)
Finalize()

Permite que el objeto intente liberar recursos y realizar otras operaciones de limpieza antes que lo reclame la recolección de elementos no utilizados.

GetBoolean(Int32)

Obtiene el valor de la columna especificada como tipo Boolean.

GetByte(Int32)

Obtiene el valor de la columna especificada como un byte.

GetBytes(Int32, Int64, Byte[], Int32, Int32)

Lee una secuencia de bytes del desplazamiento de la columna especificada en el búfer como matriz, comenzando en el desplazamiento de búfer dado.

GetChar(Int32)

Obtiene el valor de la columna especificada como un carácter.

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

Lee una secuencia de caracteres del desplazamiento de columna especificado en el búfer como una matriz, comenzando en el desplazamiento de búfer dado.

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 objeto OleDbDataReader para el índice de columna solicitado.

GetDataTypeName(Int32)

Obtiene el nombre del tipo de datos de origen.

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

GetDouble(Int32)

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

GetEnumerator()

Devuelve una interfaz IEnumerator que se puede utilizar para recorrer en iteración las filas en el lector de datos.

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 identificador único global (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()
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 nombre de la columna especificada.

GetOrdinal(String)

Obtiene el índice de columna a partir del nombre de la columna determinado.

GetProviderSpecificFieldType(Int32)

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

(Heredado de DbDataReader)
GetProviderSpecificValue(Int32)

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

(Heredado de DbDataReader)
GetProviderSpecificValues(Object[])

Obtiene todas las columnas de atributos específicos del proveedor en la colección para la fila actual.

(Heredado de DbDataReader)
GetSchemaTable()

Devuelve un objeto DataTable que describe los metadatos de columna del OleDbDataReader.

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)
GetTimeSpan(Int32)

Obtiene el valor de la columna especificada como un objeto TimeSpan.

GetType()

Obtiene el Type de la instancia actual.

(Heredado de Object)
GetValue(Int32)

Obtiene el valor de la columna en el ordinal especificado 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 que no existen o ausentes.

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

Hace avanzar el lector de datos hasta el resultado siguiente, cuando se leen los resultados instrucciones SQL por lotes.

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

Devuelve un IDataReader para el ordinal de columna especificado.

IDataRecord.GetData(Int32)

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

(Heredado de DbDataReader)
IDisposable.Dispose()

Esta API admite la infraestructura de producto y no está pensada para usarse directamente en el código.

Libera los recursos utilizados por la instancia actual de la clase OleDbDataReader.

IEnumerable.GetEnumerator()

Devuelve un enumerador que recorre en iteración una colección.

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.

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.

Se aplica a

Consulte también