FireDAC.Comp.Client.TFDUpdateSQL.InsertSQL
Delphi
property InsertSQL: TStrings index 0 read GetSQL write SetSQL;
C++
__property System::Classes::TStrings* InsertSQL = {read=GetSQL, write=SetSQL, index=0};
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 lors de l'insertion d'un enregistrement.
Définissez InsertSQL sur une instruction SQL à utiliser lors de l'insertion d'un enregistrement dans une base de données.
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 de champs d'un enregistrement (identifiées ou modifiées dans le déclencheur) et qu'elles contiennent 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 d'enregistrements, ses champs doivent avoir les mêmes noms que les champs de l'ensemble de données.
Pour créer une instruction INSERT à la conception, utilisez l'éditeur UpdateSQL. 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 appliquer des insertions.
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
// SQL Server sample
FDUpdateSQL1.InsertSQL := 'INSERT INTO [Shippers] (COMPANYNAME, PHONE) ' +
'VALUES (:NEW_COMPANYNAME, :NEW_PHONE); SELECT SCOPE_IDENTITY() AS SHIPPERID';
// Oracle sample
FDUpdateSQL1.InsertSQL := 'INSERT INTO ADDEMO."Shippers" (COMPANYNAME, PHONE) ' +
'VALUES (:NEW_COMPANYNAME, :NEW_PHONE) RETURNING SHIPPERID INTO :NEW_SHIPPERID';
FDUpdateSQL1.Commands[arInsert].ParamByName('NEW_SHIPPERID').ParamType := ptOutput;