OleDbDataReader Clase

Definición

Espacio de nombres:

System.Data.OleDb

Ensamblado:

System.Data.OleDb.dll

Paquete:

System.Data.OleDb v9.0.0-rc.2.24473.5

Source:

OleDbDataReader.cs

Proporciona una manera de leer un flujo de solo avance de filas de datos de un origen de datos. Esta clase no se puede heredar.

public ref class OleDbDataReader sealed : System::Data::Common::DbDataReader

public sealed class OleDbDataReader : System.Data.Common.DbDataReader

type OleDbDataReader = class
    inherit DbDataReader

Public NotInheritable Class OleDbDataReader
Inherits DbDataReader

Herencia

Object

MarshalByRefObject

DbDataReader

OleDbDataReader

Ejemplos

En el ejemplo siguiente se crea un OleDbConnection, un OleDbCommandy un OleDbDataReader. En el ejemplo se leen los datos y se escribe en la consola. Por último, el ejemplo cierra el OleDbDataReader y, a continuación, el 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 un OleDbDataReader, debe llamar al método ExecuteReader del objeto OleDbCommand, en lugar de usar directamente un constructor.

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

Los cambios realizados en un conjunto de resultados por otro proceso o subproceso mientras se leen los datos pueden ser visibles para el usuario de la OleDbDataReader. Sin embargo, el comportamiento preciso depende del tiempo.

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

Propiedades

Depth	Obtiene un valor que indica la profundidad de anidamiento de la fila actual.
FieldCount	Obtiene el número de columnas de la fila actual.
HasRows	Obtiene un valor que indica si el 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 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 modificadas, insertadas o eliminadas por la ejecución de la instrucción SQL.
VisibleFieldCount	Obtiene el número de campos de la 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 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 booleano.
GetByte(Int32)	Obtiene el valor de la columna especificada como un byte.
GetBytes(Int32, Int64, Byte[], Int32, Int32)	Lee un flujo de bytes 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)	Lee una secuencia de caracteres del desplazamiento de columna especificado en el búfer como una matriz que comienza en el desplazamiento del búfer especificado.
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 objeto OleDbDataReader para el ordinal 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 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 objeto Decimal.
GetDouble(Int32)	Obtiene el valor de la columna especificada como un número de punto flotante de precisión doble.
GetEnumerator()	Devuelve un IEnumerator que se puede usar para recorrer en iteración las filas del lector de datos.
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 nombre de la columna especificada.
GetOrdinal(String)	Obtiene el ordinal de columna, dado el nombre de la columna.
GetProviderSpecificFieldType(Int32)	Obtiene el tipo específico del proveedor de la columna especificada. (Heredado de DbDataReader)
GetProviderSpecificValue(Int32)	Obtiene el valor de la columna especificada como una instancia de un tipo específico del proveedor. (Heredado de DbDataReader)
GetProviderSpecificValues(Object[])	Obtiene todas las columnas de atributo específicas del proveedor de la colección para la fila actual. (Heredado de DbDataReader)
GetSchemaTable()	Devuelve un DataTable que describe los metadatos de columna del OleDbDataReader.
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)
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 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()	Hace avanzar el lector de datos al siguiente resultado, al leer los resultados de las instrucciones SQL por lotes.
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 OleDbDataReader 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.

Consulte también

• DataAdapters y DataReaders