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 puede heredarse.
public ref class OdbcDataReader sealed : MarshalByRefObject, IDisposable, System::Collections::IEnumerable, System::Data::IDataReaderpublic ref class OdbcDataReader sealed : System::Data::Common::DbDataReaderpublic sealed class OdbcDataReader : MarshalByRefObject, IDisposable, System.Collections.IEnumerable, System.Data.IDataReaderpublic sealed class OdbcDataReader : System.Data.Common.DbDataReadertype OdbcDataReader = class
inherit MarshalByRefObject
interface IDataReader
interface IDataRecord
interface IDisposable
interface IEnumerabletype OdbcDataReader = class
inherit DbDataReaderPublic NotInheritable Class OdbcDataReader
Inherits MarshalByRefObject
Implements IDataReader, IDisposable, IEnumerablePublic NotInheritable Class OdbcDataReader
Inherits DbDataReader- 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 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 un OdbcDataReader, debe 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 OdbcDataReadery no se puede realizar ninguna otra operación en el OdbcConnection que no se cierre. Este es el caso hasta que se llama al Close método de .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 OdbcDataReader. Sin embargo, el comportamiento preciso es tanto el controlador como el control de tiempo dependiente.
IsClosedy RecordsAffected son las únicas propiedades a las que se puede llamar después de cerrar .OdbcDataReader A veces, debe llamar Close a antes de poder llamar a RecordsAffected.
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 OdbcDataReader una o varias filas. |
| IsClosed |
Indica si 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 que DbDataReader no están ocultos. (Heredado de DbDataReader) |
Métodos
| Nombre | Description |
|---|---|
| Close() |
Cierra el OdbcDataReader objeto . |
| 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 DbDataReader clase . (Heredado de DbDataReader) |
| Dispose(Boolean) |
Libera los recursos no administrados utilizados por DbDataReader y, opcionalmente, libera los recursos administrados. (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. |
| 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 DateTime objeto . |
| GetDateTime(Int32) |
Obtiene el valor de la columna especificada como un DateTime objeto . |
| GetDbDataReader(Int32) |
Devuelve un DbDataReader objeto 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 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 . |
| GetFieldValue<T>(Int32) |
Obtiene 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) |
| GetFieldValueAsync<T>(Int32) |
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 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 de 32 bits con signo. |
| GetInt64(Int32) |
Obtiene el valor de la columna especificada como un entero de 64 bits con signo. |
| GetLifetimeService() |
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 objeto que describe los metadatos de columna de .OdbcDataReader |
| 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 .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 TimeSpan objeto . |
| 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() |
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, CancellationToken) |
Obtiene de forma asincrónica un valor que indica si la columna contiene valores inexistentes o que faltan. (Heredado de DbDataReader) |
| IsDBNullAsync(Int32) |
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 actual MarshalByRefObject . (Heredado de MarshalByRefObject) |
| NextResult() |
Avanza al OdbcDataReader 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 hasta OdbcDataReader el 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
| Nombre | Description |
|---|---|
| IDataRecord.GetData(Int32) |
Para obtener una descripción de este miembro, vea 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 OdbcDataReader clase . |
| 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
| Nombre | Description |
|---|---|
| AsParallel(IEnumerable) |
Habilita la paralelización de una consulta. |
| AsQueryable(IEnumerable) |
Convierte un IEnumerable en un IQueryable. |
| CanGetColumnSchema(DbDataReader) |
Obtiene un valor que indica si un DbDataReader objeto puede obtener un esquema de columna. |
| Cast<TResult>(IEnumerable) |
Convierte los elementos de un IEnumerable al tipo especificado. |
| GetColumnSchema(DbDataReader) |
Obtiene el esquema de columna (DbColumn colección) de un DbDataReaderobjeto . |
| OfType<TResult>(IEnumerable) |
Filtra los elementos de un IEnumerable en función de un tipo especificado. |