Datasnap.DBClient.TCustomClientDataSet.CloneCursor

De RAD Studio API Documentation
Aller à : navigation, rechercher

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.

Voir aussi