DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Gestion des bases de données / HFSQL / Fonctions HFSQL
  • Conditions d'utilisation de <Source>.AnnuleDéclaration
  • Fonction <Source>.AnnuleDé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/iPadWidget IOSApple WatchMac CatalystUniversal Windows 10 App
Autres
Procédures stockées
Permet de :
Exemple
// Le fichier de données Client a été précédemment déclaré dans l'analyse 
// par la fonction HDéclareExterne
Client.Ferme()
Client.AnnuleDéclaration()
Syntaxe
<Résultat> = <Source>.AnnuleDéclaration()
<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.
<Source> : Type correspondant à la source spécifiée
Correspond :
  • au nom du fichier de données (défini dans l'analyse). Si ce nom n'est pas spécifié, la fonction <Source>.AnnuleDé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 <Source>.ExécuteRequête ou <Source>.ExécuteRequêteSQL).
Remarques

Conditions d'utilisation de <Source>.AnnuleDé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 <Source>.AnnuleDéclaration est utilisée trop tôt : le contenu du champ Table sera complètement faussé. En effet, le remplissage du champ Table par la fonction ConstruitTableFichier se produit dans un processus parallèle en arrière-plan. Donc la fonction <Source>.AnnuleDéclaration va intervenir bien avant la fin du remplissage du champ Table, ce qui rend ce champ 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 ou un événement (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".

Fonction <Source>.AnnuleDéclaration et fermeture du fichier de données

Pour utiliser la fonction <Source>.AnnuleDé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 <Source>.AnnuleDéclaration ne pourra pas être exécutée même après un appel à la fonction <Source>.Ferme. Il faudra auparavant libérer les requêtes ou vues qui utilisent le fichier de données.
Composante : wd300hf.dll
Version minimum requise
  • Version 25
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 25/06/2024

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