OracleCommand.CommandText Propriedade

Definição

Namespace:

System.Data.OracleClient

Assembly:

System.Data.OracleClient.dll

Obtém ou define a instrução SQL ou o procedimento armazenado a ser executado no banco 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

String

A instrução SQL ou o procedimento armazenado a ser executado. O valor padrão é uma cadeia de caracteres vazia ("").

Exemplos

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

public void CreateOracleCommand()
{
   OracleCommand command = new OracleCommand();
   command.CommandText = "SELECT * FROM Emp ORDER BY EmpNo";
   command.CommandType = CommandType.Text;
}

Public Sub CreateOracleCommand()
    Dim command As New OracleCommand()
    command.CommandText = "SELECT * FROM Emp ORDER BY EmpNo"
    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 métodos Execute.

O provedor de dados .NET Framework para Oracle não dá suporte ao espaço reservado de ponto de interrogação (?) para passar parâmetros para uma instrução SQL chamada por um OracleCommand de CommandType.Text. Nesse caso, os parâmetros nomeados devem ser usados. Por exemplo:

SELECT * FROM Customers WHERE CustomerID = :pCustomerID  

Ao usar parâmetros nomeados em uma instrução SQL chamada por um OracleCommand de CommandType.Text, você deve preceder o nome do parâmetro com dois-pontos (:). No entanto, em um procedimento armazenado ou ao fazer referência a um parâmetro nomeado em outro lugar em seu código (por exemplo, ao adicionar OracleParameter objetos à Parameters propriedade), não preceda o parâmetro nomeado com dois-pontos (:). O provedor de dados .NET Framework para Oracle fornece os dois-pontos automaticamente.

Confira também

• Trabalhando com comandos