PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE


  • Conditions d'utilisation de HAnnuleDéclaration
  • La fonction HAnnuleDéclaration et fermeture du fichier de données
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
Permet de :
Versions 15 et supérieures
Android Cette fonction est désormais disponible pour les applications Android.
Nouveauté 15
Android Cette fonction est désormais disponible pour les applications Android.
Android Cette fonction est désormais disponible pour les applications Android.
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
Widget Android Cette fonction est désormais disponible en mode Widget Android.
Universal Windows 10 App Cette fonction est désormais disponible en mode Windows Store apps.
Nouveauté 18
Widget Android Cette fonction est désormais disponible en mode Widget Android.
Universal Windows 10 App Cette fonction est désormais disponible en mode Windows Store apps.
Widget Android Cette fonction est désormais disponible en mode Widget Android.
Universal Windows 10 App Cette fonction est désormais disponible en mode Windows Store apps.
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.
Remarque : A partir de la version 19, HFSQL est le nouveau nom de HyperFileSQL.
// Le fichier Client a été précédemment déclaré dans l'analyse
// par la fonction HDéclareExterne
HFerme(Client)
HAnnuleDéclaration(Client)
Syntaxe
<Résultat> = HAnnuleDéclaration([<Nom du fichier>])
<Résultat> : Booléen
  • Vrai si l'opération a été réalisée,
  • Faux en cas de problème. La fonction HErreur permet d'identifier l'erreur.
<Nom du fichier> : Chaîne de caractères optionnelle (avec ou sans guillemets)
Correspond :
  • au nom du fichier de données (défini dans l'analyse). Si ce nom n'est pas spécifié, la fonction HAnnuleDéclaration se réfère au dernier fichier de données utilisé.
  • au nom d'une requête ou d'une source de données associée à une requête (cas d'une libération de ressources suite à l'utilisation des fonctions HExécuteRequête ou HExécuteRequêteSQL).
Remarques

Conditions d'utilisation de HAnnuleDéclaration

Cette fonction ne doit être utilisée QUE lorsque vous n'avez plus besoin du fichier de données (ou de la requête) concerné !
Dans l'exemple suivant, la fonction HAnnuleDéclaration est utilisée trop tôt : la table sera complètement faussée. En effet, le remplissage de la table par la fonction ConstruitTableFichier se produit dans un processus parallèle en arrière plan. Donc la fonction HAnnuleDéclaration va intervenir bien avant la fin du remplissage de la table, ce qui rend cette table inutilisable.
HExécuteRequêteSQL("test", "select * from client")
ConstruitTableFichier(TABLE_Table1, "test")
HAnnuleDéclaration("test")
Remarque : Le problème peut aussi se produire avec une variable de type "source de données". Une variable "source de données" déclarée localement dans un traitement (clic de bouton, procédure, méthode ...) n'existe QUE durant l'exécution de ce code. Pour cette raison un "warning" est affiché si vous utilisez ce type de source de données : "la source de données sera détruite à la fin de ce code".

La fonction HAnnuleDéclaration et fermeture du fichier de données

Pour utiliser la fonction HAnnuleDéclaration sur un fichier de données, ce fichier de données doit être fermé.
Si une requête, une sous-requête ou une vue utilise le fichier de données, la fonction HAnnuleDéclaration ne pourra pas être exécutée même après un appel à la fonction HFerme. Il faudra auparavant libérer les requêtes ou vues qui utilisent le fichier de données.
Composante : wd240hf.dll
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire