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.Provides a way of reading a forward-only stream of data rows from a data source. Esta clase no puede heredarse.This class cannot be inherited.

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 un OleDbConnection , un OleDbCommand y un OleDbDataReader .The following example creates an OleDbConnection, an OleDbCommand, and an OleDbDataReader. En el ejemplo se leen los datos y se escriben en la consola.The example reads through the data, writing it out to the console. Finalmente, el ejemplo cierra OleDbDataReader y después el OleDbConnection .Finally, the example closes the OleDbDataReader and then the 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 ExecuteReader método del OleDbCommand objeto, en lugar de usar directamente un constructor.To create an OleDbDataReader, you must call the ExecuteReader method of the OleDbCommand object, instead of directly using a constructor.

Antes de cerrar el OleDbConnection , primero cierre el OleDbDataReader objeto.Before you close the OleDbConnection, first close the OleDbDataReader object. También debe cerrar el OleDbDataReader objeto si planea resuse un OleDbCommand objeto. Por ejemplo, no puede recuperar los parámetros de salida hasta después de llamar a Close .You must also close the OleDbDataReader object if you plan to resuse an OleDbCommand object.For example, you cannot retrieve output parameters until after you call 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.Changes made to a result set by another process or thread while data is being read may be visible to the user of the OleDbDataReader. Sin embargo, el comportamiento exacto depende de la sincronización.However, the precise behavior is timing dependent.

IsClosed y RecordsAffected son las únicas propiedades a las que se puede llamar una vez cerrada la OleDbDataReader.IsClosed and RecordsAffected are the only properties that you can call after the OleDbDataReader is closed. Aunque RecordsAffected se puede tener acceso a la propiedad mientras OleDbDataReader exista, llame siempre Close antes de devolver el valor de RecordsAffected para garantizar un valor devuelto preciso.Although the RecordsAffected property may be accessed while the OleDbDataReader exists, always call Close before returning the value of RecordsAffected to guarantee an accurate return value.

Propiedades

Depth

Obtiene un valor que indica la profundidad del anidamiento de la fila actual.Gets a value that indicates the depth of nesting for the current row.

FieldCount

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

HasRows

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

IsClosed

Indica si el lector de datos está cerrado.Indicates whether the data reader 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 cambiadas, insertadas o eliminadas mediante la ejecución de la instrucción SQL.Gets the number of rows changed, inserted, or deleted by execution of the SQL statement.

VisibleFieldCount

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

Métodos

Close()

Cierra el objeto OleDbDataReader.Closes the OleDbDataReader object.

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 que el objeto actual.Determines whether the specified object is equal to the current object.

(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.Allows the object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection.

GetBoolean(Int32)

Obtiene el valor de la columna especificada como tipo 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 del desplazamiento de la columna especificada en el búfer como matriz, comenzando en el desplazamiento de búfer dado.Reads a stream of bytes from the specified column offset into the buffer as an array starting at the given 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)

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.Reads a stream of characters from the specified column offset into the buffer as an array starting at the given buffer offset.

GetColumnSchemaAsync(CancellationToken)

Esta es la versión asincrónica de GetColumnSchema(DbDataReader).This is the asynchronous version of GetColumnSchema(DbDataReader). Los proveedores lo deben reemplazar con una implementación apropiada.Providers should override with an appropriate implementation. Opcionalmente, se puede respetar cancellationToken.The cancellationToken can optionally be honored. La implementación predeterminada invoca la llamada sincrónica a GetColumnSchema(DbDataReader) y devuelve una tarea completada.The default implementation invokes the synchronous GetColumnSchema(DbDataReader) call and returns a completed task. La implementación predeterminada devolverá una tarea cancelada si se pasa un cancellationToken ya cancelado.The default implementation will return a cancelled task if passed an already cancelled cancellationToken. Las excepciones producidas por GetColumnSchema(DbDataReader) se comunicarán mediante la propiedad Task Exception devuelta.Exceptions thrown by GetColumnSchema(DbDataReader) will be communicated via the returned Task Exception property.

(Heredado de DbDataReader)
GetData(Int32)

Devuelve un objeto OleDbDataReader para el índice de columna solicitado.Returns an OleDbDataReader object for the requested column ordinal.

GetDataTypeName(Int32)

Obtiene el nombre del tipo de datos de origen.Gets the name of the source data type.

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 un objeto Decimal.Gets the value of the specified column as a Decimal object.

GetDouble(Int32)

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.

GetEnumerator()

Devuelve una interfaz IEnumerator que se puede utilizar para recorrer en iteración las filas en el lector de datos.Returns an IEnumerator that can be used to iterate through the rows in the data reader.

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 identificador único global (GUID).Gets the value of the specified column as a globally unique identifier (GUID).

GetHashCode()

Sirve como la 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()
Obsoleto.

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 nombre de la columna especificada.Gets the name of the specified column.

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)

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

(Heredado de DbDataReader)
GetProviderSpecificValue(Int32)

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.

(Heredado de DbDataReader)
GetProviderSpecificValues(Object[])

Obtiene todas las columnas de atributos específicos del proveedor en la colección para la fila actual.Gets all provider-specific attribute columns in the collection for the current row.

(Heredado de DbDataReader)
GetSchemaTable()

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

GetSchemaTableAsync(CancellationToken)

Esta es la versión asincrónica de GetSchemaTable().This is the asynchronous version of GetSchemaTable(). Los proveedores lo deben reemplazar con una implementación apropiada.Providers should override with an appropriate implementation. Opcionalmente, se puede respetar cancellationToken.The cancellationToken can optionally be honored. La implementación predeterminada invoca la llamada sincrónica a GetSchemaTable() y devuelve una tarea completada.The default implementation invokes the synchronous GetSchemaTable() call and returns a completed task. La implementación predeterminada devolverá una tarea cancelada si se pasa un cancellationToken ya cancelado.The default implementation will return a cancelled task if passed an already cancelled cancellationToken. Las excepciones producidas por GetSchemaTable() se comunicarán mediante la propiedad Task Exception devuelta.Exceptions thrown by GetSchemaTable() will be communicated via the returned Task Exception property.

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

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

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 en el ordinal especificado en su formato nativo.Gets the value of the column at the specified ordinal 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()
Obsoleto.

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 que no existen o ausentes.Gets a value that indicates whether the column contains nonexistent 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()

Hace avanzar el lector de datos hasta el resultado siguiente, cuando se leen los resultados instrucciones SQL por lotes.Advances the data reader to the next result, when reading the results of batch SQL statements.

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 OleDbDataReader al siguiente registro.Advances the OleDbDataReader 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 una cadena que representa el objeto actual.Returns a string that represents the current object.

(Heredado de Object)

Implementaciones de interfaz explícitas

IDataReader.Close()

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

(Heredado de DbDataReader)
IDataReader.GetSchemaTable()

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

(Heredado de DbDataReader)
IDataRecord.GetData(Int32)

Devuelve un IDataReader para el ordinal de columna especificado.Returns an IDataReader for the specified column ordinal.

IDataRecord.GetData(Int32)

Para obtener una descripción de este miembro, vea GetData(Int32).For a description of this member, see 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.Releases the resources used by the current instance of the OleDbDataReader class.

IEnumerable.GetEnumerator()

Devuelve un enumerador que recorre en iteración una colección.Returns an enumerator that iterates through a collection.

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.

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