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
Change dynamiquement la connexion associée à un fichier de données. La nouvelle connexion doit être connue et définie lors de ce changement. Cette nouvelle connexion sera utilisée lors de la prochaine ouverture du fichier de données.
Il est ainsi possible d'importer une description de tables Oracle dans l'analyse et d'utiliser cette description pour travailler sur des fichiers de données au format HFSQL. Pour voir de nombreux exemples de changements de connexion, consultez les exemples détaillés.
Conseils :
Exemple
// Décrire la nouvelle connexion
HDécritConnexion ("MaConnexion", "", "", ...
"Serveur_SQLServer", "dbo", hOledbSQLServer, hOLectureEcriture, "")

// Ouvrir la nouvelle connexion
HOuvreConnexion("MaConnexion")

// Indiquer que "Salaires" utilise la nouvelle connexion
HChangeConnexion("Salaires", "MaConnexion")

// Commencer le parcours de la table "Salaires" sur SQLServer
HLitPremier("Salaires")
...
// Fermer la connexion
HFermeConnexion("MaConnexion")

// Rétablir l'utilisation de la connexion sur Oracle
HChangeConnexion("Salaires", "")

// Ouvrir la table "Salaires" sur Oracle
HOuvre("Salaires")
Syntaxe
<Résultat> = HChangeConnexion(<Fichier de données> , <Nouvelle connexion>)
<Résultat> : Booléen
  • Vrai si l'opération a été réalisée,
  • Faux en cas de problème. La fonction HErreurInfo permet d'identifier l'erreur.
<Fichier de données> : Chaîne de caractères
Nom du fichier de données (défini dans l'analyse) pour lequel la connexion doit être changée. Ce fichier de données sera automatiquement fermé pour modifier sa connexion.
Si ce paramètre vaut "*", le traitement est appliqué à tous les fichiers de données connus, quelle que soit leur origine (HFSQL, OLE DB, Connecteur Natif, ...).
Il est ainsi possible de transformer un fichier de données HFSQL en un fichier de données OLE DB par exemple.
Ce paramètre peut également correspondre au nom d'un groupe de fichiers (ou perso-dossier) défini dans l'analyse (non disponible en Android et Android Widget).
<Nouvelle connexion> : Chaîne de caractères ou variable de type Connexion
Nouvelle connexion à utiliser. Ce paramètre peut correspondre :
  • au nom de la connexion à une base de données. Cette connexion a été définie dans l'éditeur d'analyses ou décrite dynamiquement par la fonction HDécritConnexion. Si ce paramètre correspond à une chaîne vide (""), la connexion initiale est automatiquement utilisée.
  • au nom de la variable de type Connexion correspondant à la nouvelle connexion à utiliser.
Remarques
  • La connexion doit être connue au moment de l'exécution de la fonction HChangeConnexion. Si le fichier de données n'est pas connu lors de l'utilisation de la fonction HChangeConnexion, la connexion sera changée au moment de la déclaration du fichier de données.
  • La fonction HChangeConnexion réalise automatiquement la fermeture du fichier de données (fonction HFerme) dont la connexion doit être modifiée.
  • La fonction HChangeConnexion n'ouvre ni le fichier de données ni la connexion. La connexion définie par la fonction HChangeConnexion sera utilisée lors de la prochaine ouverture du fichier de données.
Liste des exemples associés :
WD OLEDB Exemples didactiques (WINDEV) : WD OLEDB
[ + ] Cet exemple illustre l'accès à une base de données via OLE DB avec les fonctions WLangage.
Dans cet exemple, nous abordons les deux thèmes suivants :
1/ l'indépendance de vos applications et de la base de données
2/ la connexion via OLE DB
Résumé de l'exemple livré avec WINDEV :
Cet exemple montre comment réaliser une application indépendante de la base de données utilisée.
La même application avec le même code source accède indifféremment à un fichier HFSQL ou à une base Access via OLE DB.
Sur le même principe, vos applications pourront accéder à toutes les bases de données du marché.
Composante : wd290hf.dll
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 03/02/2023

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