Data.SqlExpr.TCustomSQLDataSet.CommandText
Delphi
property CommandText: UnicodeString 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 :
Quand CommandType est à ctQuery, CommandText est une instruction SQL que l'ensemble de données exécute. 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.
Quand CommandType est à ctStoredProc, CommandText contient 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 a la valeur ctTable, CommandText contient le nom d'une table sur le serveur de bases de données. L'ensemble de données SQL génère automatiquement une instruction SELECT pour extraire tous les champs de tous les enregistrements de cette table, en triant les champs spécifiés dans la propriété SortFieldNames. L'instruction générée est exécutée à l'ouverture de l'ensemble de données.
Si CommandText est une instruction SQL qui inclut des paramètres ou le nom d'une procédure stockée comprenant des paramètres, utilisez la propriété Params pour fournir des valeurs de paramètres.