FireDAC.Comp.Client.TFDUpdateSQL.FetchRowSQL

De RAD Studio API Documentation
Aller à : navigation, rechercher

Delphi

property FetchRowSQL: TStrings index 5 read GetSQL write SetSQL;

C++

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

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 une instruction SQL à utiliser pour récupérer un seul enregistrement.

Définissez FetchRowSQL sur une instruction SQL lors de la récupération d'un seul enregistrement de la base de données.   Pour soumettre une valeur de champ originale d'un ensemble de données, utilisez le nom du paramètre :OLD_<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 renvoie les valeurs de champs d'un enregistrement utilisant des paramètres, utilisez le nom du paramètre :NEW_<nom du champ> ou :<nom du champ> et définissez le type du paramètre sur ptInputOutput ou 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. 

Si UpdateOptions.RefreshMode vaut rmAll, la commande FetchRowSQL est exécutée automatiquement après la validation d'un nouvel enregistrement ou la modification de l'enregistrement existant dans une base de données. Dans ce cas, la phrase WHERE doit utiliser les noms du paramètre :NEW.<nom du champ>

Pour créer une instruction SELECT à la conception, utilisez l'éditeur UpdateSQL pour créer des instructions. A cette 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 récupérer l'enregistrement. 

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.FetchRowSQL := 'SELECT SHIPPERID, COMPANYNAME, PHONE FROM ADDEMO."Shippers" ' +
  'WHERE SHIPPERID = :OLD_SHIPPERID';

Voir aussi