Clase SqlCeDataReader

  • Artículo

Proporciona el modo de lectura de flujo de filas de datos de tipo sólo avance de un origen de datos. No se puede heredar esta clase.

Jerarquía de herencia

System.Object
  System.MarshalByRefObject
    System.Data.Common.DbDataReader
      System.Data.SqlServerCe.SqlCeDataReader
        System.Data.SqlServerCe.SqlCeResultSet

Espacio de nombres:  System.Data.SqlServerCe
Ensamblado:  System.Data.SqlServerCe (en System.Data.SqlServerCe.dll)

Sintaxis

'Declaración
Public Class SqlCeDataReader _
    Inherits DbDataReader
'Uso
Dim instance As SqlCeDataReader

public class SqlCeDataReader : DbDataReader

public ref class SqlCeDataReader : public DbDataReader

type SqlCeDataReader =  
    class
        inherit DbDataReader
    end

public class SqlCeDataReader extends DbDataReader

El tipo SqlCeDataReader expone los siguientes miembros.

Propiedades

  Nombre Descripción
Propiedad pública Depth Obtiene un valor que indica la profundidad del anidamiento de la fila actual. (Invalida DbDataReader.Depth.)
Propiedad pública FieldCount Obtiene el número de columnas de la cláusula SELECT de la consulta. (Invalida DbDataReader.FieldCount.)
Propiedad pública HasRows Obtiene un valor que indica si el objeto SqlCeDataReader contiene una o varias filas. (Invalida DbDataReader.HasRows.)
Propiedad pública HiddenFieldCount Infraestructura.
Propiedad pública IsClosed Indica si el lector de datos está cerrado. (Invalida DbDataReader.IsClosed.)
Propiedad pública Item[Int32] Obtiene el valor de la columna especificada en su formato nativo si se da el ordinal de la columna. (Invalida DbDataReader.Item[Int32].)
Propiedad pública Item[String] Obtiene el valor de la columna especificada en su formato nativo si se da el nombre de la columna. (Invalida DbDataReader.Item[String].)
Propiedad pública RecordsAffected Obtiene el número de filas modificadas, insertadas o eliminadas mediante la ejecución de la instrucción SQL. (Invalida DbDataReader.RecordsAffected.)
Propiedad pública VisibleFieldCount (se hereda de DbDataReader)

Arriba

Métodos

  Nombre Descripción
