Funzione Set in PowerAppsSet function in PowerApps

Imposta il valore di una variabile globale.Sets the value of a global variable.

PanoramicaOverview

Usare la funzione Set per impostare il valore di una variabile globale, che usa un'informazione temporaneamente, ad esempio il numero di volte in cui l'utente ha selezionato un pulsante o il risultato di un'operazione di dati.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.

Le variabili globali sono disponibili in tutte le schermate dell'app,Global variables are available throughout your app on all screens. sono le più semplici e rispondono alle esigenze nella maggior parte delle situazioni.These are the simplest kind of variables and fill the needs of most situations. Esistono anche variabili di contesto nell'ambito di una singola schermata e raccolte che consentono modifiche a di livello di riga alle tabelle.There are also context variables which are scoped to a single screen and collections that allow row level modifications to tables. Per altre informazioni su queste opzioni, vedere Informazioni sulle variabili in PowerApps.For more information on these other options see working with variables.

Le app PowerApps sono basate su formule che eseguono calcoli automatici durante l'interazione con un'app.PowerApps are based on formulas that automatically recalculate as the user interacts with an app. Le variabili globali non offrono questo vantaggio e possono rendere la creazione e l'uso dell'app più difficili.Global variables don't offer this benefit and can make your app harder to create and understand. Prima di usare una variabile, rivedere Informazioni sulle variabili in PowerApps.Before you use a variable, review working with variables.

DescrizioneDescription

Le variabili globali vengono create in modo implicito usando la funzione Set.Global variables are implicitly created by using the Set function. Non è necessaria alcuna dichiarazione esplicita.There is no explicit declaration required. Se si rimuovono tutte le funzioni Set da una variabile globale, questa cesserà di esistere.If you remove all the Set functions for a global variable, then that global variable will cease to exist. Per cancellare una variabile, impostarne il valore sul risultato della funzione Blank.To clear a variable set its value to the result of the Blank function.

I valori, le definizioni e gli usi delle variabili sono disponibili nella visualizzazione Variabili del menu File nell'ambiente di creazione.You can see your variables' values, definitions, and uses with the Variables view under the File menu in the authoring environment.

Come illustrano gli esempi più avanti in questo argomento, le variabili globali possono contenere diversi tipi di informazioni, quali:As the examples later in this topic show, global variables can hold several kinds of information, including these:

  • Un valore singoloa single value
  • Un recorda record
  • Una tabellaa table
  • Un riferimento a un oggettoan object reference
  • Qualsiasi risultato da una formulaany result from a formula

Una variabile globale conserva il suo valore fino a quando l'app non viene chiusa.A global variable holds its value until the app is closed. Una volta chiusa, il valore della variabile globale verrà perso e dovrà essere creato di nuovo quando verrà ricaricata l'app.Once closed, the global variable's value will be lost and must be recreated when the app is loaded again.

Le variabili globali non possono usare lo stesso nome di una raccolta o un controllo esistenti,Global variables cannot use the same name as an existing collection or control. ma possono usare lo stesso nome di una variabile di contesto.It can use the same name as a context variable. Per risolvere l'ambiguità tra le due variabili, usare l'operatore di risoluzione ambiguità.To disambiguate between the two, use the disambiguation operator.

La funzione Set non restituisce alcun valore e può essere usata solo in una formula di comportamento.Set has no return value, and you can use it only within a behavior formula.

SintassiSyntax

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

  • VariableName: obbligatorio.VariableName - Required. Nome di una variabile globale da creare o aggiornare.The name of a global variable to create or update.
  • Value - Obbligatorio.Value - Required. Il valore da assegnare alla variabile di contesto.The value to assign to the context variable.

EsempiExamples

FormulaFormula DescrizioneDescription RisultatoResult
Set( Counter, 1 )Set( Counter, 1 ) Crea o modifica la variabile globale Counter, impostandone il valore su 1.Creates or modifies the global variable Counter, setting its value to 1. Counter ha il valore 1.Counter has the value 1. È possibile fare riferimento a tale variabile usando il nome Counter in una formula in qualsiasi schermata.You can reference that variable by using the name Counter in a formula on any screen.
Set( Counter, 2 )Set( Counter, 2 ) Imposta il valore della variabile globale Counter dell'esempio precedente su 2.Sets the value of the Counter global variable from the previous example to 2. Counter ha il valore 2.Counter has the value 2.
Set( Counter, Counter + 1 )Set( Counter, Counter + 1 ) Incrementa il valore della variabile globale Counter dell'esempio precedente a 3.Increments the value of the Counter global variable from the previous example to 3. Counter ha il valore 3.Counter has the value 3.
Set( Name, "Lily" )Set( Name, "Lily" ) Crea o modifica la variabile globale Name, impostandone il valore su Lily.Creates or modifies the global variable Name setting its value to Lily. Name ha il valore Lily.Name has the value Lily.
Set( Person, { Name: "Milton", Address: "1 Main St" } )Set( Person, { Name: "Milton", Address: "1 Main St" } ) Crea o modifica la variabile globale Person, impostandone il valore su un record.Creates or modifies the global variable Person, setting its value to a record. Il record contiene due colonne, denominate Name e Address.The record contains two columns, named Name and Address. Il valore della colonna Name è Milton e il valore della colonna Address è 1 Main St.The value of the Name column is Milton, and the value of the Address column is 1 Main St. Person ha il valore di record { Name: "Milton", Address: "1 Main St" }.Person has the value of record { Name: "Milton", Address: "1 Main St" }.

Fare riferimento a questo record come intero con il nome Person o fare riferimento a una colonna individuale di questo record con Person.Name o 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" } ) ) Si usa con la funzione Patch per aggiornare la variabile globale Person impostando il valore della colonna Address su 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 ha ora il valore di record { Name: "Milton", Address: "2 Main St" }.Person now has the value of record { Name: "Milton", Address: "2 Main St" }.