System.IOUtils.TPath.GetHomePath
Delphi
class function GetHomePath: string; static;
C++
static System::UnicodeString __fastcall GetHomePath();
Propriétés
| Type | Visibilité | Source | Unité | Parent |
|---|---|---|---|---|
| function | public | System.IOUtils.pas System.IOUtils.hpp |
System.IOUtils | TPath |
Description
Renvoie le chemin d'accès de base de l'utilisateur ou le répertoire de travail accessible en écriture de l'application ou l'emplacement de stockage. Appelez GetHomePath pour obtenir le chemin d'accès de base de l'utilisateur sur les Plates-formes cible prises en charge.
Si le système qui exécute votre application ne supporte pas le dossier demandé ou si le dossier demandé n'existe pas dans le système, cette fonction renvoie à la place une chaîne vide.
Vous devez utiliser GetHomePath pour stocker les paramètres par utilisateur. Par exemple
TFile.WriteAllText(TPath.GetHomePath() + TPath.DirectorySeparatorChar + 'sample.txt', 'This is my sample text.');
GetHomePath pointe vers les emplacements suivants sur les différentes plates-formes :
- Sur Windows, elle pointe vers le dossier Application Data de l'utilisateur.
- Sur Linux et OS X, elle pointe vers le dossier racine de l'utilisateur, tel que défini par la variable d'environnement $(HOME).
- Sur iOS et Android, elle pointe vers l'emplacement sandbox spécifique au périphérique pour l'application ; l'emplacement iOS d'origine est défini individuellement pour chaque instance d'application et pour chaque périphérique iOS.
| Plate-forme | Exemple de chemin | ID du chemin |
|---|---|---|
| Windows XP | C:\Documents and Settings\<nom utilisateur>\Application Data | CSIDL_APPDATA |
| Windows Vista ou ultérieur | C:\Users\<nom utilisateur>\AppData\Roaming | FOLDERID_RoamingAppData |
| OS X | /Users/<nom utilisateur> | NSUserDirectory |
| Périphérique iOS | /private/var/mobile/Containers/Data/Application/<ID application> | |
| Simulateur iOS | /Users/<nom utilisateur>/Library/Developer/CoreSimulator/Devices/<ID périphérique>/data/Containers/Data/Application/<ID application> | |
| Android | /data/data/<ID application>/files | Context.getFilesDir |
| Linux | /home/<username> | Dossier racine |
Voir aussi
- System.SysUtils.GetHomePath (cette fonction a la même fonctionnalité, mais n'est pas recommandée pour le développement d'une nouvelle plate-forme ou multi-périphérique)
- Tutoriel mobile : Utilisation de InterBase ToGo avec dbExpress (iOS et Android)
- Fonctions RTL standard relatives aux chemins sur les plates-formes cible prises en charge