FireDAC.Comp.DataSet.TFDDataSet.BeginBatch

• Aller au parent : TFDDataSet

Delphi

procedure BeginBatch(ARegular: Boolean = False);

C++

void __fastcall BeginBatch(bool ARegular = false);

Propriétés

Type	Visibilité	Source	Unité	Parent
procedure function	public	FireDAC.Comp.DataSet.pas FireDAC.Comp.DataSet.hpp	FireDAC.Comp.DataSet	TFDDataSet

Description

Optimise la fonctionnalité de l'ensemble de données pour des mises à jour groupées.

Utilisez la méthode BeginBatch pour désactiver des opérations qui consomment beaucoup de ressources et configurer l'ensemble de données pour effectuer des mises à jour à vitesse maximale d'exécution. L'appel à BeginBatch désactive les éléments suivants :

• L'actualisation des contrôles orientés données.
• La mise à jour des contraintes.
• La maintenance des agrégats.
• L'affichage du curseur d'attente.
• Le traitement consommant une quantité similaire de ressources dans les objets DatS, qui n'est pas contrôlé par les API de l'ensemble de données.

Si un algorithme groupé appelle la méthode Delete, définissez AWithDelete sur True. Il est interdit d'appeler Refresh à l'intérieur d'un lot. Les appels de BeginBatch ne peuvent pas être imbriqués, même si FireDAC ne déclenche pas des exceptions sur des appels conséquents. Après la fin des mises à jour, appelez la méthode EndBatch.

Exemple

FDQuery1.BeginBatch;
try
  FDQuery1.AppendRecord([...]);
  FDQuery1.AppendRecord([...]);
  FDQuery1.AppendRecord([...]);
  ......
finally
  FDQuery1.EndBatch;
end;

Voir aussi

• FireDAC.Comp.DataSet.TFDDataSet.EndBatch