|
|
|
|
|
|
|
|
|
|
- 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
HOuvre (Fonction) En anglais : HOpen
 Non disponible avec ce type de connexion
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).
SI HOuvre(Client, "ABCD", hOLecture) = Faux ALORS
Erreur("Impossible d'ouvrir le fichier de données Client" + HErreurInfo())
FIN
Syntaxe
<Résultat> = HOuvre([<Fichier de données> [, <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.
<Fichier de données> : Chaîne de caractères optionnelle Nom du fichier de données manipulé (nom logique, défini dans l'analyse).
Si ce nom n'est pas spécifié, la fonction HOuvre va manipuler le dernier fichier de données utilisé par la dernière fonction de gestion HFSQL (fonction commençant par la lettre H).
Si ce paramètre correspond à "*", tous les fichiers de données décrits dans l'analyse sont ouverts. Si le mot de passe est précisé, ce mot de passe sera utilisé pour ouvrir tous les fichiers de données.
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). Si le mot de passe est précisé, ce mot de passe sera utilisé pour ouvrir tous les fichiers de données du groupe.
Attention : ce paramètre ne peut pas correspondre à une variable de type Description de fichier. <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). | | | HOLecture | Le 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 | 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. |
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 HOuvre,
- soit avant l'ouverture du fichier de données grâce à la fonction HPasse.
Création ou ouverture d'un fichier de données La fonction HCréationSiInexistant peut remplacer la fonction HOuvre. 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 HOuvre 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 HOuvre 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
HOuvre(PERE)
FAIRE
Erreur("Erreur HFSQL : " + HErreur())
SINON
Trace("Fichier ouvert")
FIN
Documentation également disponible pour…
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|