DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Gestion des bases de données / HFSQL / Fonctions HFSQL
  • Paramétrage de la connexion
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
Redéfinit un ou plusieurs paramètres d'une connexion par un Connecteur Natif (Access, SQL Server, Oracle ou MySQL) ou par accès OLE DB sur une table spécifique ou sur un ensemble de tables. La ou les tables sont ensuite ouvertes (ou créées si elles n'existent pas). L'opération de test spécifiée est alors exécutée.
Remarques :
  • La nouvelle redéfinition de la connexion sera utilisée jusqu'à ce qu'elle soit annulée avec la fonction HConnecte. Elle sera automatiquement annulée à la fin de l'application.
  • Par défaut, les caractéristiques de la connexion sont définies sous l'éditeur d'analyses, pour une ou plusieurs tables.
Important
La fonction HConnecte permet de définir simplement une connexion sur une base de données. Il est conseillé d'utiliser la fonction HDécritConnexion puis la fonction HChangeConnexion pour :
  • gérer des paramètres avancés disponibles avec certaines bases de données (curseurs, transactions, ...),
  • manipuler une connexion nommée.
WINDEVWEBDEV - Code ServeurEtats et RequêtesCode Utilisateur (MCU)AjaxHFSQL ClassicHFSQL Client/ServeurOLE DBConnecteurs Natifs (Accès Natifs)
HConnecte("Salaires", "", "", ...
"C:\Mes Documents\MaBase.mdb", "Microsoft.JET.OLEDB.4.0", hOLectureEcriture)
Syntaxe
<Résultat> = HConnecte(<Nom de la table> [, <Utilisateur> [, <Mot de passe> [, <Base de données> [, <Serveur OLE DB ou Connecteur Natif> [, <Accès> [, <Opération de test> [, <Informations optionnelles>]]]]]]])
<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.
<Nom de la table> : Chaîne de caractères
Nom de la table (fichier de données) à ouvrir, et pour laquelle la connexion doit être redéfinie. Si aucun autre paramètre n'est précisé, le fichier de données est ré-initialisé avec les paramètres par défaut définis dans l'analyse.
  • Si ce paramètre est égal à "*", le changement s'appliquera à toutes les tables manipulées par le Connecteur Natif (également appelé Accès Natif). Dans ce cas, tous les paramètres de la connexion doivent être précisés.
  • Si ce paramètre est égal à "*" et que aucun autre paramètre n'est spécifié, tous les fichiers de données de tous les Connecteurs Natifs définis dans l'analyse sont ré-initialisés avec les paramètres par défaut définis dans l'analyse.
<Utilisateur> : Chaîne de caractères optionnelle
Nom de l'utilisateur utilisé pour l'ouverture du fichier de données.
<Mot de passe> : Chaîne de caractères optionnelle
Mot de passe de la connexion (si ce mot de passe existe).
<Base de données> : Chaîne de caractères optionnelle
Chemin complet de la source de données.
<Serveur OLE DB ou Connecteur Natif> : Chaîne de caractères ou constante optionnelle
Nom du provider OLE DB utilisé ou une des constantes suivantes :
hAccèsHF7Pseudo-connexion à une base HFSQL Classic
hAccèsHFClientServeurConnecteur Natif à une base HFSQL Client/Serveur
hAccèsNatifAS400Connecteur Natif AS/400 (module optionnel de WINDEV/WEBDEV)
hAccèsNatifDB2Connecteur Natif DB2 (module optionnel de WINDEV/WEBDEV)
hAccèsNatifInformixConnecteur Natif Informix (module optionnel de WINDEV/WEBDEV)
hAccèsNatifMariaDBConnecteur Natif MariaDB (module optionnel de WINDEV/WEBDEV)
hAccèsNatifMySQLConnecteur Natif MySQL (module optionnel de WINDEV/WEBDEV)
hAccèsNatifOracleConnecteur Natif Oracle (module optionnel de WINDEV/WEBDEV)
hAccèsNatifOracleLiteConnecteur Natif Oracle (module optionnel de WINDEV Mobile)
hAccèsNatifPostgreSQLConnecteur Natif PostgreSQL (module optionnel de WINDEV/WEBDEV)
hAccèsNatifProgressConnecteur Natif Progress (module optionnel de WINDEV/WEBDEV)
hAccèsNatifSQLAzureConnecteur Natif SQL Azure (module optionnel de WINDEV/WEBDEV, fourni avec le Connecteur Natif SQL Server)
hAccèsNatifSQLiteConnecteur Natif à une base SQLite (fourni en standard avec WINDEV/WEBDEV)
hAccèsNatifSQLServerConnecteur Natif SQL Server (module optionnel de WINDEV/WEBDEV)
hAccèsNatifSQLServerMobileConnecteur Natif SQL Server (module optionnel de WINDEV Mobile)
hAccèsNatifSybaseConnecteur Natif Sybase (module optionnel de WINDEV/WEBDEV)
hAccèsNatifXBaseConnecteur Natif xBase (fourni en standard avec WINDEV/WEBDEV)
hAccèsNatifXMLConnecteur Natif XML (fourni en standard avec WINDEV/WEBDEV)
hODBCProvider OLE DB pour ODBC (permet d'accéder à une source de données ODBC déclarée dans les sources de données ODBC de Windows)
hOledbAccess97Provider OLE DB pour Access 97
hOledbAccess2000Provider OLE DB pour Access 2000
hOledbAccess2007Provider OLE DB pour Access 2007
hOledbAccess2010Provider OLE DB pour Access 2010
hOledbDBase5Provider OLE DB pour DBase 5
hOledbExcel97Provider OLE DB pour Excel 97
hOledbExcel2000Provider OLE DB pour Excel 2000
hOledbExcel2007Provider OLE DB pour Excel 2007
hOledbLotus4Provider OLE DB pour Lotus 4
hOledbOracleProvider OLE DB pour Oracle
hOledbSQLServerProvider OLE DB pour SQL Server
OLE DB Attention : Pour utiliser une connexion OLE DB, il est nécessaire :
  • d'installer le MDAC version 2.6 minimum (installation réalisée avec WINDEV/WEBDEV et lors de la création du programme d'installation)
  • d'installer le provider OLE DB correspondant à la base de données manipulée.
    Ce paramètre peut être récupéré grâce à la propriété CxProviderOLEDB.
