Datasnap.DBClient.TCustomClientDataSet.CloneCursor
Delphi
procedure CloneCursor(Source: TCustomClientDataSet; Reset: Boolean; KeepSettings: Boolean = False); virtual;
C++
virtual void __fastcall CloneCursor(TCustomClientDataSet* Source, bool Reset, bool KeepSettings = false);
Propriétés
Type | Visibilité | Source | Unité | Parent |
---|---|---|---|---|
procedure function |
public | Datasnap.DBClient.pas Datasnap.DBClient.hpp |
Datasnap.DBClient | TCustomClientDataSet |
Description
Partage les données appartenant à un autre ensemble de données client.
Appelez CloneCursor pour partager les données appartenant à un autre ensemble de données client. Source indique l'autre ensemble de données client dont les données sont partagées.
Reset et KeepSettings déterminent comment initialiser la valeur des propriétés et événements suivants :
Filter, Filtered, FilterOptions et OnFilterRecord
IndexName
MasterSource et MasterFields
ReadOnly
RemoteServer et ProviderName
Si les paramètres Reset et KeepSettings sont tous les deux à false, la valeur des propriétés ci-dessus sont toutes initialisées pour correspondre à celles de l'ensemble de données source.
Si Reset a la valeur true, toutes les propriétés ci-dessus sont effacées.
Si Reset a la valeur false et KeepSettings la valeur 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 fournisseurs et autres sont compatibles avec les données clonées.
Après l'appel de CloneCursor, les données de l'ensemble de données client sont identiques à celles de Source. Les modifications effectuées dans l'un ou l'autre des ensembles de données client sont reflétées dans les deux ensembles de données.
Remarque : Comme les curseurs clonés sont partagés, la modification de propriétés affectant le curseur affecte les ensembles de données. Par exemple, l'affectation de la propriété ReadOnly à un des ensembles de données mettra les deux ensembles de données en lecture seule.