FireDAC.Comp.Client.TFDCommand.CommandText
Delphi
property CommandText: TStrings read FCommandText write SetCommandTextStrs;
C++
__property CommandText;
Propriétés
Type | Visibilité | Source | Unité | Parent |
---|---|---|---|---|
property | published | FireDAC.Comp.Client.pas FireDAC.Comp.Client.hpp |
FireDAC.Comp.Client | TFDCommand |
Description
Le texte de la commande SQL à exécuter.
FireDAC.Comp.Client.TFDCommand.CommandText hérite de FireDAC.Comp.Client.TFDCustomCommand.CommandText. Tout le contenu en-dessous de cette ligne se réfère à FireDAC.Comp.Client.TFDCustomCommand.CommandText.
Le texte de la commande SQL à exécuter.
La propriété CommandText définit / obtient :
- Le texte de la commande SQL à exécuter.
- Le nom de la procédure stockée à exécuter, si CommandKind est dans
[skStoredProc, skStoredProcWithCrs, skStoredProcNoCrs]
.
Après la définition de CommandText, FireDAC exécutera les actions suivantes pour les procédures non stockées :
- Il extrait les noms des paramètres et remplit la collection Params, si ResourceOptions.ParamCreate a la valeur True.
- Il extrait le nom de la macro et remplit la collection Macros, si ResourceOptions.MacroCreate a la valeur True.
- Il extrait le nom de la table
FROM
pour les commandesSELECT
et l'assigne à CommandIntf.SourceObjectName, si ResourceOptions.PreprocessCmdText a la valeur True. - Il remplit la valeur de la propriété CommandKind, si elle n'est pas définie explicitement.
Si vous ajoutez une commande longue, à l'aide de la méthode CommandText.Add, il est alors recommandé d'appeler CommandText.BeginUpdate avant la modification de la commande, et CommandText.EndUpdate après l'achèvement de la modification de la commande.
Plus tard, quand Prepare est appelé, le texte de la commande sera prétraité et transformé en une commande SGBD cible. Voir le chapitre Prétraitement du texte des commandes pour de plus amples détails à propos des macros FireDAC et des séquences d'échappement - instructions du préprocesseur.
Voir aussi
- Prétraitement du texte des commandes
- Exécution des commandes
- FireDAC.Stan.Option.TFDResourceOptions.ParamCreate
- FireDAC.Stan.Option.TFDResourceOptions.MacroCreate
- FireDAC.Stan.Option.TFDResourceOptions.PreprocessCmdText
- FireDAC.Comp.Client.TFDCustomCommand.CommandKind
- FireDAC.Comp.Client.TFDCustomCommand.Params
- FireDAC.Comp.Client.TFDCustomCommand.Macros
- FireDAC.Comp.Client.TFDCustomCommand.ResourceOptions