<Accès> : Constante optionnelle
Paramètre le type d'accès au fichier de données.
hOLectureLe fichier de données est accessible uniquement en lecture. Seule la lecture des enregistrements est possible. Il n'est pas possible d'en ajouter ou d'en supprimer.
hOLectureEcriture
(valeur par défaut)
Le fichier de données est accessible en lecture et en écriture. Il est possible aussi bien de lire des enregistrements que d'écrire de nouveaux enregistrements.
<Opération de test> : Constante optionnelle
Paramètre le type de l'opération à effectuer sur la base de données pour vérifier la connexion.
hHCréationSiInexistant
(Valeur par défaut)
Vérifie la connexion grâce à l'ouverture ou la création d'un fichier de données (si le fichier de données n'existe pas). Cette opération est possible uniquement en accès de type hOLectureEcriture.
hHOuvreVérifie la connexion grâce à une ouverture de fichier de données. Cette valeur est utilisée par défaut lors d'un accès à une base de type hOLecture.
<Informations optionnelles> : Chaîne de caractères optionnelle
Information insérée dans la chaîne de connexion à la base de données.
Par exemple, il est possible sur certaines sources de données de spécifier quelle base de données utiliser. Sur SQL Server, la base "Master" est la base par défaut, mais il est possible d'en utiliser d'autres, par exemple "dbo". Cette information est spécifiée dans le paramètre <Information optionnelle>, grâce à la syntaxe suivante :
OLE DB "initial catalog = dbo"
ODBC "database = dbo"
Connecteurs Natifs (Accès Natifs) MySQL : "initial catalog = dbo"
OLE DBConnecteurs Natifs (Accès Natifs) Les mots-clés reconnus par OLE DB et par les Connecteurs Natifs sont présentés dans la page Informations optionnelles de connexion.
Remarques

Paramétrage de la connexion

  • La description de la table doit être connue au moment de l'appel de la fonction HConnecte (la table doit avoir été décrite dans l'analyse, ou bien avec les fonctions HDéclare ou HDécritFichier).
  • La fonction HConnecte ouvre la connexion et la table. La table est créée si elle n'existe pas. La fonction HConnecte équivaut pour cela à la fonction HCréationSiInexistant.
  • Lors de la redéfinition de la connexion, seuls les paramètres spécifiés sont pris en compte. La valeur des paramètres non spécifiés avec la fonction HConnecte correspond à la valeur définie sous l'éditeur d'analyses.
  • Si seul le <Nom de la table> est spécifié, la fonction HConnecte annule la redéfinition de la connexion pour la ou les tables spécifiées. Les paramètres définis dans l'éditeur d'analyses seront pris en compte.
  • Lorsque le paramètre <Nom de la table> est égal à "*", le changement s'applique à toutes les tables des Connecteurs Natifs définies dans l'analyse. Dans ce cas, seuls les paramètres <Utilisateur>, <Mot de passe>, <Base de données> et <Accès> sont pris en compte.
  • Pour annuler un changement de connexion effectué sur toutes les tables, <Nom de la table> doit être égal à "*" et aucun autre paramètre ne doit être précisé.
  • Si la source de données est précisée, la fonction HConnecte ignore les éventuels HSubstRep/HChangeRep.
  • Si une table est ouverte lors de l'appel de la fonction HConnecte, la table est fermée puis ré-ouverte avec les nouveaux paramètres de connexion.
Classification Métier / UI : Code métier
Composante : wd290hf.dll
Version minimum requise
  • Version 9
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