Partilhar via


SqlCommand.CommandText Propriedade

Definição

Obtém ou define a instrução Transact-SQL, nome da tabela ou procedimento armazenado a ser executado na fonte de dados.

public:
 virtual property System::String ^ CommandText { System::String ^ get(); void set(System::String ^ value); };
public override string CommandText { get; set; }
member this.CommandText : string with get, set
Public Overrides Property CommandText As String

Valor da propriedade

A instrução Transact-SQL ou procedimento armazenado a ser executado. O padrão é uma cadeia de caracteres vazia.

Exemplos

O exemplo a seguir cria um SqlCommand e define algumas de suas propriedades.

// <Snippet1>
using System;
using System.Xml;
using System.Data;
using Microsoft.Data.SqlClient;
using System.Data.Common;
using System.Windows.Forms;

public class Form1 : Form
{
    protected DataSet DataSet1;
    protected DataGrid dataGrid1;

    public void CreateCommand()
    {
        SqlCommand command = new SqlCommand();
        command.CommandText = "SELECT * FROM Categories ORDER BY CategoryID";
        command.CommandTimeout = 15;
        command.CommandType = CommandType.Text;
    }
    // </Snippet1>

}

Comentários

Quando a CommandType propriedade é definida StoredProcedurecomo , a CommandText propriedade deve ser definida como o nome do procedimento armazenado. O usuário poderá ser obrigado a usar a sintaxe de caractere de escape se o nome do procedimento armazenado contiver caracteres especiais. O comando executa esse procedimento armazenado quando você chama um dos Execute métodos .

O Provedor de Dados do Microsoft .NET Framework para SQL Server não dá suporte ao espaço reservado de ponto de interrogação (?) para passar parâmetros para uma instrução Transact-SQL ou um procedimento armazenado chamado por um comando de CommandType.Text. Nesse caso, parâmetros nomeados devem ser usados. Por exemplo:

SELECT * FROM dbo.Customers WHERE CustomerID = @CustomerID

Para obter mais informações, consulte Configurando parâmetros.

Aplica-se a