SqlCommand.CommandText Propriedade

Referência

Definição

Namespace:: System.Data.SqlClient

Assembly:: System.Data.SqlClient.dll

Assembly:: System.Data.dll

Pacote:: System.Data.SqlClient v4.8.6

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

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:
 property System::String ^ CommandText { System::String ^ get(); void set(System::String ^ value); };

public override string CommandText { get; set; }

[System.Data.DataSysDescription("DbCommand_CommandText")]
public string CommandText { get; set; }

member this.CommandText : string with get, set

[<System.Data.DataSysDescription("DbCommand_CommandText")>]
member this.CommandText : string with get, set

Public Overrides Property CommandText As String

Public Property CommandText As String

Valor da propriedade

String

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

Implementações

CommandText

Atributos: DataSysDescriptionAttribute

Exemplos

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

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

Public Sub CreateCommand()
    Dim command As New SqlCommand()
    command.CommandText = "SELECT * FROM Categories ORDER BY CategoryID"
    command.CommandTimeout = 15
    command.CommandType = CommandType.Text
End Sub

Comentários

Quando a CommandType propriedade é definida como StoredProcedure, 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, os parâmetros nomeados devem ser usados. Por exemplo:

SELECT * FROM dbo.Customers WHERE CustomerID = @CustomerID

Para obter mais informações, consulte Configurando parâmetros e tipos de dados de parâmetro.

Aplica-se a

Partilhar via