Fonction Set dans PowerAppsSet function in PowerApps

Définit la valeur d’une variable globale.Sets the value of a global variable.

Vue d’ensembleOverview

Utilisez la fonction Set pour définir la valeur d’une variable globale qui stocke temporairement une partie des informations, telles que le nombre de fois où l’utilisateur a sélectionné un bouton ou le résultat d’une opération sur des données.Use the Set function to set the value of a global variable, which temporarily holds a piece of information, such as the number of times the user has selected a button or the result of a data operation.

Les variables globales sont disponibles dans l’ensemble de votre application, sur tous les écrans.Global variables are available throughout your app on all screens. Il s’agit du type de variable le plus simple qui répond à la plupart des besoins.These are the simplest kind of variables and fill the needs of most situations. Il existe également des variables de contexte qui sont limitées à un seul écran et des collections qui autorisent l’apport de modifications au niveau des lignes des tables.There are also context variables which are scoped to a single screen and collections that allow row level modifications to tables. Pour plus d’informations sur ces autres options, consultez Utilisation des variables.For more information on these other options see working with variables.

Les applications PowerApps dépendent de formules recalculées automatiquement lorsque l’utilisateur interagit avec une application.PowerApps are based on formulas that automatically recalculate as the user interacts with an app. Les variables globales ne proposent pas cet avantage et peuvent compliquer la création et la compréhension de votre application.Global variables don't offer this benefit and can make your app harder to create and understand. Avant d’utiliser une variable, consultez la section relative à l’utilisation des variables.Before you use a variable, review working with variables.

DescriptionDescription

Les variables globales sont créées de façon implicite à l’aide de la fonction Set.Global variables are implicitly created by using the Set function. Aucune déclaration explicite n’est requise.There is no explicit declaration required. Si vous supprimez toutes les fonctions Set d’une variable globale, cette dernière cesse d’exister.If you remove all the Set functions for a global variable, then that global variable will cease to exist. Pour effacer une variable, définissez sa valeur sur le résultat de la fonction Blank.To clear a variable set its value to the result of the Blank function.

Vous pouvez voir les valeurs, les définitions et les utilisations des variables avec la vue Variables sous le menu Fichier dans l’environnement de création.You can see your variables' values, definitions, and uses with the Variables view under the File menu in the authoring environment.

Comme le montrent les exemples plus loin dans cette rubrique, les variables globales peuvent contenir plusieurs types d’informations, notamment :As the examples later in this topic show, global variables can hold several kinds of information, including these:

  • une valeur unique ;a single value
  • un enregistrement ;a record
  • un tableau ;a table
  • une référence d’objet ;an object reference
  • un résultat de formule.any result from a formula

Une variable globale conserve sa valeur jusqu’à ce que l’application soit fermée.A global variable holds its value until the app is closed. Ensuite, la valeur de la variable globale est perdue et doit être recréée lorsque l’application est rechargée.Once closed, the global variable's value will be lost and must be recreated when the app is loaded again.

Les variables globales ne peuvent pas utiliser le même nom qu’une collection ou un contrôle actuel.Global variables cannot use the same name as an existing collection or control. Elles peuvent utiliser le même nom qu’une variable de contexte.It can use the same name as a context variable. Pour lever l’ambiguïté entre les deux, utilisez l’opérateur de levée d’ambiguïté.To disambiguate between the two, use the disambiguation operator.

Set n’a aucune valeur de retour et vous pouvez l’utiliser uniquement dans une formule de comportement.Set has no return value, and you can use it only within a behavior formula.

SyntaxeSyntax

Set( VariableName, Value )Set( VariableName, Value )

  • VariableName : requis.VariableName - Required. Nom d’une variable globale à créer ou à mettre à jour.The name of a global variable to create or update.
  • Value : requis.Value - Required. Valeur à affecter à la variable de contexte.The value to assign to the context variable.

ExemplesExamples

FormuleFormula DescriptionDescription RésultatResult
Set( Counter, 1 )Set( Counter, 1 ) Crée ou modifie la variable globale Counter, en lui attribuant la valeur 1.Creates or modifies the global variable Counter, setting its value to 1. Counter a la valeur 1.Counter has the value 1. Vous pouvez référencer cette variable en utilisant le nom Counter dans une formule sur n’importe quel écran.You can reference that variable by using the name Counter in a formula on any screen.
Set( Counter, 2 )Set( Counter, 2 ) Définit la valeur de la variable globale Counter de l’exemple précédent sur 2.Sets the value of the Counter global variable from the previous example to 2. Counter a la valeur 2.Counter has the value 2.
Set( Counter, Counter + 1 )Set( Counter, Counter + 1 ) Incrémente la valeur de la variable globale Counter de l’exemple précédent sur 3.Increments the value of the Counter global variable from the previous example to 3. Counter a la valeur 3.Counter has the value 3.
Set( Name, "Lily" )Set( Name, "Lily" ) Crée ou modifie la variable globale Name, en lui attribuant la valeur Lily.Creates or modifies the global variable Name setting its value to Lily. Name a la valeur Lily.Name has the value Lily.
Set( Person, { Name: "Milton", Address: "1 Main St" } )Set( Person, { Name: "Milton", Address: "1 Main St" } ) Crée ou modifie la variable globale Person, en définissant sa valeur sur un enregistrement.Creates or modifies the global variable Person, setting its value to a record. L’enregistrement contient deux colonnes nommées Name et Address.The record contains two columns, named Name and Address. La valeur de la colonne Name est Milton et la valeur de la colonne Address est 1 Main St.The value of the Name column is Milton, and the value of the Address column is 1 Main St. Person a la valeur de l’enregistrement { Name: "Milton", Address: "1 Main St" }.Person has the value of record { Name: "Milton", Address: "1 Main St" }.

Référencez cet enregistrement dans son ensemble avec le nom Person, ou référencez une colonne individuelle de cet enregistrement avec Person.Name ou Person.Address.Reference this record as a whole with the name Person, or reference an individual column of this record with Person.Name or Person.Address.
Set( Person, Patch( Person, {Address: "2 Main St" } ) )Set( Person, Patch( Person, {Address: "2 Main St" } ) ) Utilise la fonction Patch pour mettre à jour la variable globale Person en définissant la valeur de la colonne Address sur 2 Main St.Works with the Patch function to update the Person global variable by setting the value of the Address column to 2 Main St. Person a maintenant la valeur de l’enregistrement { Name: "Milton", Address: "2 Main St" }.Person now has the value of record { Name: "Milton", Address: "2 Main St" }.