SqlCeCommand.CommandText Propiedad
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
Get
Set
'Uso
Dim instance As SqlCeCommand
Dim value As String
value = instance.CommandText
instance.CommandText = value
public override string CommandText { get; set; }
public:
virtual property String^ CommandText {
String^ get () override;
void set (String^ value) override;
}
abstract CommandText : string with get, set
override CommandText : string with get, set
override function get CommandText () : String
override function set CommandText (value : String)
Valor de la propiedad
Tipo: System.String
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.
Implementa
Comentarios
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. 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 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 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.
Ejemplos
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;