OleDbDataReader Clase

Definición

Espacio de nombres:

System.Data.OleDb

Ensamblado:

System.Data.OleDb.dll

Paquete:

System.Data.OleDb v11.0.0-preview.2.26159.112

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

[System.Diagnostics.CodeAnalysis.RequiresDynamicCode("OleDbConnection is not AOT-compatible.")]
public sealed class OleDbDataReader : System.Data.Common.DbDataReader

[<System.Diagnostics.CodeAnalysis.RequiresDynamicCode("OleDbConnection is not AOT-compatible.")>]
type OleDbDataReader = class
    inherit DbDataReader

Public NotInheritable Class OleDbDataReader
Inherits DbDataReader

Herencia

Object

DbDataReader

OleDbDataReader

Atributos

RequiresDynamicCodeAttribute

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 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 un OleDbDataReader, debe llamar al ExecuteReader método del OleDbCommand objeto , en lugar de usar directamente un constructor.

Antes de cerrar , OleDbConnectionprimero cierre el OleDbDataReader objeto . También debe cerrar el OleDbDataReader objeto si tiene previsto volver a usar un OleDbCommand objeto. 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 OleDbDataReader. Sin embargo, el comportamiento preciso depende del tiempo.

IsClosedy RecordsAffected son las únicas propiedades a las que se puede llamar después de cerrar .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

Nombre	Description
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 contiene OleDbDataReader 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 que OleDbDataReader no están ocultos.

Métodos

Nombre	Description
Close()	Cierra el OleDbDataReader objeto .
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.
GetData(Int32)	Devuelve un OleDbDataReader objeto 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 DateTime objeto .
GetDecimal(Int32)	Obtiene el valor de la columna especificada como un Decimal objeto .
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 objeto que es el tipo de datos del objeto .
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).
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.
GetName(Int32)	Obtiene el nombre de la columna especificada.
GetOrdinal(String)	Obtiene el ordinal de columna, dado el nombre de la columna.
GetSchemaTable()	Devuelve un DataTable objeto que describe los metadatos de columna de .OleDbDataReader
GetString(Int32)	Obtiene el valor de la columna especificada como una cadena.
GetTimeSpan(Int32)	Obtiene el valor de la columna especificada como un TimeSpan objeto .
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.
IsDBNull(Int32)	Obtiene un valor que indica si la columna contiene valores inexistentes o que faltan.
NextResult()	Hace avanzar el lector de datos al siguiente resultado, al leer los resultados de las instrucciones SQL por lotes.
Read()	Avanza hasta OleDbDataReader el siguiente registro.

Consulte también

• Objetos DataAdapter y DataReader