FireDAC.Comp.DataSet.TFDDataSet.CloneCursor
Delphi
procedure CloneCursor(ASource: TFDDataSet; AReset: Boolean = False; AKeepSettings: Boolean = False); virtual;
C++
virtual void __fastcall CloneCursor(TFDDataSet* ASource, bool AReset = false, bool AKeepSettings = 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
Partage les données appartenant à un autre ensemble de données.
Appelez la méthode CloneCursor pour partager les données appartenant à un autre ensemble de données avec cet ensemble de données. Après l'appel de CloneCursor, le stockage de données interne est physiquement identique pour cet ensemble de données et l'ensemble de données ASource.
ASource est la référence à un ensemble de données dont les données sont partagées avec cet ensemble de données.
AReset et AKeepSettings déterminent comment initialiser la valeur des propriétés et événements suivants :
- Filter, Filtered, FilterOptions, OnFilterRecord, et FilterChanges.
- IndexName, IndexFieldNames.
- MasterSource et MasterFields.
- ReadOnly.
Si AReset et AKeepSettings ont tous les deux la valeur False, les valeurs des propriétés ci-dessus sont toutes initialisées pour correspondre à celles de l'ensemble de données source.
Si AReset vaut True, les propriétés ci-dessus sont toutes définies sur les valeurs par défaut.
Si AReset vaut False et que AKeepSettings vaut True, les propriétés ci-dessus ne sont pas modifiées. Dans ce cas, l'application doit s'assurer que les index existants, les filtres, etc. sont compatibles avec les données clonées.
CloneCursor ne clone pas :
- Les champs persistants
- L'objet adaptateur / mise à jour.
- Les gestionnaires d'événement, à l'exclusion de OnFilterRecord.
Exemple
FDMemTable1.CloneCursor(FDQuery1, True, False);
FDMemTable1.Locate(...);
FDMemTable1.Edit;
...
Voir aussi
Exemples
- Exemple FireDAC TFDMemTable Clone Cursor