OdbcDataReader Clase

Definición

Espacio de nombres:

System.Data.Odbc

Ensamblado:

System.Data.Odbc.dll

Paquete:

System.Data.Odbc v8.0.0

Source:

OdbcDataReader.cs

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 OdbcDataReader sealed : System::Data::Common::DbDataReader

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

type OdbcDataReader = class
    inherit DbDataReader

Public NotInheritable Class OdbcDataReader
Inherits DbDataReader

Herencia

Object

DbDataReader

OdbcDataReader

Ejemplos

En el ejemplo siguiente se crea , OdbcConnectiony OdbcCommand.OdbcDataReader En el ejemplo se leen los datos y se escribe en la consola. Por último, el ejemplo cierra OdbcDataReadery, a continuación, .OdbcConnection

public static void ReadData(string connectionString)
{
    string queryString = "SELECT DISTINCT CustomerID FROM Orders";

    using (OdbcConnection connection = new OdbcConnection(connectionString))
    {
        OdbcCommand command = new OdbcCommand(queryString, connection);

        connection.Open();

        // Execute the DataReader and access the data.
        OdbcDataReader reader = command.ExecuteReader();
        while (reader.Read())
        {
            Console.WriteLine("CustomerID={0}", reader[0]);
        }

        // Call Close when done reading.
        reader.Close();
    }
}

Public Sub ReadData(ByVal connectionString As String)
    Dim queryString As String = "SELECT DISTINCT CustomerID FROM Orders"

    Using connection As New OdbcConnection(connectionString)
        Dim command As New OdbcCommand(queryString, connection)

        connection.Open()

        Dim reader As OdbcDataReader = command.ExecuteReader()

        While reader.Read()
            Console.WriteLine("CustomerID={0}", reader(0).ToString)
        End While

        ' Call Close when done reading.
        reader.Close()
    End Using
End Sub

Comentarios

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

OdbcDataReader Mientras se usa , el asociado OdbcConnection está ocupado atendiendo a OdbcDataReader, y no se puede realizar ninguna otra operación en el OdbcConnection otro que no sea cerrarlo. Este es el caso hasta que se llama al Close método de .OdbcDataReader 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 OdbcDataReader. Sin embargo, el comportamiento preciso depende tanto del controlador como del control de tiempo.

IsClosed y RecordsAffected son las únicas propiedades a las que se puede llamar una vez cerrada la OdbcDataReader. A veces, debe llamar a Close para poder llamar a RecordsAffected.

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 OdbcDataReader contiene una o varias filas.
IsClosed	Indica si OdbcDataReader 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 DbDataReader que no están ocultos. (Heredado de DbDataReader)

Métodos

Close()	Cierra el objeto OdbcDataReader.
CloseAsync()	Cierra de forma asincrónica el objeto DbDataReader. (Heredado de DbDataReader)
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)
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 la columna especificada en el búfer como 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 lector de datos anidados para la columna solicitada. (Heredado de DbDataReader)
GetDataTypeName(Int32)	Obtiene el nombre del tipo de datos de origen.
GetDate(Int32)	Obtiene el valor de la columna especificada como un objeto DateTime.
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.
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 OdbcDataReader.
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 objeto String.
GetTextReader(Int32)	Obtiene un lector de texto para recuperar datos de la columna. (Heredado de DbDataReader)
GetTime(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.
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)
NextResult()	Desplaza OdbcDataReader hasta el resultado siguiente cuando se leen los resultados de 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 OdbcDataReader 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)

Métodos de extensión

Consulte también

• Objetos DataAdapter y DataReader