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.
Utilisez 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 définir les valeurs des propriétés et des é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 et autres sont compatibles avec les données clonées.
CloneCursor ne clone pas :
- Les champs persistants.
- L'objet adaptateur / mise à jour.
- Les gestionnaires d'événements, excluant OnFilterRecord.
Exemple
FDMemTable1.CloneCursor(FDQuery1, True, False);
FDMemTable1.Locate(...);
FDMemTable1.Edit;
...