DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Gestion des bases de données / HFSQL / Fonctions HFSQL
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
HPrépareRequête (Fonction)
En anglais : HPrepareQuery
HFSQL ClassicHFSQL Client/ServeurNon disponible avec ces types de connexion
Initialise une requête et déclare cette requête au serveur de base de données pour optimiser les prochaines exécutions de cette requête. Cette requête n'est pas exécutée. La requête pourra ensuite être exécutée avec la fonction HExécuteRequête. Cette fonction peut aussi bien être utilisée avec requêtes avec ou sans bind.
Pour libérer les ressources de cette requête, utilisez la fonction HAnnuleDéclaration.
Cette fonction est conseillée lors de l'exécution successive d'une même requête en modifiant uniquement quelques paramètres de cette requête à chaque exécution.
Cette fonction est optionnelle et ne peut être utilisée que sur des bases de données Client/Serveur (actuellement disponible sur AS/400).
Pour les autres bases accédées par un Connecteur Natif, OLE DB ou ODBC, la fonction HPrépareRequêteSQL exécute la requête.
Sur les bases de données HFSQL (HFSQL Classic ou Client/Serveur) ou sur les bases xBase, cette fonction ne peut pas être utilisée.
Exemple
HPrépareRequête(REQ_MaReq, MaConnexion, hRequêteSansCorrection)
 
POUR i = 1 À 10
REQ_MaReq.nom = "Nom" + i
REQ_MaReq.prenom = "Prenom" + i
REQ_MaReq.age_ = i
HExécuteRequête(REQ_MaReq)
FIN
Syntaxe
<Résultat> = HPrépareRequête(<Requête> , <Connexion> [, <Mode>])
<Résultat> : Booléen
  • Vrai si l'initialisation de la requête a été effectuée,
  • Faux dans le cas contraire. La fonction HErreurInfo permet d'obtenir plus d'informations sur le problème rencontré.
<Requête> : Chaîne de caractères
  • Nom et chemin complet de la requête (fichier ".WDR") à initialiser.
  • Nom logique de la requête à initialiser.
Si une requête de même nom est déjà déclarée, elle est remplacée par la nouvelle requête.
<Connexion> : Chaîne de caractères ou variable de type Connexion
Connexion via laquelle la requête sera exécutée. Cette connexion correspond :
<Mode> : Constante optionnelle de type Entier
Option pour l'initialisation de la requête :
hRequêteSansCorrection
Connecteurs Natifs (Accès Natifs) Le moteur HFSQL n'effectue aucune vérification de la requête. Cette option doit être utilisée si la requête comporte des ordres spécifiques à un type de connexion (Oracle, SQL Server, ...).
Attention : si cette constante est utilisée :
Composante : wd290hf.dll
Version minimum requise
  • Version 15
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 25/05/2022

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