Datasnap.DBClient.TCustomClientDataSet.FileName

Übergeordnet: TCustomClientDataSet

Delphi

property FileName: string read FFileName write SetFileName;

C++

__property System::UnicodeString FileName = {read=FFileName, write=SetFileName};

Eigenschaften

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

Beschreibung

Gibt eine Datei an, in der die Daten einer Client-Datenmenge gespeichert werden.

Weisen Sie FileName einen Wert zu, wenn die Client-Datenmenge die Daten immer aus einer bestimmten Datei liest bzw. in diese schreibt. Enthält FileName einen gültigen Dateinamen, schreibt die Client-Datenmenge ihre Daten automatisch in die betreffende Datei, wenn sie geschlossen wird. Gibt FileName den Namen einer existierenden Datei an, liest die Client-Datenmenge beim Öffnen ihre Daten automatisch aus dieser Datei.

Änderungen werden nicht mit den Daten zusammengeführt, wenn diese in der Datei gespeichert werden. Eine das Aktenkoffermodell nutzende Anwendung kann FileName also zuweisen, ohne dass Aktualisierungen verloren gehen, die für den Datenbankserver bestimmt sind. Einschichtige Anwendungen müssen Änderungen explizit zusammenführen, bevor die Datenmenge geschlossen wird und die Daten auf den Datenträger geschrieben werden.

Hinweis: Client-Datenmengen überschreiben den Inhalt der Datei. Die alten Daten gehen dadurch verloren.

Soll aus einer anderen Datei gelesen oder in eine andere Datei geschrieben werden, müssen Sie stattdessen die Methoden LoadFromFile und SaveToFile verwenden. Mit diesen Methoden können Daten auch geladen und gespeichert werden, wenn sich die Eigenschaft Active nicht ändert.