FireDAC.Comp.Client.TFDCustomUpdateObject.Apply
Delphi
procedure Apply(ARequest: TFDUpdateRequest; var AAction: TFDErrorAction; AOptions: TFDUpdateRowOptions); virtual; abstract;
C++
virtual void __fastcall Apply(Firedac::Stan::Option::TFDUpdateRequest ARequest, Firedac::Stan::Intf::TFDErrorAction &AAction, Firedac::Stan::Option::TFDUpdateRowOptions AOptions) = 0 ;
Propriétés
| Type | Visibilité | Source | Unité | Parent |
|---|---|---|---|---|
procedure function |
public | FireDAC.Comp.Client.pas FireDAC.Comp.Client.hpp |
FireDAC.Comp.Client | TFDCustomUpdateObject |
Description
Applique la requête de mise à jour d'enregistrement dans la base de données à l'enregistrement en cours dans l'ensemble de données.
Appelez Apply pour appliquer des modifications à l'enregistrement de l'ensemble de données en cours dans la base de données.
L'implémentation standard (TFDUpdateSQL) définit des paramètres pour une instruction SQL et exécute cette dernière pour mettre à jour l'enregistrement. ARequest indiquant le type de mise à jour, pour TFDUpdateSQL, il spécifie quelle instruction SQL exécuter. En l'absence de spécification d'une instruction SQL appropriée, FireDAC en génère une par défaut, comme il le fait quand TFDAdaptedDataSet.UpdateObject n'est pas spécifié.
Apply est principalement destiné à l'exécution manuelle d'instructions de mise à jour à partir d'un gestionnaire d'événement OnUpdateRecord. Les valeurs d'argument
ARequest, AAction et AOptions doivent être assignées aux arguments correspondants de la méthode Apply.
Voici les valeurs possibles de ARequest :
|
Valeur |
Signification |
Propriété TFDUpdateSQL |
|---|---|---|
|
|
Insère un enregistrement dans la base de données. |
InsertSQL |
|
|
Met à jour un enregistrement dans la base de données. |
ModifySQL |
|
|
Supprime un enregistrement de la base de données. |
DeleteSQL |
|
|
Verrouille un enregistrement dans la base de données. |
LockSQL |
|
|
Déverrouille l'enregistrement dans la base de données. |
UnlockSQL |
|
|
Extrait un enregistrement de la base de données. |
FetchRowSQL |
|
|
Met à jour les valeurs Oracle BLOB/CLOB dans la base de données. |
- |
|
|
Extrait les valeurs de générateur à placer dans l'enregistrement. |
- |
AAction renvoie l'état d'achèvement de la méthode Apply, en suggérant une action au code d'appel. Normalement cet état est utilisé par le code FireDAC. Lorsque la méthode Apply est appelée à partir du gestionnaire d'événement OnUpdateRecord, assignez l'argument AAction du gestionnaire d'événement à l'argument AAction de la méthode Apply. Sinon, utilisez eaDefault comme valeur initiale.
AOptions spécifie des options supplémentaires. Lorsque la méthode Apply est appelée à partir du gestionnaire d'événement OnUpdateRecord, assignez l'argument AOptions du gestionnaire d'événement à l'argument AOptions de la méthode Apply. Sinon, utilisez [] comme valeur.
Voir aussi
- Redéfinition de la validation des mises à jour
- FireDAC.Comp.Client.TFDUpdateSQL
- FireDAC.Comp.Client.TFDAdaptedDataSet.UpdateObject
Exemples
- Exemple FireDAC TFDQuery OnUpdateRecord