Objeto sql.data reader
- 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.