PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE


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
HPrépareRequête (Fonction)
En anglais : HPrepareQuery
HFSQLHFSQL 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 Accès 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.
Remarque : A partir de la version 19, HFSQL est le nouveau nom de HyperFileSQL.
Exemple
HPrépareRequête(REQ_MaReq, MaConnexion, hRequêteSansCorrection)

POUR i = 1 A 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(<Nom de la 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é.
<Nom de la requête> : Chaîne de caractères (avec ou sans guillemets)
  • 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 (avec ou sans guillemets)
Nom d'une connexion, définie sous l'éditeur d'analyses ou dynamiquement avec la fonction HDécritConnexion. La requête sera exécutée via cette connexion.
<Mode> : Constante optionnelle de type Entier
Option pour l'initialisation de la requête :
hRequêteSansCorrection
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 : wd240hf.dll
Version minimum requise
  • Version 15
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire