El SqlDataReader proporciona una forma de leer filas de una base de datos SQL Server de forma secuencial. Los resultados se devuelven a medida que se ejecuta la consulta y se almacenan en el búfer del cliente. El SqlDataReader implementa la interfaz IDataReader y permite leer los valores de las columnas mediante índices o nombres.

1. Objeto Sql.DataReader
Ingeniería de sistemas y telemática

2. DEFINICIÓN:
Ofrece una manera de leer un flujo de filas de solo avance desde
una base de datos de SQL Server. Esta clase no puede
heredarse.
Los resultados se devuelven a media que ejecutan la consulta y
se almacenan en el búfer de red del cliente hasta que solicitan
con el método Read del DataReader.

3. SINTAXIS:
Public Class SqlDataReader
Inherits DbDataReader
Implements IDataReader, IDisposable, IDataRecord

4. PROPIEDADES:
Connection Obtiene la SqlConnection asociada a la SqlDataReader.
Depth Obtiene un valor que indica la profundidad de anidamiento de la fila
actual.(Invalida DbDataReader.Depth).
FieldCount Obtiene el número de columnas de la fila
actual.(Invalida DbDataReader.FieldCount).
HasRows Obtiene un valor que indica si la SqlDataReader contiene una o más
filas.(Invalida DbDataReader.HasRows).
IsClosed Recupera un valor booleano que indica si el texto
especificado SqlDataReader instancia se ha
cerrado.(Invalida DbDataReader.IsClosed).
Item(Int32) Obtiene el valor de la columna especificada en su formato nativo dado el
ordinal de columna.(Invalida DbDataReader.Item(Int32)).
Item(String) Obtiene el valor de la columna especificada en su formato nativo dado el
nombre de columna.(Invalida DbDataReader.Item(String)).
RecordsAffected Obtiene el número de filas cambiadas, insertadas o eliminadas mediante la
ejecución de la instrucción de Transact-
SQL.(Invalida DbDataReader.RecordsAffected).
VisibleFieldCount Obtiene el número de campos de SqlDataReader que no están
ocultos.(Invalida DbDataReader.VisibleFieldCount).

5. MÉTODOS:
Close() Cierra el objeto SqlDataReader.(Invalida DbDataReader.Close()).
CreateObjRef(Type) Crea un objeto que contiene toda la información relevante necesaria para
generar a un proxy que se utiliza 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 administrados que usa el DbDataReader y, opcionalmente,
libera los recursos no administrados.(Heredado de DbDataReader).
Equals(Object) Determina si el objeto especificado es igual al objeto actual.(Heredado
de Object).
Finalize() Permite que un objeto intente liberar recursos y realizar otras operaciones de
limpieza antes de ser reclamado por el recolector de basura. (Heredado
de Object).
GetBoolean(Int32) Obtiene el valor de la columna especificada como tipo
Boolean.(Invalida DbDataReader.GetBoolean(Int32)).
GetByte(Int32) Obtiene el valor de la columna especificada como un
byte.(Invalida DbDataReader.GetByte(Int32)).
GetBytes(Int32, Int64, Byte(),
Int32, Int32)
Lee una secuencia de bytes desde el desplazamiento de la columna
especificada en el búfer de una matriz a partir del desplazamiento de búfer
dado.(Invalida DbDataReader.GetBytes(Int32, Int64, Byte(), Int32, Int32)).
GetChar(Int32) Obtiene el valor de la columna especificada como un único
carácter.(Invalida DbDataReader.GetChar(Int32)).
GetChars(Int32, Int64, Char(),
Int32, Int32)
Lee una secuencia de caracteres del desplazamiento de columna especificado
en el búfer como matriz, comenzando en el desplazamiento de búfer
dado.(Invalida DbDataReader.GetChars(Int32, Int64, Char(), Int32, Int32)).
GetData(Int32) Devuelve un DbDataReader objeto para el ordinal de columna
solicitado.(Heredado de DbDataReader).

6. CONCLUSION:
Para crear un T: System.Data.SqlClient.SqlDataReader, debe llamar al método M:
System.Data.SqlClient.SqlCommand.ExecuteReader del objeto T: System.Data.SqlClient.SqlCommand, en
lugar de utilizar directamente un constructor. Mientras se utiliza T: System.Data.SqlClient.SqlDataReader, el
asociado T: System.Data.SqlClient.SqlConnection está ocupado al servicio de T:
System.Data.SqlClient.SqlDataReader, y no se pueden realizar otras operaciones en el T :
System.Data.SqlClient.SqlConnection que no lo cierre.
Éste es el caso hasta que se llama al método M: System.Data.SqlClient.SqlDataReader.Close del T:
System.Data.SqlClient.SqlDataReader. Por ejemplo, no puede recuperar parámetros de salida hasta
después de llamar a M: System.Data.SqlClient.SqlDataReader.Close. Los cambios realizados en un
resultado establecido por otro proceso o subproceso mientras se están leyendo los datos pueden ser
visibles para el usuario del SqlDataReader. Sin embargo, el comportamiento preciso depende del tiempo.
IsClosed y RecordsAffected son las únicas propiedades que puede llamar después de que SqlDataReader
se cierra. Aunque se puede tener acceso a la propiedad RecordsAffected mientras existe SqlDataReader,
siempre llame a Cerrar antes de devolver el valor de RecordsAffected para garantizar un valor de retorno
preciso. Cuando se utiliza el acceso secuencial (F: System.Data.CommandBehavior.SequentialAccess), se
generará una T: System.InvalidOperationException si se avanza la posición T:
System.Data.SqlClient.SqlDataReader y se intenta otra operación de lectura en la columna anterior.