PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE


Nouveauté WINDEV, WEBDEV, WINDEV Mobile 25 !
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget iOSApple WatchCatalystUniversal Windows 10 AppWindows Mobile
Autres
Procédures stockées
<Source>.PrépareRequête (Fonction)
En anglais : <Source>.PrepareQuery
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 <Fichier HFSQL>.Exé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 <Source>.AnnuleDé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 <Source>.Pré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
REQ_MaReq.PrépareRequête(MaConnexion, hRequêteSansCorrection)
 
POUR i = 1 À 10
REQ_MaReq.nom = "Nom" + i
REQ_MaReq.prenom = "Prenom" + i
REQ_MaReq.age_ = i
REQ_MaReq.ExécuteRequête()
FIN
Syntaxe
<Résultat> = <Source>.PrépareRequê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é.
<Source> : Type correspondant à la source spécifiée
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)
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 : wd250hf.dll
Version minimum requise
  • Version 25
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire