SqlCeCommand Class

Representa una instrucción SQL que se va a ejecutar en un origen de datos.

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

Sintaxis

'Declaración
Public NotInheritable Class SqlCeCommand
    Inherits DbCommand
    Implements ICloneable

public sealed class SqlCeCommand : DbCommand, ICloneable

public ref class SqlCeCommand sealed : public DbCommand, ICloneable

public final class SqlCeCommand extends DbCommand implements ICloneable

public final class SqlCeCommand extends DbCommand implements ICloneable

Notas

Cuando se crea una instancia de SqlCeCommand, las propiedades de lectura y escritura se establecen en sus valores iniciales. Para obtener una lista de esos valores, vea el constructor de SqlCeCommand.

SqlCeCommand dispone de los siguientes métodos para ejecutar comandos en el origen de datos:

El proveedor de datos para SQL Server Compact 3.5 no admite la ejecución de consultas por lotes. Los comandos deben tener el formato siguiente:

Select * from Customers y no Select * from Customers; Select * from Orders;

Si se utiliza el código generado para System.Data.SqlClient, las consultas deben modificarse para que cumplan esta restricción.

SQL Server Compact 3.5 admite varias conexiones simultáneas, así como varios comandos que compartan la misma conexión. Esto significa que es posible tener varias instancias de SqlCeDataReader en la misma conexión. Este comportamiento difiere del de System.Data.SqlClient.

Si el método que ejecuta SqlCeCommand genera una SqlCeException grave, SqlCeConnection podría cerrarse. El usuario puede volver a abrir la conexión y continuar.

Jerarquía de herencia

System.Object
   System.MarshalByRefObject
     System.ComponentModel.Component
       System.Data.Common.DbCommand
        System.Data.SqlServerCe.SqlCeCommand

Ejemplo

En el ejemplo siguiente se utiliza SqlCeCommand junto con SqlCeConnection para seleccionar filas de una base de datos.

Dim query As String = "SELECT [Order ID], [Customer] FROM Orders"
Dim conn As New SqlCeConnection(connString)
Dim cmd As New SqlCeCommand(query, conn)

conn.Open()
Dim rdr As SqlCeDataReader = cmd.ExecuteReader()

Try
    ' Iterate through the results
    '
    While rdr.Read()
        Dim val1 As Integer = rdr.GetInt32(0)
        Dim val2 As String = rdr.GetString(1)
    End While
Finally
    ' Always call Close when done reading
    '
    rdr.Close()

    ' Always call Close when done reading
    '
    conn.Close()
End Try

string query = "SELECT [Order ID], [Customer] FROM Orders";
SqlCeConnection conn = new SqlCeConnection(connString);
SqlCeCommand cmd = new SqlCeCommand(query, conn);

conn.Open();
SqlCeDataReader rdr = cmd.ExecuteReader();

try
{
    // Iterate through the results
    //
    while (rdr.Read())
    {
        int val1 = rdr.GetInt32(0);
        string val2 = rdr.GetString(1);
    }
}
finally
{
    // Always call Close when done reading
    //
    rdr.Close();

    // Always call Close when done reading
    //
    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

Vea también

Referencia

SqlCeCommand Members
System.Data.SqlServerCe Namespace
SqlCeDataAdapter
SqlCeConnection