Data.SqlExpr.TCustomSQLDataSet.CommandText

De RAD Studio API Documentation
Aller à : navigation, rechercher

Delphi

property CommandText: string read FCommandText write SetCommandText;

C++

__property System::UnicodeString CommandText = {read=FCommandText, write=SetCommandText};

Propriétés

Type Visibilité  Source Unité  Parent
property public
Data.SqlExpr.pas
Data.SqlExpr.hpp
Data.SqlExpr TCustomSQLDataSet

Description

Spécifie la commande que l'ensemble de données exécute.

La valeur de CommandText dépend de la propriété CommandType, comme suit :

  • Si CommandType contient ctQuery, CommandText est une instruction SQL exécutée par l'ensemble de données.
    • Si l'instruction est une commande SELECT, l'ensemble de données SQL exécute l'instruction lorsqu'il est ouvert.
    • Si l'instruction ne renvoie pas un ensemble de résultats, l'ensemble de données SQL exécute l'instruction quand la méthode ExecSQL est appelée.
  • Si CommandType contient ctStoredProc, CommandText est le nom d'une procédure stockée.
    • L'ensemble de données SQL exécute la procédure stockée quand il est ouvert ou quand la méthode ExecSQL est appelée, selon que la procédure stockée renvoie ou non un ensemble d'enregistrements.
  • Si CommandType contient ctTable, CommandText est le nom d'une table sur le serveur de base de données.
    • L'ensemble de données SQL génère automatiquement une instruction SELECT pour récupérer l'ensemble des enregistrements pour tous les champs de cette table, en effectuant un tri sur les champs listés dans la propriété SortFieldNames.
    • L'instruction générée est exécutée à l'ouverture de l'ensemble de données.

Utilisez la propriété Params pour fournir les valeurs des paramètres si CommandText est une instruction SQL qui inclut des paramètres ou si c'est le nom d'une procédure stockée ayant des paramètres.


Pour un exemple d'utilisation du chammp CommandText, voir Tutoriel mobile : Utilisation de InterBase ToGo avec dbExpress (iOS et Android). Ce tutoriel démontre comment terminer le champ CommandText en fournissant une chaîne (requête) plutôt que d'utiliser l'éditeur de texte de commande, qui peut être ouvert depuis l'inspecteur d'objets en double-cliquant sur le bouton points de suspension [...] dans le champ Valeur de CommandText.

Voir aussi