OdbcDataReader Clase
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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 OdbcDataReader sealed : System::Data::Common::DbDataReader
public ref class OdbcDataReader sealed : MarshalByRefObject, IDisposable, System::Collections::IEnumerable, System::Data::IDataReader
public sealed class OdbcDataReader : System.Data.Common.DbDataReader
public sealed class OdbcDataReader : MarshalByRefObject, IDisposable, System.Collections.IEnumerable, System.Data.IDataReader
type OdbcDataReader = class
inherit DbDataReader
type OdbcDataReader = class
inherit MarshalByRefObject
interface IDataReader
interface IDataRecord
interface IDisposable
interface IEnumerable
Public NotInheritable Class OdbcDataReader
Inherits DbDataReader
Public NotInheritable Class OdbcDataReader
Inherits MarshalByRefObject
Implements IDataReader, IDisposable, IEnumerable
- Herencia
- Herencia
- Implementaciones
Ejemplos
En el ejemplo siguiente se crea un OdbcConnection, un OdbcCommandy un OdbcDataReader. En el ejemplo se leen los datos y se escribe en la consola. Por último, el ejemplo cierra el OdbcDataReadery, a continuación, el 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 un OdbcDataReader, debe llamar al método ExecuteReader del objeto OdbcCommand, en lugar de usar directamente un constructor.
Mientras se usa el OdbcDataReader, el OdbcConnection asociado está ocupado atendiendo a la OdbcDataReadery no se puede realizar ninguna otra operación en el OdbcConnection aparte de cerrarla. Este es el caso hasta que se llama al método Close del OdbcDataReader. 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 OdbcDataReader. Sin embargo, el comportamiento preciso es tanto el controlador como el control de tiempo dependiente.
IsClosed y RecordsAffected son las únicas propiedades a las que puede llamar después de cerrar el OdbcDataReader. A veces, debe llamar a Close antes de poder llamar a RecordsAffected.
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 OdbcDataReader contiene una o varias filas. |
IsClosed |
Indica si el OdbcDataReader 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 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) |
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) |
Finalize() |
Permite al objeto intentar liberar recursos y realizar otras operaciones de limpieza antes de que la recolección de elementos no utilizados la recupere. |
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, empezando por el desplazamiento de búfer determinado. |
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, empezando por el desplazamiento de búfer determinado. |
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 |
GetData(Int32) |
Devuelve un IDataReader para el ordinal de columna especificado. |
GetData(Int32) |
Devuelve un lector de datos anidado 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 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) |
Obtiene de forma asincrónica 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) |
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 OdbcDataReader. |
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 |
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 un 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. |
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) |
Obtiene de forma asincrónica un valor que indica si la columna contiene valores inexistentes o que faltan. (Heredado de DbDataReader) |
IsDBNullAsync(Int32, CancellationToken) |
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() |
Avanza el OdbcDataReader 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 OdbcDataReader 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) |
IDisposable.Dispose() |
Esta API admite la infraestructura de producto y no está pensada para usarse directamente en el código. Libera todos los recursos usados por la instancia actual de la clase OdbcDataReader. |
IEnumerable.GetEnumerator() |
Esta API admite la infraestructura de producto y no está pensada para usarse directamente en el código. Devuelve un enumerador que recorre en iteración una colección. |
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. |