<Source>.Flush (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help / WLanguage / Managing databases / HFSQL / HFSQL functions

Managing locks
.Security and <Source>.Flush

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

<Source>.Flush (Function)

In french: <Source>.ForceEcriture

Available only with these kinds of connection

Forces the operating system of the computer where the data files are found to write data onto the disk. The HFSQL context of the manipulated data file is preserved (blocking, current path, etc.).

Remark: Used regularly, this function minimizes data loss caused by unexpected stoppages of the workstation on which the data files are stored (e.g. power failure).

Example

// Ajout d'un enregistrement dans un fichier de données
// (enregistrement décrit par programmation)
Client.Nom = "Moulin"
Client.Prenom = "François"
Client.Adresse = "Impasse de la belle"
Client.Ville = "Montpellier"
Client.CodeP = "34000"
Client.Pays = "France"
Client.Ajoute()
// Force l'écriture dans le fichier Client
Client.ForceEcriture()

Syntax

<Source>.Flush()

<Source>: Type corresponding to the specified source

Name of the data file used.

Remarks

Managing locks

During the call to <Source>.Flush, the data file used is closed and re-opened. If locks were implemented on this data file before it was closed, these locks are automatically restored when it is re-opened. Indeed, when closing a data file, the operating system deletes the locks implemented on this data file.

Remark: We therefore advise against calling this function too often on:

data files on which an important number of locks is implemented.
data files on which an important number of write operations is implemented.

<Source>.Security and <Source>.Flush

<Source>.Security and <Source>.Flush can both be used to force a physical write operation on disk.

However:

<Source>.Security is used to force a write operation into the data files used during each write operation. The HFSQL engine automatically performs the write operation. The data files are not closed during this write operation. This results in slower write speeds.
<Source>.Flush forces the data file(s) to be written when it is called. The data files are closed and then re-opened during this write operation. The write operation is not slowed down.

Component: wd300hf.dll