Set-Funktion in PowerAppsSet function in PowerApps

Legt den Wert einer globalen Variablen fest.Sets the value of a global variable.

ÜbersichtOverview

Verwenden Sie die Set-Funktion zum Festlegen des Werts einer globalen Variablen, die vorübergehend eine Information enthält, z.B. wie oft ein Benutzer auf eine Schaltfläche geklickt hat oder das Ergebnis eines Datenvorgangs.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.

Globale Variablen sind in Ihrer App auf allen Bildschirmen verfügbar.Global variables are available throughout your app on all screens. Sie stellen den einfachsten Typ von Variablen dar und erfüllen die Anforderungen in den meisten Situationen.These are the simplest kind of variables and fill the needs of most situations. Es gibt auch Kontextvariablen, deren Gültigkeitsbereich auf einen einzigen Bildschirm beschränkt ist, sowie Sammlungen, die Änderungen von Tabellen auf Zeilenebene ermöglichen.There are also context variables which are scoped to a single screen and collections that allow row level modifications to tables. Weitere Informationen zu diesen anderen Optionen finden Sie unter Grundlegendes zu Variablen in PowerApps.For more information on these other options see working with variables.

PowerApps basiert auf Formeln, die automatisch neu berechnet werden, während der Benutzer mit einer App interagiert.PowerApps are based on formulas that automatically recalculate as the user interacts with an app. Globale Variablen bieten diesen Vorteil nicht und können das Erstellen und Verstehen Ihrer App erschweren.Global variables don't offer this benefit and can make your app harder to create and understand. Konsultieren Sie vor der Verwendung einer Variablen den Artikel Grundlegendes zu Variablen in PowerApps.Before you use a variable, review working with variables.

BeschreibungDescription

Globale Variablen werden mithilfe der Set-Funktion implizit erstellt.Global variables are implicitly created by using the Set function. Eine explizite Deklaration ist nicht erforderlich.There is no explicit declaration required. Wenn Sie alle Set-Funktionen für eine globale Variable entfernen, hört die globale Variable auf zu existieren.If you remove all the Set functions for a global variable, then that global variable will cease to exist. Legen Sie zum Leeren einer Variablen ihren Wert auf das Ergebnis der Blank-Funktion fest.To clear a variable set its value to the result of the Blank function.

Sie können die Werte, Definitionen und Verwendungen Ihrer Variablen in der Ansicht „Variablen“ unter dem Menü „Datei“ in der Erstellungsumgebung anzeigen.You can see your variables' values, definitions, and uses with the Variables view under the File menu in the authoring environment.

Wie in den Beispielen weiter unten in diesem Thema gezeigt, können globale Variablen verschiedene Arten von Informationen enthalten, u.a. folgende:As the examples later in this topic show, global variables can hold several kinds of information, including these:

  • einen einzelnen Werta single value
  • einen Datensatza record
  • eine Tabellea table
  • einen Objektverweisan object reference
  • jedes Ergebnis einer Formelany result from a formula

Eine globale Variable verfügt über ihren Wert, bis die App geschlossen wird.A global variable holds its value until the app is closed. Sobald die App geschlossen wird, geht der Wert der globalen Variablen verloren; er muss neu erstellt werden, wenn die App wieder geladen wird.Once closed, the global variable's value will be lost and must be recreated when the app is loaded again.

Globale Variablen können nicht denselben Namen wie eine vorhandene Sammlung oder ein vorhandenes Steuerelement aufweisen.Global variables cannot use the same name as an existing collection or control. Sie kann jedoch denselben Namen wie eine Kontextvariable besitzen.It can use the same name as a context variable. Verwenden Sie den Operator zur Mehrdeutigkeitsvermeidung, um zu zwischen beiden zu unterscheiden.To disambiguate between the two, use the disambiguation operator.

Set weist keinen Rückgabewert auf; Sie können die Funktion nur innerhalb einer Verhaltensformel verwenden.Set has no return value, and you can use it only within a behavior formula.

SyntaxSyntax

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

  • VariableName: Erforderlich.VariableName - Required. Der Name der zu erstellenden oder zu aktualisierenden globalen Variablen.The name of a global variable to create or update.
  • Value: Erforderlich.Value - Required. Der der Kontextvariablen zuzuweisende WertThe value to assign to the context variable.

BeispieleExamples

FormelFormula BeschreibungDescription ErgebnisResult
Set( Counter, 1 )Set( Counter, 1 ) Erstellt oder ändert die globale Variable Counter und legt deren Wert auf 1 fest.Creates or modifies the global variable Counter, setting its value to 1. Counter hat den Wert 1.Counter has the value 1. Mit dem Namen Counter können Sie in einer Formel in einem beliebigen Bildschirm auf diese Variable verweisen.You can reference that variable by using the name Counter in a formula on any screen.
Set( Counter, 2 )Set( Counter, 2 ) Legt den Wert für die globale Variable Counter aus dem vorherigen Beispiel auf 2 fest.Sets the value of the Counter global variable from the previous example to 2. Counter hat den Wert 2.Counter has the value 2.
Set( Counter, Counter + 1 )Set( Counter, Counter + 1 ) Erhöht den Wert für die globale Variable Counter aus dem vorherigen Beispiel auf 3.Increments the value of the Counter global variable from the previous example to 3. Counter hat den Wert 3.Counter has the value 3.
Set( Name, "Lily" )Set( Name, "Lily" ) Erstellt oder ändert die globale Variable Name und legt deren Wert auf Lily fest.Creates or modifies the global variable Name setting its value to Lily. Name weist den Wert Lily auf.Name has the value Lily.
Set( Person, { Name: "Milton", Address: "1 Main St" } )Set( Person, { Name: "Milton", Address: "1 Main St" } ) Erstellt oder ändert die globale Variable Person und legt deren Wert auf einen Datensatz fest.Creates or modifies the global variable Person, setting its value to a record. Der Datensatz enthält zwei Spalten mit den Namen Name und Address.The record contains two columns, named Name and Address. Der Wert der Name-Spalte ist Milton, und der Wert der Address-Spalte ist 1 Main St.The value of the Name column is Milton, and the value of the Address column is 1 Main St. Person hat den Wert des Datensatzes { Name: "Milton", Address: "1 Main St" }.Person has the value of record { Name: "Milton", Address: "1 Main St" }.

Verweisen Sie mit dem Namen Person auf den kompletten Datensatz, oder verweisen Sie auf eine einzelne Spalte dieses Datensatzes mit Person.Name oder 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" } ) ) Arbeitet mit der Patch-Funktion zusammen, um die globale Variable Person durch Festlegen des Werts der Spalte Address auf 2 Main St zu aktualisieren.Works with the Patch function to update the Person global variable by setting the value of the Address column to 2 Main St. Person hat nun den Wert des Datensatzes { Name: "Milton", Address: "2 Main St" }.Person now has the value of record { Name: "Milton", Address: "2 Main St" }.