Propriedade do RDL SqlCeCommand.CommandText
Obtém ou define uma instrução SQL a ser executada na fonte de dados.
Namespace: System.Data.SqlServerCe
Assembly: System.Data.SqlServerCe (em System.Data.SqlServerCe.dll)
Sintaxe
'Declaração
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 da propriedade
Tipo: System.String
A instrução SQL a ser executada ou o nome da tabela base a ser aberta. O valor padrão é uma cadeia de caracteres vazia.
Implementa
Comentários
Quando a propriedade CommandType é definida como TableDirect, a propriedade CommandText deve ser definida com o nome da tabela a ser acessada. O acesso TableDirect é a maneira mais rápida de recuperar dados do SQL Server Compact. Talvez seja necessário usar a sintaxe de caracteres de escape, se alguma das tabelas nomeadas contiver caracteres especiais. Todas as linhas e colunas da tabela ou das tabelas nomeadas serão retornadas quando você chamar um dos métodos Execute.
Não será possível definir as propriedades Connection, CommandType e CommandText se a conexão atual estiver executando uma operação Execute ou Fetch.
O Provedor de Dados do .NET Compact Framework para SQL Server Compact dá suporte a parâmetros nomeados para passar os parâmetros para uma instrução SQL chamada por um SqlCeCommand quando CommandType estiver definido como Text. Por exemplo:
SELECT * FROM Customers WHERE CustomerID = @customerID
O Provedor de Dados do SQL Server Compact também não dá suporte a consultas em lotes. Os comandos devem estar na seguinte forma: SELECT * FROM Customers e não SELECT * FROM Customers; SELECT * FROM Orders. Se estiver usando código gerado para System.Data.SqlClient, talvez seja necessário modificar suas consultas para que estejam de acordo com essa restrição.
Especifique nomes de coluna para consultas INSERT ao usar replicação habilitada para RDA. As tabelas controladas por RDA contêm colunas geradas pelo sistema que irão alterar a contagem de colunas esperadas para a consulta. Se você não especificar que os nomes e o número de colunas na instrução INSERT é diferente do número de colunas na tabela, a instrução INSERT irá falhar.
Exemplos
O exemplo a seguir cria um SqlCeCommand e define CommandText e outras propriedades.
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;