Datasnap.DBClient.TCustomClientDataSet.SavePoint

Übergeordnet: TCustomClientDataSet

Delphi

property SavePoint: Int64 read GetSavePoint write SetSavePoint;

C++

__property __int64 SavePoint = {read=GetSavePoint, write=SetSavePoint};

Eigenschaften

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

Beschreibung

Gibt beim Protokollieren von Änderungen den aktuellen Status der Bearbeitungen an.

Mit SavePoint können Sie einen Bearbeitungsstatus speichern und später wiederherstellen. SavePoint ist ein Integer, der den aktuellen Status des Änderungsprotokolls angibt. Sollen die Änderungen im Änderungsprotokoll mit SavePoint auf einen früheren Status zurückgesetzt werden, weisen Sie SavePoint wieder den Wert zu, der galt, bevor die zurückzusetzenden Änderungen vorgenommen wurden.

Befindet sich die Client-Datenmenge also in einem Status, der gegebenenfalls später wiederhergestellt werden soll, weisen Sie SavePoint einer Variablen zu:

BeforeChanges := ClientDataSet1.SavePoint;

BeforeChanges = ClientDataSet->SavePoint;

Später können Sie die seit diesem Zeitpunkt vorgenommenen Änderungen zurücksetzen, indem Sie die Variable SavePoint zuweisen:

ClientDataSet1.SavePoint := BeforeChanges;

ClientDataSet->SavePoint = BeforeChanges;

Warnung: Client-Datenmengen können nicht auf einen SavePoint-Status zurückgesetzt werden, nachdem das Änderungsprotokoll auf einen früheren Status zurückgesetzt wurde. Dies gilt auch für das Rückgängigmachen von Änderungen, indem SavePoint ein zuvor gespeicherter Wert zugewiesen wird, das Zurücksetzen zu vieler Änderungen mit der Methode RevertRecord und das Löschen des Änderungsprotokolls mit CancelUpdates. Wird SavePoint ein Status zugewiesen, der nicht mehr im Änderungsprotokoll verfügbar ist, führt dies zu einer Exception.