LoadData |
Charge les données |
| Power Fx |
Syntaxe
|
LoadData( Collection, Name [, IgnoreNonexistentFile ])
|
Paramètres
| Nom |
Description |
| Collection |
Ce paramètre désigne la collection dans laquelle les données seront chargées. |
| Name |
Ce paramètre correspond au nom du fichier ou de l'entrée de données à charger depuis le stockage local de l'appareil. |
| IgnoreNonexistentFile |
Ce paramètre, s'il est défini à true, permet d'éviter une erreur si le fichier spécifié n'existe pas. |
Description
Cette fonction permet de charger une collection à partir d'un hôte d'application comme un appareil local.
Remarques
- Permet le chargement de données hors ligne à partir de l'entreposage local : La fonction LoadData() est particulièrement utile pour les applications
Power Apps devant fonctionner sans connexion Internet. Elle permet de restaurer localement des collections de données préalablement enregistrées, assurant ainsi la
continuité du service même hors ligne.
- Requiert une correspondance exacte entre le nom du fichier et celui de la sauvegarde : Le paramètre Name doit correspondre exactement au nom utilisé
avec la fonction SaveData() pour que le chargement fonctionne. Une erreur de nommage empêchera la récupération des données, ce qui peut bloquer certaines
fonctionnalités de l'application.
- Le paramètre IgnoreNonexistentFile évite les interruptions brutales : En définissant IgnoreNonexistentFile à true, on empêche l'application de générer
une erreur si le fichier à charger n'existe pas encore. Cela est très utile lors de la première exécution de l'application ou en cas de suppression du fichier local.
- Facilite la gestion de sessions persistantes utilisateur : Grâce à LoadData(), il est possible de restaurer des informations personnalisées pour
l'utilisateur (comme ses préférences ou ses choix précédents), offrant ainsi une expérience fluide et cohérente même après la fermeture ou la réouverture de
l'application.
- Peut être utilisée pour améliorer les performances de l'application : Plutôt que de recharger des données depuis une source distante à chaque ouverture de
l'app, LoadData() permet de lire rapidement les données depuis l'entreposage local, ce qui améliore le temps de réponse et réduit la dépendance aux connexions
réseaux.
- Fonction complémentaire indispensable de SaveData() : LoadData() n'a de sens que si les données ont d'abord été sauvegardées avec SaveData(). Les deux
fonctions forment un duo essentiel pour les scénarios de persistance locale dans Power Apps, notamment sur les appareils mobiles.
- La collection cible doit exister ou être déclarée avant le chargement : Avant d'utiliser LoadData(), il est recommandé d'avoir initialisé la collection
cible ou de s'assurer qu'elle est correctement définie dans l'application. Sinon, cela peut provoquer des comportements inattendus, comme l'échec silencieux du
chargement.
- Utilisable uniquement dans les contextes qui autorisent le stockage local : LoadData() est restreinte aux contextes où le stockage local est permis, comme
sur les appareils mobiles avec Power Apps Player. Elle ne fonctionnera pas dans certains environnements comme les navigateurs Web, ce qui impose une gestion conditionnelle
du code.
Dernière mise à jour : Jeudi, le 1 Mai 2025