DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Gestion des bases de données / HFSQL / Fonctions HFSQL
  • Substitutions de répertoire multiples
  • Substitution de répertoire
  • Divers
WINDEV
WindowsLinuxJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget IOSApple WatchMac Catalyst
Autres
Procédures stockées
HSubstRep (Fonction)
En anglais : HSubstDir
OLE DBHFSQL ClassicDisponible uniquement avec ces types de connexion
Associe le répertoire des données spécifié dans le schéma des données à un répertoire présent sur le disque. Après l'exécution de la fonction HSubstRep, toutes les tables associées au répertoire spécifié dans le schéma des données seront manipulées dans le répertoire indiqué.
Attention: Les tables doivent être préalablement fermées (fonction HFerme).
Pour modifier le chemin d'une seule table, utilisez la fonction HChangeRep.
Remarque: En mode Client/Serveur, utilisez la fonction HChangeRep.
WEBDEV - Code ServeurAjaxHFSQL ClassicHyper File 5.5OLE DB
// Changement de répertoire pour les fichiers définis dans
// un répertoire spécifique dans le schéma des données
HSubstRep("C:\Fichier", "D:\Fichier")
// Ouverture/création des fichiers dans le nouveau répertoire
HCréeSiInexistant("*")
WEBDEV - Code ServeurAjaxHFSQL Classic
SI HSubstRep(".","C:\COMPTA\ANNEE2012") = Vrai ALORS
	Info("Vous allez travailler sur les fichiers présents dans le répertoire: C:\COMPTA\ANNEE2012")
SINON
	Erreur(HErreur)
FIN
Syntaxe
<Résultat> = HSubstRep(<Répertoire des fichiers spécifié dans le schéma des données> , <Répertoire physique des fichiers sur le disque>)
<Résultat> : Booléen
Ce paramètre est toujours égal à Vrai. En cas d'erreur, la prochaine fonction d'accès à la table utilisée renverra Faux. Par exemple, si le répertoire physique indiqué n'existe pas, une erreur de répertoire apparaîtra lors du premier accès à la table.
<Répertoire des fichiers spécifié dans le schéma des données> : Chaîne de caractères
Nom du répertoire donné lors de la description de la table.
WEBDEV - Code Serveur Si ce paramètre est égal à "?" ou ".", le répertoire courant de l'application est pris en compte (répertoire retourné par la fonction fRepEnCours).
<Répertoire physique des fichiers sur le disque> : Chaîne de caractères
Nouveau nom du répertoire (260 caractères maximum). Un chemin de type UNC peut être utilisé.
Si le répertoire spécifié contient des tables non HFSQL, la fonction HSubstRep est ignorée.
WEBDEV - Code Serveur Si ce paramètre correspond à:
  • une chaîne vide (""): la substitution est annulée: le répertoire des données décrit dans le schéma des données est pris en compte.
  • "?" ou ".": le répertoire physique des données correspond au répertoire en cours.
Remarques

Substitutions de répertoire multiples

La fonction HSubstRep peut être appelée plusieurs fois avec des paramètres différents. Lorsque le répertoire physique est redéfini plusieurs fois pour un même répertoire logique (décrit dans le schéma des données), le dernier répertoire physique spécifié remplace tous les autres.

Substitution de répertoire

La fonction HChangeRep permet d'associer un répertoire à une table. Pour substituer un répertoire par un autre, utilisez la fonction HSubstRep.
Attention: la substitution de répertoire effectuée par HSubstRep s'applique sur le répertoire définit par la fonction HChangeRep. Par exemple:
HSubstRep("C:\Statistiques\Janvier", "C:\Nouveau\StatJanv")
HChangeRep(Stat, "C:\Statistiques\Janvier")
HCrée(Stat) //Fichier créé sous C:\Nouveau\StatJanv

Divers

  • Si la gestion du ".REP" est branchée (fonction HGèreRep), la modification du chemin est enregistrée dans le fichier ".REP" (voir gestion du .REP).
  • La fermeture de la table conserve le nouveau chemin.
  • Le nombre de substitutions est illimité.
Classification Métier / UI: Code métier
Composante: wd300hf.dll
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 27/03/2025

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