Modifie le mode de recherche des fichiers de données physiques (.FIC, .NDX, ...). Par défaut, les fichiers de données physiques sont recherchés dans la bibliothèque de l'application puis sur le disque.
Rappel : Les fichiers de données physiques peuvent se trouver :
- sur le disque (cas le plus courant).
- dans des bibliothèques WINDEV (fichiers WDL).
- dans l'exécutable.
- dans un composant.
Versions 17 et supérieures
Nouveauté 17Remarque : A partir de la version 19, HFSQL est le nouveau nom de HyperFileSQL.
Versions 22 et supérieures Nouveauté 22
// Recherche des fichiers dans les bibliothèques 4, 6 et 9
HChangeLocalisation(FichierClient, hWDL, 4, 6, 9)
Syntaxe
<Résultat> = HChangeLocalisation(<Nom du fichier> , <Mode de recherche> [, <Paramètres>])
<Résultat> : Booléen
- Vrai si l'opération a été réalisée,
- Faux en cas de problème. La fonction HErreur permet d'identifier l'erreur.
<Nom du fichier> : Chaîne de caractères (avec ou sans guillemets)
Nom logique du fichier de données (défini dans l'analyse).
Si ce paramètre est égal à "*", le changement de mode de recherche des fichiers sera appliqué pour tous les fichiers de données connus (décrits dans l'analyse).
Attention : les fichiers de données concernés sont automatiquement fermés.
Ce paramètre peut également correspondre au nom d'un groupe de fichiers (ou perso-dossier) défini dans l'analyse.
<Mode de recherche> : Constante
Paramètre le mode de recherche des fichiers de données : | |
| hDisque | Les fichiers de données sont recherchés uniquement sur le disque. C'est le cas le plus courant. |
hWDL
(Valeur par défaut) | Les fichiers de données sont recherchés :- Dans la WDL principale;
- Si <Paramètres> n'est pas précisé : Recherche les fichiers de données dans les WDL suivant leur ordre de chargement, puis sur le disque.
Si <Paramètres> est spécifié : Recherche les fichiers de données dans la ou les WDL spécifiées, puis sur le disque. - Dans la WDL principale du composant.
- Dans les WDL secondaires du composant selon leur ordre de chargement.
|
<Paramètres> : Chaîne de caractères optionnelle (avec guillemets)
Identifiant de la ou des WDL où la recherche doit être effectuée. Ces WDL doivent être chargées grâce à la fonction ChargeWDL qui renvoie l'identifiant de la WDL.
Remarques
Pourquoi mettre les fichiers de données dans une bibliothèque ?
Placer les fichiers de données dans une bibliothèque présente les avantages suivants :
- protection des données : les fichiers de données sont accessibles en lecture uniquement.
- regroupement des données : tous les fichiers nécessaires à l'exécution sont regroupés dans un seul fichier.