fRepDonnées (Fonction)

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE

Version :

Accueil | Connexion | Français

Aide / WLangage / Fonctions WLangage / Fonctions standard / Fonctions de gestion des fichiers externes

Divers
Le répertoire des données peut être spécifié lors de l'installation
Remarque
Dossiers des données sous Android

WINDEV

WEBDEV

WINDEV Mobile

Autres

Voir Aussi

fRepDonnées (Fonction)

En anglais : fDataDir

Renvoie le chemin complet du répertoire des fichiers de données HFSQL spécifié par l'utilisateur lors de l'installation de l'application.

Remarque : Ce répertoire ne correspond pas obligatoirement au répertoire réel des fichiers de données en exécution (qui peut avoir été modifié par les fonctions HSubstRep, HChangeRep, ...).

Sous Android, renvoie le chemin complet du répertoire par défaut contenant la ou les base(s) de données de l'application. Ce répertoire n'est pas configurable.

Exemple

// Création d'un fichier .INI
RepINI est une chaîne
SI fRepDonnées() <> "" ALORS
RepINI = fRepDonnées() + ["\"] + "MONPROJET.INI"
SINON
RepINI = "MONPROJET.INI"
FIN
INIEcrit("SECTION", "DEJALANCE", "OUI", RepINI)

Syntaxe

<Résultat> = fRepDonnées()

<Résultat> : Chaîne de caractères

Chemin complet (par exemple : "D:\DATA\Rewali") ou chemin UNC (par exemple : "\\SERVEUR\DATA\Rewali") du répertoire des fichiers de données HFSQL.
Résultat de la fonction fRepExe si aucun répertoire n'a été spécifié lors de l'installation (en mode test et lors de l'exécution d'un exécutable sans installation).
Chemin complet du répertoire par défaut contenant la ou les base(s) de données de l'application dans la zone de stockage interne. Ce répertoire correspond au répertoire "Databases" de l'application. Ce répertoire n'est pas configurable.
Chemin complet du répertoire contenant la ou les base(s) de données de l'application. Ce répertoire correspond au répertoire "Documents" de l'application. Ce répertoire n'est pas configurable.

Remarques

Divers

Si la fonction HSubstRep est utilisée dans le code de l'application, le répertoire spécifié à l'installation par l'utilisateur ne sera pas pris en compte.
Si les fichiers de données sont décrits dans l'analyse avec un répertoire spécifique (déconseillé), ce répertoire ne sera pas pris en compte. Seul le répertoire spécifié par l'utilisateur à l'installation sera pris en compte.
La fonction fRepDonnées n'est pas équivalente à la propriété Répertoire.

Le répertoire des données peut être spécifié lors de l'installation

Dans le cas d'une installation par média physique, le répertoire des fichiers de données est spécifié lors de l'installation.
Dans le cas d'une installation par accès distant (FTP), l'hébergeur fournit le répertoire de base des fichiers de données et l'utilisateur fournit le nom du sous-répertoire dans lequel les fichiers de données sont installés.

Remarque

La fonction fRepDonnées renvoie la même valeur que fRepExe.

Dossiers des données sous Android

Sous Android, les dossiers correspondant aux données ne sont pas simplement identifiés.

Le code suivant permet de lister les principaux dossiers et la correspondance de ces dossiers lorsque l'appareil est connecté à un ordinateur.

// Liste les différents principaux dossiers utilisables sous Android
sInfoRépertoire est une chaîne

// Dossier par défaut des données
sInfoRépertoire += [RC] + "fRepDonnées : " + fRepDonnées()
// Exemple : /data/user/0/com.masociete.nom_du_projet/databases
// Dossier NON accessible par un ordinateur lorsqu'il est connecté

// Carte externe principale de stockage
// (ou stockage interne qui émule une carte externe)
sInfoRépertoire += [RC] + "SysRepCarteStockage : " + SysRepCarteStockage()
// Exemple : /storage/emulated/0
// Dossier accessible par un ordinateur lorsqu'il est connecté,
// il est vu comme la "racine" d'un disque de l'appareil

//Tous les périphériques sur lesquels il est possible de lire ou écrire
POUR n= 1 _À_ SysNbStockageExterne()
// Dossier de base de ce périphérique (ou périphérique émulé)
sInfoRépertoire += [RC]+ "SysRepStockageExterne(" + n + ", ssePublic) : " + ...
SysRepStockageExterne(n, ssePublic)
// Exemple pour une carte émulée : /storage/emulated/0
// Dossier accessible par un ordinateur lorsqu'il est connecté,
// il est vu comme la "racine" d'un disque de l'appareil

// Répertoire des fichiers de données de l'application en cours
// (lorsque les données sont sur carte)
sInfoRépertoire += [RC] + "SysRepStockageExterne(" + n + ", sseAppFichier) : " + ...
SysRepStockageExterne(n, sseAppFichier)
// Exemple : /storage/emulated/0/Android/data/com.masociete.nom_du_projet/files
// Dossier accessible par un ordinateur lorsqu'il est connecté,
// il est vu comme le sous-dossier
// "\Android\data\com.masociete.nom_du_projet\files" d'un disque

// Répertoire des documents de l'application en cours
sInfoRépertoire += [RC] + "SysRepStockageExterne(" + n + ", sseAppDocument) : " + ...
SysRepStockageExterne(n, sseAppDocument)
// Exemple : /storage/emulated/0/Android/data/com.masociete.nom_du_projet/files/Documents
// Dossier accessible par un ordinateur lorsqu'il est connecté,
// il est vu comme le sous-dossier
// "\Android\data\com.masociete.nom_du_projet\Documents" d'un disque

// Répertoire des documents "publics" / "partagés" donc commun à toutes les applications
sInfoRépertoire += [RC] + "SysRepStockageExterne(" + n + ",ssePublicDocument) : " + ...
SysRepStockageExterne(n, ssePublicDocument)
// Exemple : /storage/emulated/0/Documents
// Dossier accessible par un ordinateur lorsqu'il est connecté,
// il est vu comme le sous-dossier "\Documents" d'un disque

FIN

// Répertoire des fichiers de cache de l'application
// (ces données peuvent être supprimées par l'utilisateur ou le système)
sInfoRépertoire += [RC] + "fRepCache : " + fRepCache()
// Exemple : /data/user/0/com.masociete.nom_du_projet/cache
// Dossier NON accessible par un ordinateur lorsqu'il est connecté

// Pour avoir l'information dans les traces de Android Device Monitor
// (.\personal\Android\AndroidSDK\tools\monitor.bat)
Trace(sInfoRépertoire)
Info(sInfoRépertoire)

Composante : wd290vm.dll

Voir Aussi

Version minimum requise

Version 9

Documentation également disponible pour…

Commentaires

Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 19/07/2023

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