Clase SqlCeCommand

  • Artículo

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

Jerarquía de herencia

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

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
'Uso
Dim instance As SqlCeCommand

public sealed class SqlCeCommand : DbCommand, 
    ICloneable

public ref class SqlCeCommand sealed : public DbCommand, 
    ICloneable

[<SealedAttribute>]
type SqlCeCommand =  
    class
        inherit DbCommand
        interface ICloneable
    end

public final class SqlCeCommand extends DbCommand implements ICloneable

El tipo SqlCeCommand expone los siguientes miembros.

Constructores

  Nombre Descripción
Método público SqlCeCommand() Inicializa una nueva instancia de la clase SqlCeCommand.
Método público SqlCeCommand(String) Inicializa una nueva instancia de la clase SqlCeCommand con el texto de la consulta.
Método público SqlCeCommand(String, SqlCeConnection) Inicializa una nueva instancia de la clase SqlCeCommand con el texto de la consulta y una conexión SqlCeConnection.
Método público SqlCeCommand(String, SqlCeConnection, SqlCeTransaction) Inicializa una nueva instancia de la clase SqlCeCommand con el texto de la consulta, una SqlCeConnection y la SqlCeTransaction.

Arriba

Propiedades

  Nombre Descripción
Propiedad protegida CanRaiseEvents (se hereda de Component)
Propiedad pública CommandText Obtiene o establece una instrucción SQL que se va a ejecutar en el origen de datos. (Invalida DbCommand.CommandText.)
Propiedad pública CommandTimeout Obtiene o establece el tiempo de espera antes de terminar el intento de ejecutar un comando y generar un error. (Invalida DbCommand.CommandTimeout.)
Propiedad pública CommandType Obtiene o establece un valor que indica cómo se interpreta la propiedad CommandText. (Invalida DbCommand.CommandType.)
Propiedad pública Connection Obtiene o establece la interfaz SqlCeConnection que utiliza esta instancia de SqlCeCommand.
Propiedad pública Container (se hereda de Component)
Propiedad protegida DbConnection (se hereda de DbCommand)
Propiedad protegida DbParameterCollection (se hereda de DbCommand)
Propiedad protegida DbTransaction (se hereda de DbCommand)
Propiedad protegida DesignMode (se hereda de Component)
Propiedad pública DesignTimeVisible Get siempre devuelve false; Set siempre produce una excepción NotSupportedException. (Invalida DbCommand.DesignTimeVisible.)
Propiedad protegida Events (se hereda de Component)
Propiedad pública IndexName Especifica el índice que se va a abrir.
Propiedad pública Parameters Obtiene la colección SqlCeParameterCollection.
Propiedad pública Site (se hereda de Component)
Propiedad pública Transaction Obtiene o establece la transacción en la que se ejecuta SqlCeCommand.
Propiedad pública UpdatedRowSource Obtiene o establece la manera en que se aplican los resultados del comando a DataRow cuando lo utiliza el método Update del DbDataAdapter. Esta propiedad no debe utilizarse con el proveedor de datos de .NET Compact Framework para SQL Server Compact. (Invalida DbCommand.UpdatedRowSource.)

Arriba

Métodos

  Nombre Descripción
Método público Cancel Intenta cancelar la ejecución de SqlCeCommand. (Invalida DbCommand.Cancel().)
Método protegido CreateDbParameter (se hereda de DbCommand)
Método público CreateObjRef (se hereda de MarshalByRefObject)
Método público CreateParameter Crea una nueva instancia de un objeto SqlCeParameter.
Método público Dispose() (se hereda de Component)
Método protegido Dispose(Boolean) (se hereda de Component)
Método público Equals (se hereda de Object)
Método protegido ExecuteDbDataReader (se hereda de DbCommand)
Método público ExecuteNonQuery Ejecuta una instrucción SQL en SqlCeConnection y devuelve el número de filas afectadas. (Invalida DbCommand.ExecuteNonQuery().)
Método público ExecuteReader() Envía la propiedad CommandText a Connection y crea un objeto SqlCeDataReader.
Método público ExecuteReader(CommandBehavior) Envía CommandText a Connection y crea un objeto SqlCeDataReader usando uno de los valores de CommandBehavior.
Método público ExecuteResultSet(ResultSetOptions) Envía CommandText a Connection y crea un objeto SqlCeResultSet utilizando ResultSetOptions.
Método público ExecuteResultSet(ResultSetOptions, SqlCeResultSet) Envía CommandText a Connection y crea un objeto SqlCeResultSet utilizando ResultSetOptions.
Método público ExecuteScalar Ejecuta la consulta y devuelve la primera columna de la primera fila del conjunto de resultados devueltos por la consulta. Las demás columnas o filas no se tienen en cuenta. (Invalida DbCommand.ExecuteScalar().)
Método protegido Finalize (se hereda de Component)
Método público GetHashCode (se hereda de Object)
Método público GetLifetimeService (se hereda de MarshalByRefObject)
Método protegido GetService (se hereda de Component)
Método público GetType (se hereda de Object)
Método público InitializeLifetimeService (se hereda de MarshalByRefObject)
Método protegido MemberwiseClone() (se hereda de Object)
Método protegido MemberwiseClone(Boolean) (se hereda de MarshalByRefObject)
Método público Prepare Crea una versión preparada (o compilada) del comando en el origen de datos. (Invalida DbCommand.Prepare().)
Método público SetRange Restringe el conjunto de filas que SqlCeDataReader va a leer.
Método público ToString (se hereda de Component)

Arriba

Eventos

  Nombre Descripción
Evento público Disposed (se hereda de Component)

Arriba

Implementaciones de interfaces explícitas

  Nombre Descripción
Implementación de interfaces explícitasMétodo privado ICloneable.Clone
Implementación de interfaces explícitasPropiedad privada IDbCommand.Connection (se hereda de DbCommand)
Implementación de interfaces explícitasMétodo privado IDbCommand.CreateParameter (se hereda de DbCommand)
Implementación de interfaces explícitasMétodo privado IDbCommand.ExecuteReader() (se hereda de DbCommand)
Implementación de interfaces explícitasMétodo privado IDbCommand.ExecuteReader(CommandBehavior) (se hereda de DbCommand)
Implementación de interfaces explícitasPropiedad privada IDbCommand.Parameters (se hereda de DbCommand)
Implementación de interfaces explícitasPropiedad privada IDbCommand.Transaction (se hereda de DbCommand)

Arriba

Comentarios

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:

Elemento

Description

ExecuteReader

Ejecuta comandos que devuelven filas.

ExecuteNonQuery

Ejecuta comandos SQL tales como las instrucciones INSERT, DELETE y UPDATE.

ExecuteScalar

Recupera un único valor (por ejemplo, un valor agregado) de una base de datos.

ExecuteResultSet

Ejecuta los comandos y devuelve un conjunto de resultados.

El proveedor de datos para SQL Server Compact 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 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.

Ejemplos

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 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

SqlCeDataAdapter

SqlCeConnection