SqlCeCommand.CommandText Property

Artigo
01/14/2011

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

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

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.

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

Exemplo

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;

Segurança de thread

Quaisquer membros estáticos públicos (compartilhados no Microsoft Visual Basic) desse tipo são thread safe. Não há garantia de que qualquer membro de instância seja thread safe.

Plataformas

Plataformas de desenvolvimento

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
Informações de versão
.NET Framework e NET Compact Framework
Com suporte no 3.5
.NET Framework
Com suporte no 3.0
.NET Compact Framework e .Net Framework
Com suporte no 2.0

Consulte também

Referência

SqlCeCommand Class
SqlCeCommand Members
System.Data.SqlServerCe Namespace
Connection
CommandType

Compartilhar via