SqlCeCommand.CommandText Property

Obtiene o establece una instrucción SQL que se va a ejecutar en el origen de datos.

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

Sintaxis

'Declaración
Public Overrides Property CommandText As String

public override string CommandText { get; set; }

public:
virtual property String^ CommandText {
    String^ get () override;
    void set (String^ value) override;
}

/** @property */
public String get_CommandText ()

/** @property */
public void set_CommandText (String value)

public override function get CommandText () : String

public override function set CommandText (value : String)

Valor de la propiedad

Instrucción SQL que se va a ejecutar o nombre de la tabla base que se va a abrir. El valor predeterminado es una cadena vacía.

Notas

Cuando la propiedad CommandType se establece en TableDirect, se debe establecer la propiedad CommandText en el nombre de la tabla a la que se desea obtener acceso. El tipo de acceso de TableDirect es el modo más rápido de recuperar datos de SQL Server Compact 3.5. Se le puede pedir al usuario que utilice la sintaxis de carácter de escape si el nombre de alguna de las tablas contiene caracteres especiales. Al llamar a uno de los métodos Execute, se devolverán todas las filas y columnas de las tablas con nombre.

Las propiedades Connection, CommandType y CommandText no pueden establecerse si la conexión actual está realizando una operación Execute o Fetch.

El proveedor de datos de .NET Compact Framework para SQL Server Compact 3.5 admite parámetros con nombre para pasar parámetros a una instrucción SQL a la que llama un objeto SqlCeCommand si CommandType se ha establecido en Text. Por ejemplo:

SELECT * FROM Customers WHERE CustomerID = @customerID

El proveedor de datos para SQL Server Compact 3.5 tampoco 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, probablemente deban modificarse las consultas para que cumplan esta restricción.

Se han de especificar nombres de columna para consultas INSERT cuando se utiliza la replicación habilitada de RDA. Las tablas con seguimiento de RDA contienen columnas generadas por el sistema que cambiarán el recuento de columnas esperado en la consulta. Si no se especifican nombres de columna y el número de columnas de la instrucción INSERT es diferente del número de columnas de la tabla, la consulta INSERT no se realizará correctamente.

Ejemplo

En el ejemplo siguiente se crea un objeto SqlCeCommand y se establecen las propiedades CommandText y otras.

Dim cmd As SqlCeCommand = conn.CreateCommand()
cmd.CommandText = "SELECT * FROM Categories ORDER BY CategoryID"
cmd.CommandType = CommandType.Text
cmd.UpdatedRowSource = UpdateRowSource.Both

SqlCeCommand cmd = conn.CreateCommand();
cmd.CommandText = "SELECT * FROM Categories ORDER BY CategoryID";
cmd.CommandType = CommandType.Text;
cmd.UpdatedRowSource = UpdateRowSource.Both;

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 Class
SqlCeCommand Members
System.Data.SqlServerCe Namespace
Connection
CommandType