PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE


  • Modification du type de blocage sur un fichier de données
  • Influence du mode de blocage
  • Échec du blocage
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Autres
Procédures stockées
Bloque un fichier de données et restreint l'accès à ce fichier de données pour tous les autres sites ou applications. Le fichier de données pourra ensuite être débloqué grâce à la fonction HDébloqueFichier.
Après l'exécution de la fonction HBloqueFichier, plusieurs cas peuvent se présenter :
  • Un enregistrement du fichier de données est déjà bloqué par une autre application : le blocage ne peut pas être effectué.
  • Le fichier de données est déjà bloqué par une autre application : le blocage ne peut pas être effectué.
Lors d'un problème de blocage, la fonction HErreurBlocage renvoie Vrai.
AndroidWidget AndroidWindows MobileJava Cette fonction peut être utilisée avec des fichiers de données HFSQL Client/Serveur.
Versions 17 et supérieures
iPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
Nouveauté 17
iPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
iPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
Versions 18 et supérieures
Universal Windows 10 App Cette fonction est désormais disponible en mode Windows Store apps.
Nouveauté 18
Universal Windows 10 App Cette fonction est désormais disponible en mode Windows Store apps.
Universal Windows 10 App Cette fonction est désormais disponible en mode Windows Store apps.
Remarque : A partir de la version 19, HFSQL est le nouveau nom de HyperFileSQL.
Versions 19 et supérieures
Android Cette fonction est désormais disponible pour les applications Android.
Widget Android Cette fonction est désormais disponible en mode Widget Android.
Java Cette fonction est désormais disponible pour les applications Java.
Nouveauté 19
Android Cette fonction est désormais disponible pour les applications Android.
Widget Android Cette fonction est désormais disponible en mode Widget Android.
Java Cette fonction est désormais disponible pour les applications Java.
Android Cette fonction est désormais disponible pour les applications Android.
Widget Android Cette fonction est désormais disponible en mode Widget Android.
Java Cette fonction est désormais disponible pour les applications Java.
Versions 21 et supérieures
Universal Windows 10 App Cette fonction est désormais disponible en mode Universal Windows 10 App.
Nouveauté 21
Universal Windows 10 App Cette fonction est désormais disponible en mode Universal Windows 10 App.
Universal Windows 10 App Cette fonction est désormais disponible en mode Universal Windows 10 App.
Exemple
// Blocage du fichier CLIENT
SI HBloqueFichier(CLIENT, hBlocageLectureEcriture) = Faux ALORS
SI HErreurBlocage() = Vrai ALORS
Erreur("Opération impossible")
FIN
FIN
// Traitement sur le fichier ...
...
// Redonner l'accès au fichier
HDébloqueFichier()
Syntaxe
<Résultat> = HBloqueFichier([<Nom du fichier> [, <Blocage>]])
<Résultat> : Booléen
  • Vrai si le blocage a été réalisé,
  • Faux en cas de problème (par exemple le fichier est déjà bloqué, ...). La fonction HErreur permet d'identifier l'erreur.
<Nom du fichier> : Chaîne de caractères optionnelle (avec ou sans guillemets)
Nom du fichier de données manipulé. Si ce nom n'est pas spécifié, la fonction HBloqueFichier va manipuler le dernier fichier de données utilisé par la dernière fonction de gestion HFSQL (fonction commençant par la lettre H).
<Blocage> : Constante optionnelle de type entier
Permet de déterminer le type de blocage effectué sur le fichier de données :
hBlocageEcriture
(valeur par défaut)
Blocage en écriture : les enregistrements du fichier de données pourront être lus par une autre application mais ne pourront pas être modifiés par une autre application. Aucun blocage sur le fichier de données ne pourra être défini par une autre application.
hBlocageLectureEcritureBlocage en lecture/écriture : les enregistrements du fichier de données ne pourront ni être lus ni être modifiés par une autre application. Aucun blocage sur le fichier de données ne pourra être défini par une autre application.
hBlocageNonAucun effet

Hyper File 5.5 Le paramètre <Blocage> n'est pas pris en compte.
Windows Mobile La gestion des blocages est réalisée uniquement sur les fichiers de données HFSQL Client/Serveur ou manipulés par un accès natif. Il n'est pas possible de bloquer un enregistrement HFSQL Mobile. En effet, le système d'exploitation du Pocket PC ne permet pas de bloquer des enregistrements.
AndroidWidget AndroidJava La gestion des blocages est réalisée uniquement sur les fichiers de données HFSQL Client/Serveur.
Remarques

Modification du type de blocage sur un fichier de données

Pour modifier le type de blocage d'un fichier de données, appelez la fonction HBloqueFichier avec le type de blocage souhaité. Il n'est pas nécessaire de débloquer le fichier de données au préalable.

Influence du mode de blocage

Si le fichier de données est en mode de blocage hModeMono (voir la fonction HMode), la fonction HBloqueFichier n'a aucun effet.

Échec du blocage

Si le fichier de données (ou un de ses enregistrements) est déjà bloqué, la demande de blocage est répétée H.NbEssais fois (50 par défaut).
Si au bout des H.NbEssais tentatives le fichier de données ne peut être bloqué, la fonction HErreurBlocage renvoie Vrai.
Composante : wd240hf.dll
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire