DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Gestion des bases de données / HFSQL / Fonctions HFSQL
  • Gestion du mot de passe
  • Création ou ouverture d'un fichier de données
  • Ouverture d'un fichier de données déjà ouvert
  • Gestion de la liste des fichiers de données manipulées (.REP)
  • Gestion des erreurs fatales
  • Ouverture d'une connexion et de la table spécifiée
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
Ouvre un fichier de données.
Remarque : L'ouverture des fichiers de données est automatiquement gérée. Cependant, dans certains cas, il est nécessaire d'ouvrir explicitement un fichier de données (par exemple pour tester l'existence du fichier de données ou la validité du mot de passe).
Exemple
// Ouvre le fichier de données Client
Client.Ouvre()
// Test du compte-rendu de la fonction <source>.Ouvre
SI Client.Ouvre("ABCD", hOLecture) = Faux ALORS
Erreur("Impossible d'ouvrir le fichier de données Client" + HErreurInfo())
FIN
Syntaxe
<Résultat> = <Source>.Ouvre([<Mot de passe> [, <Mode d'accès>]])
<Résultat> : Booléen
  • Vrai si le fichier de données a été ouvert.
  • Faux en cas de problème (mot de passe incorrect, ...). La fonction HErreur permet d'identifier l'erreur. La fonction HErreurInfo permet d'obtenir plus de détails.
<Source> : Type correspondant à la source spécifiée
Nom du fichier de données manipulé (nom logique, défini dans l'analyse).
<Mot de passe> : Chaîne de caractères optionnelle
Mot de passe du fichier de données.
Si aucun mot de passe n'est associé au fichier de données, il est possible d'utiliser une chaîne vide ("").
<Mode d'accès> : Constante de type entier optionnelle
Paramètre le mode d'accès au fichier de données.
Si ce paramètre n'est pas spécifié, le fichier de données sera ouvert selon ses caractéristiques (si le fichier de données est en lecture seule, il sera ouvert en lecture; si le fichier de données est en lecture/écriture, il sera ouvert en mode lecture/écriture).
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.
HOLectureEcritureLe 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.

Hyper File 5.5 Ce paramètre n'est pas pris en compte.
Remarques

Gestion du mot de passe

Le mot de passe peut être précisé :
  • soit directement à l'ouverture du fichier de données avec la fonction <Source>.Ouvre,
  • soit avant l'ouverture du fichier de données grâce à la fonction <Source>.MotDePasse.

Création ou ouverture d'un fichier de données

La fonction <Source>.CréationSiInexistant peut remplacer la fonction <Source>.Ouvre. En effet, si le fichier de données existe, il est automatiquement ouvert.

Ouverture d'un fichier de données déjà ouvert

Si la fonction <Source>.Ouvre est utilisée sur un fichier de données déjà ouvert avec un <Mode d'accès> différent, les filtres, les blocages et les caractéristiques du parcours en cours sont perdus.

Gestion de la liste des fichiers de données manipulées (.REP)

WINDEV Mobile permet de mettre à jour une liste des fichiers de données manipulés par l'application (équivalent au fichier .REP sous WINDEV standard).
La fonction <Source>.Ouvre renseigne la liste des fichiers de données manipulés par l'application (.REP pour WINDEV et WEBDEV) si la mise à jour de cette liste est activée.

Gestion des erreurs fatales

En cas d'erreur fatale lors de l'ouverture d'un fichier de données, il peut être intéressant de continuer le programme en traitant l'erreur rencontrée. Pour cela, il est conseillé de faire le traitement d'exception suivant :
QUAND EXCEPTION DANS
Père.Ouvre()
FAIRE
Erreur("Erreur HFSQL : " + HErreur())
SINON
Trace("Fichier ouvert")
FIN
Etats et RequêtesOLE DBConnecteurs Natifs (Accès Natifs)

Ouverture d'une connexion et de la table spécifiée

La fonction <Source>.Ouvre ouvre si nécessaire la connexion sur la base de données avant d'ouvrir la table spécifiée. Si la connexion est déjà ouverte (avec les mêmes paramètres), cette connexion est automatiquement utilisée.
Remarque : La connexion utilisée par défaut correspond à la connexion associée à la table sous l'éditeur d'analyses.
Composante : wd290hf.dll
Version minimum requise
  • Version 25
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 20/06/2023

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