OracleCommand.CommandText Propriété

Définition

Obtient ou définit l'instruction SQL ou la procédure stockée à exécuter sur la base de données.

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); };
public string CommandText { get; set; }
public override string CommandText { get; set; }
member this.CommandText : string with get, set
Public Property CommandText As String
Public Overrides Property CommandText As String

Valeur de propriété

Instruction SQL ou procédure stockée à exécuter. La valeur par défaut est une chaîne vide ("").

Implémente

Exemples

L’exemple suivant crée un OracleCommand et définit certaines de ses propriétés.

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

Remarques

Lorsque la propriété a la CommandTypeStoredProcedurevaleur , la CommandText propriété doit être définie sur le nom de la procédure stockée. L’utilisateur peut être amené à utiliser la syntaxe des caractères d’échappement si le nom de la procédure stockée contient des caractères spéciaux. La commande exécute cette procédure stockée lorsque vous appelez l'une des méthodes Execute.

Le fournisseur de données .NET Framework pour Oracle ne prend pas en charge l’espace réservé de point d’interrogation ( ?) pour passer des paramètres à une instruction SQL appelée par un OracleCommand de CommandType.Text. Dans ce cas, des paramètres nommés doivent être utilisés. Exemple :

SELECT * FROM Customers WHERE CustomerID = :pCustomerID  

Lorsque vous utilisez des paramètres nommés dans une instruction SQL appelée par un OracleCommand de CommandType.Text, vous devez faire précéder le nom du paramètre par un signe deux-points (:). Toutefois, dans une procédure stockée, ou lorsque vous faites référence à un paramètre nommé ailleurs dans votre code (par exemple, lors de l’ajout OracleParameter d’objets à la Parameters propriété), ne précèdez pas le paramètre nommé par deux-points (:). Le fournisseur de données .NET Framework pour Oracle fournit automatiquement les deux-points.

S’applique à

Voir aussi