FireDAC.Comp.Client.TFDUpdateSQL.Apply
Delphi
procedure Apply(ARequest: TFDUpdateRequest; var AAction: TFDErrorAction; AOptions: TFDUpdateRowOptions); override;
C++
virtual void __fastcall Apply(Firedac::Stan::Option::TFDUpdateRequest ARequest, Firedac::Stan::Intf::TFDErrorAction &AAction, Firedac::Stan::Option::TFDUpdateRowOptions AOptions);
Propriétés
| Type | Visibilité | Source | Unité | Parent |
|---|---|---|---|---|
procedure function |
public | FireDAC.Comp.Client.pas FireDAC.Comp.Client.hpp |
FireDAC.Comp.Client | TFDUpdateSQL |
Description
Applique une requête de mise à jour d'enregistrement dans la base de données pour l'enregistrement en cours dans DataSet.
Appelez Apply pour appliquer les modifications à l'enregistrement de DataSet en cours dans la base de données.
L'implémentation standard pour TFDUpdateSQL définit les paramètres d'une instruction SQL et exécute cette dernière pour mettre à jour un enregistrement. ARequest indique 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ée à 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 du gestionnaire d’événement doivent être affectées aux arguments correspondants de la méthode Apply.
ARequest peut prendre l'une des valeurs suivantes :
|
Valeur |
Signification |
Propriété SQL 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 un enregistrement dans la base de données. |
UnlockSQL |
|
|
Récupère 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 à inclure dans l'enregistrement. |
- |
AAction renvoie l 'état d'achèvement de la méthode Apply, en spécifiant une action au code d'appel. Normalement cet état est utilisé par le code FireDAC. Quand la méthode Apply est appelée à partir du gestionnaire d’événement OnUpdateRecord, affectez 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. Quand la méthode Apply est appelée à partir du gestionnaire d’événement OnUpdateRecord, affectez l'argument AOptions du gestionnaire d'événement à l'argument AOptions de la méthode Apply. Sinon, utilisez [] comme valeur.