Datasnap.DBClient.TCustomClientDataSet.FileName

De RAD Studio API Documentation
Aller à : navigation, rechercher

Delphi

property FileName: string read FFileName write SetFileName;

C++

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

Propriétés

Type Visibilité  Source Unité  Parent
property public
Datasnap.DBClient.pas
Datasnap.DBClient.hpp
Datasnap.DBClient TCustomClientDataSet

Description

Spécifie un fichier contenant données de l'ensemble de données client.

Initialisez FileName si l'ensemble de données client lit et écrit toujours ses données dans un seul fichier. Si FileName représente un nom de fichier valide, l'ensemble de données client écrit automatiquement ses données dans le fichier à sa fermeture. Si FileName spécifie le nom d'un fichier existant, à son ouverture l'ensemble de données lit automatiquement ses données dans le fichier.

Les modifications ne sont pas fusionnées avec les données lorsqu'elles sont enregistrées dans le fichier. Ceci permet à une application employant le modèle "briefcase" de définir FileName sans perdre les mises à jour destinées à un serveur de base de données. Les applications mono-niveaux doivent explicitement fusionner les modifications avant de fermer l'ensemble de données et enregistrer les données sur disque.

Remarque :  Quand un ensemble de données client écrit ses données dans un fichier, elles écrasent le contenu du fichier. Le contenu antérieur du fichier est perdu.

Pour lire et écrire dans des fichiers différents, utilisez à la place les méthodes LoadFromFile et SaveToFile. Ces méthodes permettent également de charger et d'enregistrer des données à d'autres moments que la modification de la propriété Active.

Voir aussi