Datasnap.DBClient.TCustomClientDataSet.CloneCursor

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

procedure CloneCursor(Source: TCustomClientDataSet; Reset: Boolean;  KeepSettings: Boolean = False); virtual;

C++

virtual void __fastcall CloneCursor(TCustomClientDataSet* Source, bool Reset, bool KeepSettings = false);

Eigenschaften

Typ Sichtbarkeit Quelle Unit Übergeordnet
procedure
function
public
Datasnap.DBClient.pas
Datasnap.DBClient.hpp
Datasnap.DBClient TCustomClientDataSet

Beschreibung

Ermöglicht die gemeinsame Nutzung von Daten, die zu einer anderen Client-Datenmenge gehören.

Mit CloneCursor können Daten genutzt werden, die zu einer anderen Client-Datenmenge gehören. Source bezeichnet eine andere Client-Datenmenge, deren Daten gemeinsam genutzt werden sollen.

Reset und KeepSettings bestimmen, wie die Werte der folgenden Eigenschaften zugewiesen werden:

Filter, Filtered, FilterOptions und OnFilterRecord

IndexName

MasterSource und MasterFields

ReadOnly

RemoteServer und ProviderName

Sind Reset und KeepSettings false, werden den oben aufgeführten Eigenschaften die entsprechenden Werte der Quelldatenmenge zugewiesen.

Ist Reset true, werden die aufgeführten Eigenschaften gelöscht.

Ist Reset false und KeepSettings true, werden die oben aufgeführten Eigenschaften nicht geändert. In diesem Fall muss die Anwendung sicherstellen, dass vorhandene Indizes, Provider usw. mit den replizierten Daten kompatibel sind.

Nach dem Aufruf von CloCloneCursorneCursor sind die Daten in der Client-Datenmenge mit den Daten in Source identisch. Bearbeitungen in einer der Datenmengen werden in die Daten beider Datenmengen übernommen.

Anmerkung:  Da der kopierte Cursor gemeinsam genutzt wird, wirken sich Eigenschaftsänderungen, die den Cursor betreffen, auf beide Datenmengen aus. Wenn Sie beispielsweise die Eigenschaft ReadOnly einer Komponente auf true setzen, sind beide Datenmengen schreibgeschützt.

Siehe auch

Codebeispiele