DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

PV

Aide / WLangage / Gestion des bases de données / HFSQL / Fonctions HFSQL
  • Gestion des blocages
  • Fonctions .Sécurité et <Source>.ForceEcriture
WINDEV
WindowsLinuxJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget IOSApple WatchMac Catalyst
Autres
Procédures stockées
<Source>.ForceEcriture (Fonction)
En anglais : <Source>.Flush
HFSQL ClassicHFSQL Client/ServeurDisponible uniquement avec ces types de connexion
Force le système d'exploitation du poste sur lequel les fichiers de données sont présents à écrire les données directement sur le disque. Le contexte HFSQL du fichier de données manipulé est conservé (blocage, parcours en cours, ...).
Remarque : Utilisée régulièrement, cette fonction permet de minimiser les pertes de données occasionnées par les arrêts inattendus du poste sur lequel les fichiers de données sont présents (coupure de courant par exemple).
Exemple
// 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()
Syntaxe
<Source>.ForceEcriture()
<Source> : Type correspondant à la source spécifiée
Nom du fichier de données manipulé.
Remarques
WEBDEV - Code ServeurAjaxHFSQL ClassicHFSQL Client/Serveur

Gestion des blocages

Lors de l'appel de la fonction <Source>.ForceEcriture, le fichier de données manipulé est fermé puis réouvert. Si des blocages étaient mis en place sur ce fichier de données avant sa fermeture, ces blocages sont rétablis automatiquement à sa réouverture. En effet, lors de la fermeture d'un fichier de données, le système d'exploitation supprime les blocages mis en place sur ce fichier de données.
Remarque : Il est donc déconseillé d'appeler cette fonction trop souvent sur :
  • des fichiers de données sur lesquels un grand nombre de blocages est mis en place.
  • des fichiers de données sur lesquels un grand nombre d'écritures est réalisé.

Fonctions <Source>.Sécurité et <Source>.ForceEcriture

Les fonctions <Source>.Sécurité et <Source>.ForceEcriture permettent toutes les deux de forcer l'écriture physique sur le disque.
Cependant :
  • La fonction <Source>.Sécurité permet de forcer l'écriture dans le ou les fichiers de données manipulés à chaque écriture. Cette écriture est automatiquement réalisée par le moteur HFSQL. Le ou les fichiers de données manipulés ne sont pas fermés lors de cette écriture. La vitesse d'écriture dans les fichiers de données est plus lente.
  • La fonction <Source>.ForceEcriture permet de forcer l'écriture dans le ou les fichiers de données manipulés uniquement lors de l'appel de cette fonction. Le ou les fichiers de données manipulés sont fermés puis ré-ouverts lors de cette écriture. La vitesse d'écriture dans les fichiers de données n'est pas ralentie.
Composante : wd300hf.dll
Version minimum requise
  • Version 25
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 20/06/2023

Signaler une erreur ou faire une suggestion | Aide en ligne locale