SqlCommand.CommandText Propriedade

Definição

Espaço de Nomes:
System.Data.SqlClient
Assemblagem:
System.Data.dll

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

public:
 property System::String ^ CommandText { System::String ^ get(); void set(System::String ^ value); };
public:
 virtual property System::String ^ CommandText { System::String ^ get(); void set(System::String ^ value); };
[System.Data.DataSysDescription("DbCommand_CommandText")]
public string CommandText { get; set; }
public override string CommandText { get; set; }
[<System.Data.DataSysDescription("DbCommand_CommandText")>]
member this.CommandText : string with get, set
member this.CommandText : string with get, set
Public Property CommandText As String
Public Overrides Property CommandText As String

Valor de Propriedade

String

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

Implementações

CommandText
Atributos
DataSysDescriptionAttribute

Exemplos

O exemplo seguinte cria um SqlCommand e define algumas das 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

Observações

Quando a CommandType propriedade é definida para StoredProcedure, deve ser CommandText definida como o nome do procedimento armazenado. O utilizador pode ser obrigado a usar a sintaxe do carácter escape se o nome do procedimento armazenado contiver caracteres especiais. O comando executa este procedimento armazenado quando chamas um dos Execute métodos.

O Data Provider do Microsoft .NET Framework para SQL Server não suporta o marcador de interrogação (?) para passar parâmetros a uma instrução Transact-SQL ou a um procedimento armazenado chamado por um comando de CommandType.Text. Neste caso, devem ser usados parâmetros nomeados. Por exemplo:

SELECT * FROM dbo.Customers WHERE CustomerID = @CustomerID

Para mais informações, consulte Configuração de Parâmetros e Tipos de Dados de Parâmetros.

Aplica-se a

Ver também