FireDAC.Comp.Client.TFDUpdateSQL.ModifySQL

De RAD Studio API Documentation
Aller à : navigation, rechercher

Delphi

property ModifySQL: TStrings index 1 read GetSQL write SetSQL;

C++

__property System::Classes::TStrings* ModifySQL = {read=GetSQL, write=SetSQL, index=1};

Propriétés

Type Visibilité  Source Unité  Parent
property published
FireDAC.Comp.Client.pas
FireDAC.Comp.Client.hpp
FireDAC.Comp.Client TFDUpdateSQL


Description

Spécifie l'instruction SQL à utiliser lors de la mise à jour d'un enregistrement.

Définissez UpdateSQL sur l'instruction SQL à utiliser lors de la modification d'un enregistrement dans une base de données. 

Pour soumettre une valeur originale de champ d'un ensemble de données à une commande, utilisez le nom du paramètre :OLD_<nom du champ>. Pour soumettre une nouvelle valeur de champ à une commande, utilisez le nom du paramètre :NEW_<nom du champ> ou :<nom du champ>. Les instructions peuvent utiliser des macros et des paramètres supplémentaires. Pour obtenir l'accès à la collection de paramètres ou macros, utilisez la propriété Commands

Si l'instruction récupère de nouvelles valeurs (identifiées ou modifiées dans le déclencheur) de champs d'un enregistrement en utilisant des paramètres, utilisez le nom du paramètre :NEW_<nom du champ> ou :<nom du champ> pour inclure des valeurs de paramètres dans l'enregistrement, et définissez les types du paramètre sur ptOutput. Si l'instruction produit un ensemble de résultats, ses champs doivent avoir les mêmes noms que les champs de l'ensemble de données. 

Pour créer une instruction UPDATE à la conception, utilisez l'éditeur UpdateSQL. A ce fin, double-cliquez sur le composant TFDUpdateSQL. En outre, vous pouvez utiliser des appels de procédures stockées ou d'autres commandes SQL pour appliquer des modifications. 

Voir la propriété Commands pour des détails sur la façon d'utiliser les macros et les paramètres supplémentaires dans le texte de commande.

Exemple

FDUpdateSQL1.InsertSQL := 'UPDATE ADDEMO."Shippers" SET SHIPPERID = :NEW_SHIPPERID, ' +
  'COMPANYNAME = :NEW_COMPANYNAME, PHONE = :NEW_PHONE WHERE SHIPPERID = :OLD_SHIPPERID';

Voir aussi