PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE


  • Substitutions de répertoire multiples
  • Substitution de répertoire
  • Divers
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
HSubstRep (Fonction)
En anglais : HSubstDir
OLE DBHFSQLDisponible uniquement avec ces types de connexion
Associe le répertoire des données spécifié dans l'analyse à un répertoire présent sur le disque. Après l'exécution de la fonction HSubstRep, tous les fichiers de données associés au répertoire spécifié dans l'analyse seront manipulés dans le répertoire indiqué.
Attention : Les fichiers de données doivent être préalablement fermés (fonction HFerme).
Pour modifier le chemin d'un seul fichier de données, utilisez la fonction HChangeRep.
Remarque : En mode Client/Serveur, utilisez la fonction HChangeRep.
Versions 17 et supérieures
iPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
Nouveauté 17
iPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
iPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
Versions 18 et supérieures
Universal Windows 10 App Cette fonction est désormais disponible en mode Windows Store apps.
Widget Android Cette fonction est désormais disponible en mode Widget Android.
Android Cette fonction est désormais disponible pour les applications Android (pour les fichiers de données HFSQL).
WINDEVJava Cette fonction est désormais disponible pour les applications Java.
Nouveauté 18
Universal Windows 10 App Cette fonction est désormais disponible en mode Windows Store apps.
Widget Android Cette fonction est désormais disponible en mode Widget Android.
Android Cette fonction est désormais disponible pour les applications Android (pour les fichiers de données HFSQL).
WINDEVJava Cette fonction est désormais disponible pour les applications Java.
Universal Windows 10 App Cette fonction est désormais disponible en mode Windows Store apps.
Widget Android Cette fonction est désormais disponible en mode Widget Android.
Android Cette fonction est désormais disponible pour les applications Android (pour les fichiers de données HFSQL).
WINDEVJava Cette fonction est désormais disponible pour les applications Java.
Remarque : A partir de la version 19, HFSQL est le nouveau nom de HyperFileSQL.
Versions 21 et supérieures
Universal Windows 10 App Cette fonction est désormais disponible en mode Universal Windows 10 App.
Nouveauté 21
Universal Windows 10 App Cette fonction est désormais disponible en mode Universal Windows 10 App.
Universal Windows 10 App Cette fonction est désormais disponible en mode Universal Windows 10 App.
WINDEVWEBDEV - Code ServeurEtats et RequêtesAjaxCode Utilisateur (MCU)HFSQLHyper File 5.5OLE DB
// Changement de répertoire pour les fichiers définis dans
// un répertoire spécifique dans l'analyse
HSubstRep("C:\Fichier", "D:\Fichier")
// Ouverture/création des fichiers dans le nouveau répertoire
HCréationSiInexistant("*")
WINDEVWEBDEV - Code ServeurEtats et RequêtesAjaxCode Utilisateur (MCU)HFSQL
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
Windows Mobile
// Changement de répertoire pour les fichiers définis dans
// un répertoire spécifique dans l'analyse
HSubstRep("\FichierA", "\FichierB")
// Ouverture/création des fichiers dans le nouveau répertoire
HCréationSiInexistant("*")
Syntaxe
<Résultat> = HSubstRep(<Répertoire des fichiers spécifié dans l'analyse> , <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 au fichier de données 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 au fichier de données.
<Répertoire des fichiers spécifié dans l'analyse> : Chaîne de caractères avec guillemets
Nom du répertoire donné lors de la description du fichier de données.
WINDEVWEBDEV - 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 avec guillemets
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 fichiers de données non HFSQL, la fonction HSubstRep est ignorée.
WINDEVWEBDEV - 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 l'analyse 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 l'analyse), le dernier répertoire physique spécifié remplace tous les autres.

Substitution de répertoire

La fonction HChangeRep permet d'associer un répertoire à un fichier de données. 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éation(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 du fichier de données conserve le nouveau chemin.
  • Cette fonction n'est pas utilisable lors d'un accès distant. Pour plus de détails sur l'accès distant, consultez RPC sur HFSQL (Accès distant).
  • Le nombre de substitutions est illimité.
Composante : wd240hf.dll
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire