PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE


  • Paramétrage de la connexion
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
Redéfinit un ou plusieurs paramètres d'une connexion par un accès 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 re-dé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.
Remarque : A partir de la version 19, HFSQL est le nouveau nom de HyperFileSQL.
WINDEVWEBDEV - Code ServeurEtats et RequêtesAjaxCode Utilisateur (MCU)HFSQLHFSQL Client/ServeurOLE DBAccès Natifs
HConnecte("Salaires", "", "", ...
"C:\Mes Documents\MaBase.mdb", "Microsoft.JET.OLEDB.4.0", hOLectureEcriture)
Windows Mobile
HConnecte("Salaires", "", "", "MaBase", "Microsoft.JET.OLEDB.4.0", hOLectureEcriture)
Syntaxe
<Résultat> = HConnecte(<Nom de la table> [, <Nom de l'utilisateur> [, <Mot de passe> [, <Base de données> [, <Serveur OLE DB ou Accès 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 (avec guillemets)
Nom de la table à 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 l'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 accès natifs définis dans l'analyse sont ré-initialisés avec les paramètres par défaut définis dans l'analyse.
<Nom de l'utilisateur> : Chaîne de caractères optionnelle (avec guillemets)
Nom de l'utilisateur utilisé pour l'ouverture du fichier de données.
<Mot de passe> : Chaîne de caractères optionnelle (avec guillemets)
Mot de passe de la connexion (si ce mot de passe existe).
<Base de données> : Chaîne de caractères optionnelle (avec guillemets)
Chemin complet de la source de données.
Windows Mobile Nom de la base de données SQL Server CE ou Oracle Lite, définie sur le Pocket PC.
<Serveur OLE DB ou Accès 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èsHFClientServeurAccès Natif à une base HFSQL Client/Serveur
hAccèsNatifAS400Accès Natif AS/400 (module optionnel de WINDEV/WEBDEV)
hAccèsNatifDB2Accès Natif DB2 (module optionnel de WINDEV/WEBDEV)
hAccèsNatifInformixAccès Natif Informix (module optionnel de WINDEV/WEBDEV)
Versions 20 et supérieures
hAccèsNatifMariaDB
Nouveauté 20
hAccèsNatifMariaDB
hAccèsNatifMariaDB
Accès Natif MariaDB (module optionnel de WINDEV/WEBDEV)
hAccèsNatifMySQLAccès Natif MySQL (module optionnel de WINDEV/WEBDEV)
hAccèsNatifOracleAccès Natif Oracle (module optionnel de WINDEV/WEBDEV)
hAccèsNatifOracleLiteAccès Natif Oracle (module optionnel de WINDEV Mobile)
hAccèsNatifPostgreSQL Accès Natif PostgreSQL (module optionnel de WINDEV/WEBDEV)
hAccèsNatifProgressAccès Natif Progress (module optionnel de WINDEV/WEBDEV)
Versions 16 et supérieures
hAccèsNatifSQLAzure
Nouveauté 16
hAccèsNatifSQLAzure
hAccèsNatifSQLAzure
Accès Natif SQL Azure (module optionnel de WINDEV/WEBDEV, fourni avec l'Accès Natif SQL Server)
Versions 15 et supérieures
hAccèsNatifSQLite
Nouveauté 15
hAccèsNatifSQLite
hAccèsNatifSQLite
Accès Natif à une base SQLite (fourni en standard avec WINDEV/WEBDEV)
hAccèsNatifSQLServerAccès Natif SQL Server (module optionnel de WINDEV/WEBDEV)
hAccèsNatifSQLServerMobileAccès Natif SQL Serveur (module optionnel de WINDEV Mobile)
hAccèsNatifSybaseAccès Natif Sybase (module optionnel de WINDEV/WEBDEV)
hAccèsNatifXBaseAccès Natif xBase (fourni en standard avec WINDEV/WEBDEV)
hAccèsNatifXMLAccès 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
Versions 19 et supérieures
hOledbAccess2010
Nouveauté 19
hOledbAccess2010
hOledbAccess2010
Provider OLE DB pour Access 2010
hOledbDBase5Provider OLE DB pour DBase 5
hOledbExcel2007Provider OLE DB pour Excel 2007
hOledbExcel2000Provider OLE DB pour Excel 2000
hOledbExcel97Provider OLE DB pour Excel 97
hOledbLotus4Provider OLE DB pour Lotus 4
hOledbOracleProvider OLE DB pour Oracle
hOledbSQLServerProvider OLE DB pour SQL Server
Windows Mobile Les constantes disponibles sont les suivantes :
hAccèsHF7Pseudo - connexion à une base HFSQL Mobile
hAccèsNatifOracleAccès Natif Oracle Lite (module optionnel)
hAccèsNatifSQLServerAccès Natif SQL Server CE (module optionnel)
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.
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.
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.
<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
Informations sur la base de données. Ces informations peuvent varier en fonction de l'accès natif utilisé.
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"
Accès Natifs MySQL : "initial catalog = dbo"
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 re-dé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 re-dé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 d'Accès Natif définies dans l'analyse. Dans ce cas, seuls les paramètres <Nom 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.
Composante : wd240hf.dll
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire