Función Set en PowerAppsSet function in PowerApps

Establece el valor de una variable global.Sets the value of a global variable.

Información generalOverview

La función Set se usa para establecer el valor de una variable global, que guarda temporalmente un fragmento de información, como el número de veces que el usuario ha seleccionado un botón o el resultado de una operación de datos.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.

Las variables globales están disponibles en todas las pantallas de la aplicación.Global variables are available throughout your app on all screens. Son las variables más simples y se pueden usar en la mayor parte de las situaciones.These are the simplest kind of variables and fill the needs of most situations. También hay variables de contexto cuyo ámbito es una sola pantalla y colecciones que permiten modificar tablas a nivel de fila.There are also context variables which are scoped to a single screen and collections that allow row level modifications to tables. Para más información acerca de estas otras opciones, consulte cómo usar variables.For more information on these other options see working with variables.

PowerApps se basa en fórmulas que se recalculan automáticamente a medida que el usuario interactúa con una aplicación.PowerApps are based on formulas that automatically recalculate as the user interacts with an app. Las variables globales no tienen esta ventaja y pueden hacer que la aplicación sea más difícil de crear y comprender.Global variables don't offer this benefit and can make your app harder to create and understand. Antes de utilizar una variable, consulte cómo usar variables.Before you use a variable, review working with variables.

DescripciónDescription

Las variables globales se crean implícitamente mediante la función Set.Global variables are implicitly created by using the Set function. No es necesaria ninguna declaración explícita.There is no explicit declaration required. Si quita todas las funciones Set funciones de una variable global, esta dejará de existir.If you remove all the Set functions for a global variable, then that global variable will cease to exist. Para borrar una variable, establezca su valor en el resultado de la función Blank.To clear a variable set its value to the result of the Blank function.

Puede ver los valores de las variables, las definiciones y los usos con la vista Variables del menú Archivo en el entorno de creación.You can see your variables' values, definitions, and uses with the Variables view under the File menu in the authoring environment.

Tal como mostrarán los ejemplos de este mismo tema, las variables de contexto pueden contener distintos tipos de información, entre los que se incluyen:As the examples later in this topic show, global variables can hold several kinds of information, including these:

  • un valor únicoa single value
  • un registroa record
  • una tablaa table
  • una referencia de objetoan object reference
  • el resultado de una fórmulaany result from a formula

Una variable global guarda su valor hasta que se cierra la aplicación.A global variable holds its value until the app is closed. Una vez que se cierre, el valor de la variable global se perderá y deberá volver a crearlo al cargar la aplicación de nuevo.Once closed, the global variable's value will be lost and must be recreated when the app is loaded again.

Las variables globales no pueden usar el mismo nombre que una colección o un control existentes.Global variables cannot use the same name as an existing collection or control. Sin embargo, pueden usar el mismo nombre que una variable de contexto.It can use the same name as a context variable. Para eliminar la ambigüedad entre ambas, use el operador de desambiguación.To disambiguate between the two, use the disambiguation operator.

Set no devuelve ningún valor y solo se puede usar en una fórmula de comportamiento.Set has no return value, and you can use it only within a behavior formula.

SintaxisSyntax

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

  • VariableName (se requiere).VariableName - Required. Nombre de la variable global que se va a crear o actualizar.The name of a global variable to create or update.
  • Value (se requiere).Value - Required. Valor que se asigna a la variable de contexto.The value to assign to the context variable.

EjemplosExamples

FórmulaFormula DescripciónDescription ResultadoResult
Set( Counter, 1 )Set( Counter, 1 ) Crea o modifica la variable global Counter y establece su valor en 1.Creates or modifies the global variable Counter, setting its value to 1. Counter tiene el valor 1.Counter has the value 1. Para hacer referencia a dicha variable, utilice el nombre Counter en una fórmula en cualquier pantalla.You can reference that variable by using the name Counter in a formula on any screen.
Set( Counter, 2 )Set( Counter, 2 ) Establece el valor de la variable global Counter del ejemplo anterior en 2.Sets the value of the Counter global variable from the previous example to 2. Counter tiene el valor 2.Counter has the value 2.
Set( Counter, Counter + 1 )Set( Counter, Counter + 1 ) Aumenta el valor de la variable global Counter del ejemplo anterior en 3.Increments the value of the Counter global variable from the previous example to 3. Counter tiene el valor 3.Counter has the value 3.
Set( Name, "Lily" )Set( Name, "Lily" ) Crea o modifica la variable global Name y establece su valor en Lily.Creates or modifies the global variable Name setting its value to Lily. Name tiene el valor 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 variable global Person y establece su valor en un registro.Creates or modifies the global variable Person, setting its value to a record. El registro contiene dos columnas, llamadas Name y Address.The record contains two columns, named Name and Address. El valor de la columna Name es Milton, y el valor de la columna Address es 1 Main St.The value of the Name column is Milton, and the value of the Address column is 1 Main St. Person tiene el valor del registro { Name: "Milton", Address: "1 Main St" }}.Person has the value of record { Name: "Milton", Address: "1 Main St" }.

Haga referencia a este registro como un todo con el nombre Person, o haga referencia a una columna individual de este registro 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" } ) ) Trabaja con la función Patch para actualizar la variable global Person y establece el valor de la columna Address en 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 ahora tiene el valor del registro { Name: "Milton", Address: "2 Main St" }}.Person now has the value of record { Name: "Milton", Address: "2 Main St" }.