Método público Close Cierra el objeto SqlCeDataReader. (Invalida DbDataReader.Close().)
Método público CreateObjRef (se hereda de MarshalByRefObject)
Método público Dispose() Infraestructura. Libera los recursos utilizados por este SqlCeDataReader.
Método protegido Dispose(Boolean) Libera los recursos no administrados utilizados por este SqlCeDataReader y, opcionalmente, libera también los recursos administrados. (Invalida DbDataReader.Dispose(Boolean).)
Método público Equals (se hereda de Object)
Método protegido Finalize Libera recursos no administrados y realiza otras operaciones de limpieza antes de que se reclame el objeto SqlCeDataReader durante la recolección de elementos no utilizados. (Invalida Object.Finalize().)
Método público GetBoolean Obtiene el valor de la columna especificada como tipo Boolean. (Invalida DbDataReader.GetBoolean(Int32).)
Método público GetByte Obtiene el valor de la columna especificada como byte. (Invalida DbDataReader.GetByte(Int32).)
Método público GetBytes Lee un flujo de bytes del desplazamiento de la columna especificada en el búfer como matriz, comenzando en el desplazamiento de búfer dado. (Invalida DbDataReader.GetBytes(Int32, Int64, array<Byte[], Int32, Int32).)
Método público GetChar No es compatible con el proveedor de datos de .NET Compact Framework para SQL Server Compact. (Invalida DbDataReader.GetChar(Int32).)
Método público GetChars Lee un flujo de caracteres del desplazamiento de columna que se haya especificado en el búfer como matriz, comenzando en el desplazamiento de búfer dado. (Invalida DbDataReader.GetChars(Int32, Int64, array<Char[], Int32, Int32).)
Método público GetData (se hereda de DbDataReader)
Método público GetDataTypeName Obtiene el nombre del tipo de datos de origen. (Invalida DbDataReader.GetDataTypeName(Int32).)
Método público GetDateTime Obtiene el valor de la columna especificada como un objeto DateTime. (Invalida DbDataReader.GetDateTime(Int32).)
Método protegido GetDbDataReader (se hereda de DbDataReader)
Método público GetDecimal Obtiene el valor de la columna especificada como un objeto Decimal. (Invalida DbDataReader.GetDecimal(Int32).)
Método público GetDouble Obtiene el valor de la columna especificada como un número de punto flotante de precisión doble. (Invalida DbDataReader.GetDouble(Int32).)
Método público GetEnumerator Infraestructura. (Invalida DbDataReader.GetEnumerator().)
Método público GetFieldType Obtiene el objeto Type que es el tipo de datos del objeto. (Invalida DbDataReader.GetFieldType(Int32).)
Método público GetFloat Obtiene el valor de la columna especificada como un número de punto flotante de precisión simple. (Invalida DbDataReader.GetFloat(Int32).)
Método público GetGuid Obtiene el valor de la columna especificada en forma de identificador único global (GUID). (Invalida DbDataReader.GetGuid(Int32).)
Método público GetHashCode (se hereda de Object)
Método público GetInt16 Obtiene el valor de la columna especificada como un entero de 16 bits con signo. (Invalida DbDataReader.GetInt16(Int32).)
Método público GetInt32 Obtiene el valor de la columna especificada como un entero de 32 bits con signo. (Invalida DbDataReader.GetInt32(Int32).)
Método público GetInt64 Obtiene el valor de la columna especificada como un entero de 64 bits con signo. (Invalida DbDataReader.GetInt64(Int32).)
Método público GetLifetimeService (se hereda de MarshalByRefObject)
Método público GetName Obtiene el nombre de la columna especificada. (Invalida DbDataReader.GetName(Int32).)
Método público GetOrdinal Obtiene el ordinal de la columna a partir del nombre de la columna determinado. (Invalida DbDataReader.GetOrdinal(String).)
Método público GetProviderSpecificFieldType Obtiene un Object que es una representación del tipo de campo específico del proveedor subyacente. (Invalida DbDataReader.GetProviderSpecificFieldType(Int32).)
Método público GetProviderSpecificValue (se hereda de DbDataReader)
Método público GetProviderSpecificValues (se hereda de DbDataReader)
Método público GetSchemaTable Devuelve un DataTable que describe los metadatos de columna del SqlCeDataReader. (Invalida DbDataReader.GetSchemaTable().)
Método público GetSqlBinary Obtiene el valor de la columna especificada como un objeto SqlBinary.
Método público GetSqlBoolean Obtiene el valor de la columna especificada como un objeto SqlBoolean.
Método público GetSqlByte Obtiene el valor de la columna especificada como un objeto SqlByte.
Método público GetSqlDateTime Obtiene el valor de la columna especificada como un objeto SqlDateTime.
Método público GetSqlDecimal Obtiene el valor de la columna especificada como un objeto SqlDecimal.
Método público GetSqlDouble Obtiene el valor de la columna especificada como un objeto SqlDouble.
Método público GetSqlGuid Obtiene el valor de la columna especificada como un objeto SqlGuid.
Método público GetSqlInt16 Obtiene el valor de la columna especificada como un objeto SqlInt16.
Método público GetSqlInt32 Obtiene el valor de la columna especificada como un objeto SqlInt32.
Método público GetSqlInt64 Obtiene el valor de la columna especificada como un objeto SqlInt64.
Método público GetSqlMoney Obtiene el valor de la columna especificada como un objeto SqlMoney.
Método público GetSqlSingle Obtiene el valor de la columna especificada como un objeto SqlSingle.
Método público GetSqlString Obtiene el valor de la columna especificada como un objeto SqlString.
Método público GetString Obtiene el valor de la columna especificada como una cadena. (Invalida DbDataReader.GetString(Int32).)
Método público GetType (se hereda de Object)
Método público GetValue Obtiene el valor de la columna en el ordinal especificado en su formato nativo. (Invalida DbDataReader.GetValue(Int32).)
Método público GetValues Obtiene todas las columnas de atributos de la fila actual. (Invalida DbDataReader.GetValues(array<Object[]).)
Método público InitializeLifetimeService (se hereda de MarshalByRefObject)
Método protegido IsCommandBehavior Especifica un valor que determina si el objeto CommandBehavior especificado coincide con el de este objeto SqlCeDataReader.
Método público IsDBNull Obtiene un valor que indica si la columna contiene valores que no existen o valores que faltan. (Invalida DbDataReader.IsDBNull(Int32).)
Método protegido MemberwiseClone() (se hereda de Object)
Método protegido MemberwiseClone(Boolean) (se hereda de MarshalByRefObject)
Método público NextResult No es compatible con el proveedor de datos de .NET Compact Framework para SQL Server Compact. (Invalida DbDataReader.NextResult().)
Método protegido OnMove Infraestructura.
Método público Read Desplaza SqlCeDataReader al siguiente registro. (Invalida DbDataReader.Read().)
Método público Seek Coloca SqlCeDataReader en el registro con valores indizados que coinciden con los parámetros especificados.
Método público ToString (se hereda de Object)

Arriba

Implementaciones de interfaces explícitas

  Nombre Descripción
Implementación de interfaces explícitasMétodo privado IDataRecord.GetData (se hereda de DbDataReader)

Arriba

Comentarios

Para crear un objeto SqlCeDataReader, se debe llamar al método ExecuteReader del objeto SqlCeCommand, en vez de utilizar directamente un constructor.

Mientras se utiliza SqlCeDataReader, la interfaz SqlCeConnection asociada está ocupada atendiendo a SqlCeDataReader. En este estado, pueden crearse varios lectores en la misma conexión.

Los cambios realizados por otro proceso o subproceso en un conjunto de resultados mientras se leen los datos pueden ser visibles para el usuario de SqlCeDataReader; sin embargo, el comportamiento exacto depende del momento en que se producen dichos cambios.

IsClosed y RecordsAffected son las únicas propiedades a las que se puede llamar una vez se ha cerrado el objeto SqlCeDataReader. Aunque se puede obtener acceso a la propiedad RecordsAffected siempre que SqlCeDataReader exista, se debe llamar siempre a Close antes de devolver el valor de RecordsAffected para garantizar que se devuelve un valor preciso.

Ejemplos

En el siguiente ejemplo, se crean una conexión SqlCeConnection, un objeto SqlCeCommand y un SqlCeDataReader. En el ejemplo, se leen los datos y se escriben en la consola y, a continuación, se cierran el objeto SqlCeDataReader y la SqlCeConnection.

Dim conn As SqlCeConnection = Nothing
Dim cmd As SqlCeCommand = Nothing
Dim rdr As SqlCeDataReader = Nothing

Try
    ' Open the connection and create a SQL command
    '
    conn = New SqlCeConnection("Data Source = AdventureWorks.sdf")
    conn.Open()

    cmd = New SqlCeCommand("SELECT * FROM DimEmployee", conn)

    rdr = cmd.ExecuteReader()

    ' Iterate through the results
    '
    While rdr.Read()
        Dim employeeID As Integer = rdr.GetInt32(0) ' or: rdr["EmployeeKey"];
        Dim lastName As String = rdr.GetString(5) ' or: rdr["FirstName"];
    End While

    ' Always dispose data readers and commands as soon as practicable
    '
    rdr.Close()
    cmd.Dispose()
Finally
    ' Close the connection when no longer needed
    '
    conn.Close()
End Try

SqlCeConnection conn = null;
SqlCeCommand cmd = null;
SqlCeDataReader rdr = null;

try
{
    // Open the connection and create a SQL command
    //
    conn = new SqlCeConnection("Data Source = AdventureWorks.sdf");
    conn.Open();

    cmd = new SqlCeCommand("SELECT * FROM DimEmployee", conn);

    rdr = cmd.ExecuteReader();

    // Iterate through the results
    //
    while (rdr.Read())
    {
        int employeeID = rdr.GetInt32(0);   // or: rdr["EmployeeKey"];
        string lastName = rdr.GetString(5); // or: rdr["FirstName"];
    }

    // Always dispose data readers and commands as soon as practicable
    //
    rdr.Close();
    cmd.Dispose();
}
finally
{
    // Close the connection when no longer needed
    //
    conn.Close();
}

Seguridad para subprocesos

Todos los miembros estáticos públicos (Shared in Microsoft Visual Basic) de este tipo son seguros para subprocesos. No se garantiza que los miembros de instancia sean seguros para subprocesos.

Vea también

Referencia

Espacio de nombres System.Data.SqlServerCe