Clase SqlCeResultSet

  • Artículo

Cursor actualizable, desplazable y enlazable.

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 SqlCeResultSet _
    Inherits SqlCeDataReader _
    Implements IEnumerable, IListSource
'Uso
Dim instance As SqlCeResultSet

public class SqlCeResultSet : SqlCeDataReader, 
    IEnumerable, IListSource

public ref class SqlCeResultSet : public SqlCeDataReader, 
    IEnumerable, IListSource

type SqlCeResultSet =  
    class
        inherit SqlCeDataReader
        interface IEnumerable
        interface IListSource
    end

public class SqlCeResultSet extends SqlCeDataReader implements IEnumerable, IListSource

El tipo SqlCeResultSet expone los siguientes miembros.

Constructores

  Nombre Descripción
Método protegido SqlCeResultSet Importante para la seguridad. No utilizar. Para crear un cursor SqlCeResultSet, deberá llamar al método ExecuteResultSet(ResultSetOptions) del objeto SqlCeCommand.

Arriba

Propiedades

  Nombre Descripción
Propiedad protegida ContainsListCollection Infraestructura.
Propiedad pública Depth Obtiene un valor que indica la profundidad del anidamiento de la fila actual. (se hereda de SqlCeDataReader)
Propiedad pública FieldCount Obtiene el número de columnas de la cláusula SELECT de la consulta. (se hereda de SqlCeDataReader)
Propiedad pública HasRows Obtiene un valor que indica si el objeto SqlCeDataReader contiene una o varias filas. (se hereda de SqlCeDataReader)
Propiedad pública HiddenFieldCount Infraestructura. (se hereda de SqlCeDataReader)
Propiedad pública IsClosed Indica si el lector de datos está cerrado. (se hereda de SqlCeDataReader)
Propiedad pública Item[Int32] Actúa como indizador para el cursor SqlCeResultSet. (Invalida SqlCeDataReader.Item[Int32].)
Propiedad pública Item[String] Actúa como indizador para el cursor SqlCeResultSet. (Invalida SqlCeDataReader.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. (se hereda de SqlCeDataReader)
Propiedad pública ResultSetView Se utiliza para enlazar un cursor SqlCeResultSet a un control.
Propiedad pública Scrollable Determina si el cursor SqlCeResultSet es desplazable.
Propiedad pública Sensitivity Determina la sensibilidad del cursor SqlCeResultSet.
Propiedad pública Updatable Determina si los valores contenidos dentro del cursor SqlCeResultSet se pueden modificar.
Propiedad pública VisibleFieldCount (se hereda de DbDataReader)

Arriba

Métodos

  Nombre Descripción
Método público Close Cierra el objeto SqlCeDataReader. (se hereda de SqlCeDataReader)
Método público CreateObjRef (se hereda de MarshalByRefObject)
Método público CreateRecord Crea una nueva fila en el servidor y devuelve un objeto SqlCeUpdatableRecord.
Método público Delete Elimina el registro actual del origen de datos situado en el servidor.
Método público Dispose() Infraestructura. Libera los recursos utilizados por este SqlCeDataReader. (se hereda de SqlCeDataReader)
Método protegido Dispose(Boolean) Libera los recursos no administrados utilizados por este SqlCeDataReader y, opcionalmente, libera también los recursos administrados. (se hereda de SqlCeDataReader)
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. (se hereda de SqlCeDataReader)
Método público GetBoolean Devuelve como un valor booleano el valor de la columna correspondiente al índice especificado. (Invalida SqlCeDataReader.GetBoolean(Int32).)
Método público GetByte Devuelve como un byte el valor de la columna correspondiente al índice especificado. (Invalida SqlCeDataReader.GetByte(Int32).)
Método público GetBytes Copia una longitud de bytes en el búfer empezando en una posición dada del campo especificado. (Invalida SqlCeDataReader.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. (se hereda de SqlCeDataReader)
Método público GetChars Copia una longitud de caracteres (tipo char) en el búfer empezando en una posición dada del campo especificado. (Invalida SqlCeDataReader.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. (se hereda de SqlCeDataReader)
Método público GetDateTime Devuelve como un tipo DateTime el valor de la columna correspondiente al índice especificado. (Invalida SqlCeDataReader.GetDateTime(Int32).)
Método protegido GetDbDataReader (se hereda de DbDataReader)
Método público GetDecimal Devuelve como un tipo Double el valor de la columna correspondiente al índice especificado. (Invalida SqlCeDataReader.GetDecimal(Int32).)
Método público GetDouble Devuelve como un tipo Double el valor de la columna correspondiente al índice especificado. (Invalida SqlCeDataReader.GetDouble(Int32).)
Método público GetEnumerator Devuelve un objeto IEnumerator que se puede utilizar para recorrer en iteración las filas en el lector de datos. (Invalida SqlCeDataReader.GetEnumerator().)
Método público GetFieldType Obtiene el objeto Type que es el tipo de datos del objeto. (se hereda de SqlCeDataReader)
Método público GetFloat Devuelve como un tipo Float el valor de la columna correspondiente al índice especificado. (Invalida SqlCeDataReader.GetFloat(Int32).)
Método público GetGuid Devuelve como un tipo GUID el valor de la columna correspondiente al índice especificado. (Invalida SqlCeDataReader.GetGuid(Int32).)
Método público GetHashCode (se hereda de Object)
Método público GetInt16 Devuelve como un tipo Int16 el valor de la columna correspondiente al índice especificado. (Invalida SqlCeDataReader.GetInt16(Int32).)
Método público GetInt32 Devuelve como un tipo Int32 el valor de la columna correspondiente al índice especificado. (Invalida SqlCeDataReader.GetInt32(Int32).)
Método público GetInt64 Devuelve como un tipo Int64 el valor de la columna correspondiente al índice especificado. (Invalida SqlCeDataReader.GetInt64(Int32).)
Método público GetLifetimeService (se hereda de MarshalByRefObject)
Método protegido GetList Devuelve una instancia de ResultSetView.
Método público GetName Obtiene el nombre de la columna especificada. (se hereda de SqlCeDataReader)
Método público GetOrdinal Obtiene el ordinal de la columna a partir del nombre de la columna determinado. (se hereda de SqlCeDataReader)
Método público GetProviderSpecificFieldType Obtiene un Object que es una representación del tipo de campo específico del proveedor subyacente. (se hereda de SqlCeDataReader)
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. (se hereda de SqlCeDataReader)
Método público GetSqlBinary Devuelve, como un tipo SqlBinary, el valor de la columna correspondiente al índice especificado. (Invalida SqlCeDataReader.GetSqlBinary(Int32).)
Método público GetSqlBoolean Devuelve, como un tipo SqlBoolean, el valor de la columna correspondiente al índice especificado. (Invalida SqlCeDataReader.GetSqlBoolean(Int32).)
Método público GetSqlByte Devuelve, como un tipo SqlByte, el valor de la columna correspondiente al índice especificado. (Invalida SqlCeDataReader.GetSqlByte(Int32).)
Método público GetSqlDateTime Devuelve, como un tipo SqlDateTime, el valor de la columna correspondiente al índice especificado. (Invalida SqlCeDataReader.GetSqlDateTime(Int32).)
Método público GetSqlDecimal Devuelve, como un tipo SqlDecimal, el valor de la columna correspondiente al índice especificado. (Invalida SqlCeDataReader.GetSqlDecimal(Int32).)
Método público GetSqlDouble Devuelve, como un tipo SqlDouble, el valor de la columna correspondiente al índice especificado. (Invalida SqlCeDataReader.GetSqlDouble(Int32).)
Método público GetSqlGuid Devuelve, como un tipo SqlGuid, el valor de la columna correspondiente al índice especificado. (Invalida SqlCeDataReader.GetSqlGuid(Int32).)
Método público GetSqlInt16 Devuelve, como un tipo SqlInt16, el valor de la columna correspondiente al índice especificado. (Invalida SqlCeDataReader.GetSqlInt16(Int32).)
Método público GetSqlInt32 Devuelve, como un tipo SqlInt32, el valor de la columna correspondiente al índice especificado. (Invalida SqlCeDataReader.GetSqlInt32(Int32).)
Método público GetSqlInt64 Devuelve, como un tipo SqlInt64, el valor de la columna correspondiente al índice especificado. (Invalida SqlCeDataReader.GetSqlInt64(Int32).)
Método público GetSqlMetaData Devuelve la información de metadatos asociada a la columna especificada.
Método público GetSqlMoney Devuelve, como un tipo SqlMoney, el valor de la columna correspondiente al índice especificado. (Invalida SqlCeDataReader.GetSqlMoney(Int32).)
Método público GetSqlSingle Devuelve, como un tipo SqlSingle, el valor de la columna correspondiente al índice especificado. (Invalida SqlCeDataReader.GetSqlSingle(Int32).)
Método público GetSqlString Devuelve, como un tipo SqlString, el valor de la columna correspondiente al índice especificado. (Invalida SqlCeDataReader.GetSqlString(Int32).)
Método público GetString Devuelve, como un tipo String, el valor de la columna correspondiente al índice especificado. (Invalida SqlCeDataReader.GetString(Int32).)
Método público GetType (se hereda de Object)
Método público GetValue Devuelve el valor del campo especificado. (Invalida SqlCeDataReader.GetValue(Int32).)
Método público GetValues Recupera una matriz de todos los campos para el registro especificado. (Invalida SqlCeDataReader.GetValues(array<Object[]).)
Método público InitializeLifetimeService (se hereda de MarshalByRefObject)
Método público Insert(SqlCeUpdatableRecord) Inserta el objeto SqlCeUpdatableRecord especificado en el conjunto de filas subyacente.
Método público Insert(SqlCeUpdatableRecord, DbInsertOptions) Inserta el objeto SqlCeUpdatableRecord especificado en el conjunto de filas subyacente y especifica cómo está situado el cursor.
Método protegido IsCommandBehavior Especifica un valor que determina si el objeto CommandBehavior especificado coincide con el de este objeto SqlCeDataReader. (se hereda de SqlCeDataReader)
Método público IsDBNull Determina si el campo correspondiente a la posición ordinal especificada es nulo. (Invalida SqlCeDataReader.IsDBNull(Int32).)
Método público IsSetAsDefault Determina si el campo correspondiente a la posición ordinal especificada está marcado para utilizar el valor predeterminado subyacente.
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. (se hereda de SqlCeDataReader)
Método protegido OnMove Infraestructura. (Invalida SqlCeDataReader.OnMove().)
Método público Read Desplaza SqlCeDataReader al siguiente registro. (se hereda de SqlCeDataReader)
Método público ReadAbsolute Mueve el lector a un registro concreto del cursor ResultSet.
Método público ReadFirst Coloca el lector en el primer registro del cursor ResultSet.
Método público ReadLast Coloca el lector en el último registro del cursor ResultSet.
Método público ReadPrevious Coloca el lector en el registro anterior al registro actual.
Método público ReadRelative Mueve el lector el número de posiciones especificado desde la posición actual.
Método público Seek Coloca SqlCeDataReader en el registro con valores indizados que coinciden con los parámetros especificados. (se hereda de SqlCeDataReader)
Método público SetBoolean Asigna al valor de la columna especificada el valor booleano pasado como parámetro.
Método público SetByte Asigna al valor de la columna especificada el valor de tipo byte pasado como parámetro.
Método público SetBytes Copia una serie de bytes del búfer especificado a la columna especificada, empezando en la ubicación especificada dentro de ese campo.
Método público SetChar Asigna al valor de la columna especificada el valor de tipo char pasado como parámetro.
Método público SetChars Copia una serie de caracteres del búfer indicado en la columna dada, empezando por la ubicación especificada de ese campo.
Método público SetDateTime Asigna al valor de la columna especificada el valor de tipo DateTime pasado como parámetro.
Método público SetDecimal Asigna al valor de la columna especificada el valor de tipo Decimal pasado como parámetro.
Método público SetDefault Asigna a la columna especificada su valor predeterminado.
Método público SetDouble Asigna al valor de la columna especificada el valor de tipo Double pasado como parámetro.
Método público SetFloat Asigna al valor de la columna especificada el valor de tipo Float pasado como parámetro.
Método público SetGuid Asigna al valor de la columna especificada el valor de tipo Guid pasado como parámetro.
Método público SetInt16 Asigna al valor de la columna especificada el valor de tipo Int16 pasado como parámetro.
Método público SetInt32 Asigna al valor de la columna especificada el valor de tipo Int32 pasado como parámetro.
Método público SetInt64 Asigna al valor de la columna especificada el valor de tipo Int64 pasado como parámetro.
Método público SetObjectRef Enlaza un objeto a la columna correspondiente a la posición especificada.
Método público SetSqlBinary Asigna al valor de la columna especificada el valor de tipo SqlBinary pasado como parámetro.
Método público SetSqlBoolean Asigna al valor de la columna especificada el valor de tipo SqlBoolean pasado como parámetro.
Método público SetSqlByte Asigna al valor de la columna especificada el valor de tipo SqlByte pasado como parámetro.
Método público SetSqlDateTime Asigna al valor de la columna especificada el valor de tipo SqlDateTime pasado como parámetro.
Método público SetSqlDecimal Asigna al valor de la columna especificada el valor de tipo SqlDecimal pasado como parámetro.
Método público SetSqlDouble Asigna al valor de la columna especificada el valor de tipo SqlDouble pasado como parámetro.
Método público SetSqlGuid Asigna al valor de la columna especificada el valor de tipo SqlGuid pasado como parámetro.
Método público SetSqlInt16 Asigna al valor de la columna especificada el valor de tipo SqlInt16 pasado como parámetro.
Método público SetSqlInt32 Asigna al valor de la columna especificada el valor de tipo SqlInt32 pasado como parámetro.
Método público SetSqlInt64 Asigna al valor de la columna especificada el valor de tipo SqlInt64 pasado como parámetro.
Método público SetSqlMoney Asigna al valor de la columna especificada el valor de tipo SqlMoney pasado como parámetro.
Método público SetSqlSingle Asigna al valor de la columna especificada el valor de tipo SqlSingle pasado como parámetro.
Método público SetSqlString Asigna al valor de la columna especificada el valor de tipo SqlString pasado como parámetro.
Método público SetString Asigna al valor de la columna especificada el valor de tipo String pasado como parámetro.
Método público SetValue Asigna al valor de la columna especificada el valor pasado como parámetro.
Método público SetValues Asigna a cada uno de los campos del registro especificado el valor correspondiente de la matriz especificada.
Método público ToString (se hereda de Object)
Método público Update Envía los cambios del registro actual a la fila subyacente que reside en el servidor.

Arriba

Implementaciones de interfaces explícitas

  Nombre Descripción
Implementación de interfaces explícitasPropiedad privada IListSource.ContainsListCollection
Implementación de interfaces explícitasMétodo privado IEnumerable.GetEnumerator
Implementación de interfaces explícitasMétodo privado IListSource.GetList
Implementación de interfaces explícitasMétodo privado IDataRecord.GetData (se hereda de DbDataReader)

Arriba

Comentarios

En versiones anteriores de SQL Server Compact, para enlazar controles a datos, había que usar un DataSet. Aunque un objeto SqlCeDataReader proporciona mejor rendimiento que un objeto DataSet, aquél es un cursor sólo hacia delante y no actualizable. En SQL Server Compact, SqlCeResultSet proporciona una combinación de funcionalidad: la capacidad de actualización y desplazamiento de DataSet además de un rendimiento similar a SqlCeDataReader.

Para crear un cursor SqlCeResultSet, se debe realizar una llamada al método ExecuteResultSet, en lugar de utilizar el constructor del objeto.

La enumeración ResultSetOptions permite especificar las capacidades de desplazamiento, actualización y sensibilidad (que determina si el cursor SqlCeResultSet ve los cambios realizados por sí mismo o por otros) del cursor SqlCeResultSet.

La posición predeterminada de SqlCeDataReader está antes que el primer registro. Se debe llamar a Read para iniciar el acceso a cualquier dato. La primera llamada a Read colocará el cursor en el primer registro. El comportamiento es distinto al del método SqlCeResultSet.Read. La posición predeterminada del método SqlCeResultSet está antes que el primer registro. Una llamada al método SqlCeResultSet.Read inmediatamente después de crear SqlCeResultSet hará que el cursor se mueva al segundo registro.

Ejemplos

En el siguiente ejemplo, se crea una nueva base de datos SQL Server Compact. A continuación, se inicializa un cursor SqlCeResultSet para rellenar el conjunto de datos con información.

Dim conn As SqlCeConnection = Nothing

Try
    File.Delete("Test.sdf")

    Dim engine As New SqlCeEngine("Data Source = Test.sdf")
    engine.CreateDatabase()

    conn = New SqlCeConnection("Data Source = Test.sdf")
    conn.Open()

    Dim cmd As SqlCeCommand = conn.CreateCommand()
    cmd.CommandText = "CREATE TABLE myTable (col1 INT, col2 MONEY, col3 NVARCHAR(200))"
    cmd.ExecuteNonQuery()

    cmd.CommandText = "SELECT * FROM myTable"

    Dim rs As SqlCeResultSet = cmd.ExecuteResultSet(ResultSetOptions.Updatable Or ResultSetOptions.Scrollable)

    Dim rec As SqlCeUpdatableRecord = rs.CreateRecord()

    rec.SetInt32(0, 34)
    rec.SetDecimal(1, System.Convert.ToDecimal(44.66))
    rec.SetString(2, "Sample text")

    rs.Insert(rec)
Catch e As Exception
    MessageBox.Show(e.Message)
Finally
    conn.Close()
End Try

SqlCeConnection conn = null;

try
{
    File.Delete("Test.sdf");

    SqlCeEngine engine = new SqlCeEngine("Data Source = Test.sdf");
    engine.CreateDatabase();

    conn = new SqlCeConnection("Data Source = Test.sdf");
    conn.Open();

    SqlCeCommand cmd = conn.CreateCommand();
    cmd.CommandText = "CREATE TABLE myTable (col1 INT, col2 MONEY, col3 NVARCHAR(200))";
    cmd.ExecuteNonQuery();

    cmd.CommandText = "SELECT * FROM myTable";

    SqlCeResultSet rs = cmd.ExecuteResultSet(ResultSetOptions.Updatable | 
        ResultSetOptions.Scrollable);

    SqlCeUpdatableRecord rec = rs.CreateRecord();

    rec.SetInt32(0, 34);
    rec.SetDecimal(1, (decimal)44.66);
    rec.SetString(2, "Sample text");

    rs.Insert(rec);
}
catch (Exception e)
{
    MessageBox.Show(e.Message);
}
finally
{
    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