OleDbDataReader OleDbDataReader OleDbDataReader OleDbDataReader Class

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 sealed class OleDbDataReader : System.Data.Common.DbDataReader
type OleDbDataReader = class
    inherit DbDataReader
Public NotInheritable Class OleDbDataReader
Inherits DbDataReader
Herencia

Ejemplos

En el ejemplo siguiente se OleDbConnectioncrea un OleDbCommand, un y OleDbDataReaderun.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. OleDbConnectionFinally, 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 Closede llamar a.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 realizados en un conjunto de resultados por otro proceso o subproceso mientras se leen los datos pueden ser visibles para el OleDbDataReaderusuario de.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 preciso depende del tiempo.However, the precise behavior is timing dependent.

IsClosedy RecordsAffected son las únicas propiedades a las que se puede llamar OleDbDataReader después de cerrar.IsClosed and RecordsAffected are the only properties that you can call after the OleDbDataReader is closed. Aunque se RecordsAffected puede tener acceso a la propiedad OleDbDataReader mientras exista, llame Close siempre antes de devolver el valor RecordsAffected de 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 Depth Depth 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 FieldCount FieldCount FieldCount

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

HasRows HasRows HasRows 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 IsClosed IsClosed IsClosed

Indica si el lector de datos está cerrado.Indicates whether the data reader is closed.

Item[Int32] Item[Int32] Item[Int32] 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] Item[String] Item[String] 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 RecordsAffected RecordsAffected 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 VisibleFieldCount VisibleFieldCount 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() Close() Close() Close()

Cierra el objeto OleDbDataReader.Closes the OleDbDataReader object.

CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type) 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.

(Inherited from MarshalByRefObject)
Equals(Object) Equals(Object) Equals(Object) Equals(Object)

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

(Inherited from Object)
Finalize() Finalize() Finalize() 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) GetBoolean(Int32) GetBoolean(Int32) GetBoolean(Int32)

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

GetByte(Int32) GetByte(Int32) GetByte(Int32) 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) GetBytes(Int32, Int64, Byte[], Int32, Int32) GetBytes(Int32, Int64, Byte[], Int32, Int32) 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) GetChar(Int32) GetChar(Int32) 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) GetChars(Int32, Int64, Char[], Int32, Int32) GetChars(Int32, Int64, Char[], Int32, Int32) GetChars(Int32, Int64, Char[], Int32, Int32)

Lee una secuencia de caracteres del desplazamiento de columna que se haya especificado en el búfer como 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.

GetData(Int32) GetData(Int32) GetData(Int32) GetData(Int32)

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

GetDataTypeName(Int32) GetDataTypeName(Int32) GetDataTypeName(Int32) GetDataTypeName(Int32)

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

GetDateTime(Int32) GetDateTime(Int32) GetDateTime(Int32) GetDateTime(Int32)

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

GetDecimal(Int32) GetDecimal(Int32) GetDecimal(Int32) 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) GetDouble(Int32) GetDouble(Int32) 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() GetEnumerator() GetEnumerator() 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) GetFieldType(Int32) GetFieldType(Int32) 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.

GetFloat(Int32) GetFloat(Int32) GetFloat(Int32) 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) GetGuid(Int32) GetGuid(Int32) GetGuid(Int32)

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

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

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

(Inherited from Object)
GetInt16(Int32) GetInt16(Int32) GetInt16(Int32) 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) GetInt32(Int32) GetInt32(Int32) 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) GetInt64(Int32) GetInt64(Int32) 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() GetLifetimeService() GetLifetimeService() 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.

(Inherited from MarshalByRefObject)
GetName(Int32) GetName(Int32) GetName(Int32) GetName(Int32)

Obtiene el nombre de la columna especificada.Gets the name of the specified column.

GetOrdinal(String) GetOrdinal(String) GetOrdinal(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.

GetSchemaTable() GetSchemaTable() GetSchemaTable() GetSchemaTable()

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

GetString(Int32) GetString(Int32) GetString(Int32) GetString(Int32)

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

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

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

(Inherited from Object)
GetValue(Int32) GetValue(Int32) GetValue(Int32) 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[]) GetValues(Object[]) GetValues(Object[]) 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() InitializeLifetimeService() InitializeLifetimeService() 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.

(Inherited from MarshalByRefObject)
IsDBNull(Int32) IsDBNull(Int32) IsDBNull(Int32) 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.

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

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

(Inherited from Object)
MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean)

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

(Inherited from MarshalByRefObject)
NextResult() NextResult() NextResult() 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.

Read() Read() Read() Read()

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

ToString() ToString() ToString() ToString()

Devuelve una cadena que representa el objeto actual.Returns a string that represents the current object.

(Inherited from Object)

Implementaciones de interfaz explícitas

IDataRecord.GetData(Int32) IDataRecord.GetData(Int32) IDataRecord.GetData(Int32) IDataRecord.GetData(Int32)

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

IDisposable.Dispose() IDisposable.Dispose() IDisposable.Dispose() IDisposable.Dispose()

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() IEnumerable.GetEnumerator() IEnumerable.GetEnumerator() IEnumerable.GetEnumerator()

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

Se aplica a

Consulte también: