SqlCeResultSet Class
Cursor actualizable, desplazable y enlazable.
Espacio de nombres: System.Data.SqlServerCe
Ensamblado: System.Data.SqlServerCe (en system.data.sqlserverce.dll)
Sintaxis
'Declaración
<DefaultMemberAttribute("Item")> _
Public Class SqlCeResultSet
Inherits SqlCeDataReader
Implements IEnumerable, IListSource
[DefaultMemberAttribute("Item")]
public class SqlCeResultSet : SqlCeDataReader, IEnumerable, IListSource
[DefaultMemberAttribute(L"Item")]
public ref class SqlCeResultSet : public SqlCeDataReader, IEnumerable, IListSource
/** @attribute DefaultMemberAttribute("Item") */
public class SqlCeResultSet extends SqlCeDataReader implements IEnumerable, IListSource
DefaultMemberAttribute("Item")
public class SqlCeResultSet extends SqlCeDataReader implements IEnumerable, IListSource
Notas
En versiones anteriores de SQL Server Compact 3.5, 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. In SQL Server Compact 3.5, the SqlCeResultSet provides a combination of functionality: the updateability and scrollability of the DataSet plus performance similar to 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.
Jerarquía de herencia
System.Object
System.MarshalByRefObject
System.Data.Common.DbDataReader
System.Data.SqlServerCe.SqlCeDataReader
System.Data.SqlServerCe.SqlCeResultSet
Ejemplo
En el siguiente ejemplo, se crea una nueva base de datos SQL Server Compact 3.5. 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 (Compartidos en Microsoft Visual Basic) de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancia sean seguros para subprocesos.
Plataformas
Plataformas de desarrollo
Windows Vista, Windows Mobile 5.0, Windows XP Professional with Service Pack 2 (SP2), Windows Server 2003, Windows Mobile 2003 for Pocket PC, Windows CE 5.0
Información de la versión
.NET Framework y NET Compact Framework
Se admite en 3.5
.NET Framework
Se admite en 3.0
.NET Compact Framework y .Net Framework
Se admite en 2.0