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