UpdateContext |
Mise à jour du contexte |
| Power Fx |
Syntaxe
|
UpdateContext( UpdateRecord )
|
|
UpdateContext( { ContextVariable1: Value1 [, ContextVariable2: Value2 [, ... ] ] } )
|
Paramètres
| Nom |
Description |
| UpdateRecord |
Ce paramètre permet de définir une ou plusieurs variables de contexte à la fois. Il s'agit d'un enregistrement contenant les variables et leurs valeurs. |
| ContextVariable1 |
Ce paramètre permet de spécifier une variable de contexte. |
| Value1 |
Ce paramètre correspond à la valeur que vous voulez attribuer à la variable de contexte spécifiée (ContextVariable1). |
| ContextVariable2 |
Ce paramètre permet de spécifier une autre variable de contexte. |
| Value2 |
Ce paramètre correspond à la valeur que vous voulez attribuer à la variable de contexte spécifiée (ContextVariable2). |
Description
Cette fonction permet de définir une variable de contexte.
Remarques
- La fonction UpdateContext est essentielle pour gérer des variables locales dans un écran d'une application Canvas : Elle permet de créer ou de modifier
dynamiquement des variables dites « de contexte », qui ne sont accessibles que dans l'écran en cours. Cela facilite le découpage logique du code sans affecter
d'autres écrans.
- Les variables de contexte sont utiles pour stocker temporairement des valeurs intermédiaires : Par exemple, on peut s'en servir pour mémoriser l'état
d'une boîte de dialogue (visible ou non), le texte saisi dans un champ, ou encore un identifiant sélectionné par l'utilisateur.
- La syntaxe utilise un enregistrement entre accolades pour définir une ou plusieurs variables simultanément : Par exemple,
UpdateContext({showPopup: true, selectedId: 45}) modifie en une seule ligne deux variables à la fois, ce qui rend la gestion du contexte plus claire et compacte.
- Les variables créées avec UpdateContext n'existent que tant que l'écran actuel est actif : Elles sont automatiquement supprimées dès que l'utilisateur
quitte l'écran, ce qui évite d'avoir à gérer manuellement leur nettoyage mais impose de les redéfinir à chaque entrée.
- L'usage d'un seul appel UpdateContext avec plusieurs paires nom: valeur est plus performant que plusieurs appels séparés : Cela permet d'éviter des
recalculs ou des rafraîchissements visuels inutiles, notamment lorsqu'on travaille avec des données d'interface sensibles.
- Contrairement à Set, UpdateContext est limité à l'écran où il est appelé : Cela favorise l'encapsulation des comportements dans des écrans spécifiques,
mais nécessite de choisir avec soin entre les deux selon la portée désirée.
- UpdateContext est fréquemment utilisé dans des événements tels que OnSelect, OnVisible ou OnChange : Il s'intègre très bien
à la logique événementielle de Power Apps et permet de modifier l'état de l'interface en réponse à une action utilisateur.
- Il est recommandé de donner des noms clairs et explicites aux variables de contexte créées avec UpdateContext : Comme ces variables peuvent se
multiplier rapidement dans des applications complexes, une bonne convention de nommage aide à maintenir la lisibilité et la maintenance du code.
Dernière mise à jour : Jeudi, le 1 Mai 2025
