Funciones Quitar y RemoveIf en PowerAppsRemove and RemoveIf functions in PowerApps

Quita registros de un origen de datos.Removes records from a data source.

DescripciónDescription

Función QuitarRemove function

Use la función Quitar para quitar un registro o registros específicos de un origen de datos.Use the Remove function to remove a specific record or records from a data source.

Para las colecciones, tiene que coincidir con todo el registro.For collections, the entire record must match. Puede usar el argumento Todo para quitar todas las copias de un registro; en caso contrario, se quita solo una copia del registro.You can use the All argument to remove all copies of a record; otherwise, only one copy of the record is removed.

Función RemoveIfRemoveIf function

Use la función RemoveIf para quitar un registro o registros en función de una condición o un conjunto de condiciones.Use the RemoveIf function to remove a record or records based on a condition or a set of conditions. Cada condición puede ser cualquier fórmula que da como resultado true o false y puede hacer referencia a columnas del origen de datos por su nombre.Each condition can be any formula that results in a true or false and can reference columns of the data source by name. Cada condición se evalúa individualmente para cada registro, y si todas las condiciones se evalúan como true se elimina el registro.Each condition is evaluated individually for each record, and the record is removed if all conditions evaluate to true.

Quitar y RemoveIf devuelven el origen de datos modificado como una tabla.Remove and RemoveIf return the modified data source as a table. Puede usar ambas funciones únicamente en fórmulas de comportamiento.You can use both functions only in behavior formulas.

También puede usar la función Clear para eliminar registros en un origen de datos.You can also use the Clear function to remove all of the records in a data source.

DelegaciónDelegation

When used with a data source, these functions can't be delegated. Only the first portion of the data source will be retrieved and then the function applied. The result may not represent the complete story. A blue dot will appear at authoring time to remind you of this limitation and to suggest switching to delegable alternatives where possible. For more information, see the delegation overview.

SintaxisSyntax

Quitar( DataSource, Record1 [, Record2, ... ] [, Todo ] )Remove( DataSource, Record1 [, Record2, ... ] [, All ] )

  • DataSource: requerido.DataSource – Required. El origen de datos que contiene el registro o los registros que desea quitar.The data source that contains the record or records that you want to remove.
  • Registro(s): requerido.Record(s) – Required. El registro o los registros que se van a quitar.The record or records to remove.
  • Todo: opcional.All – Optional. En una colección, el mismo registro puede aparecer más de una vez.In a collection, the same record may appear more than once. Puede agregar el argumento Todo para quitar todas las copias del registro.You can add the All argument to remove all copies of the record.

Quitar( DataSource, Tabla [, Todo ] )Remove( DataSource, Table [, All ] )

  • DataSource: requerido.DataSource – Required. El origen de datos que contiene los registros que desea quitar.The data source that contains the records that you want to remove.
  • Tabla: requerido.Table – Required. Tabla de registros que se van a quitar.A table of records to remove.
  • Todo: opcional.All – Optional. En una colección, el mismo registro puede aparecer más de una vez.In a collection, the same record may appear more than once. Puede agregar el argumento Todo para quitar todas las copias del registro.You can add the All argument to remove all copies of the record.

RemoveIf( DataSource, Condición [,...])RemoveIf( DataSource, Condition [, ... ] )

  • DataSource: requerido.DataSource – Required. El origen de datos que contiene el registro o los registros que desea quitar.The data source that contains the record or records that you want to remove.
  • Condition(s): requerido.Condition(s) – Required. Una fórmula que se evalúa como true para el registro o los registros que se van a quitar.A formula that evaluates to true for the record or records to remove. Puede usar nombres de columna de DataSource en la fórmula.You can use column names from the DataSource in the formula. Si especifica varias Condiciones, todas se deben evaluar como true para el registro o registros que va a quitar.If you specify multiple Conditions, all must evaluate to true for the record or records to be removed.

EjemplosExamples

En estos ejemplos, va a quitar un registro o registros de un origen de datos que se denomina IceCream y que comienza con los datos en esta tabla:In these examples, you'll remove a record or records in a data source that's named IceCream and that starts with the data in this table:

FórmulaFormula DescripciónDescription ResultadoResult
Quitar ( IceCream,
Primero ( Filtrar ( IceCream, Flavor = "Chocolate" ) ))
Remove( IceCream,
First( Filter( IceCream, Flavor="Chocolate" ) ) )
Quita el registro Chocolate del origen de datos.Removes the Chocolate record from the data source.

El origen de datos IceCream se ha modificado.The IceCream data source has been modified.
Quitar ( IceCream,
Primero ( Filtrar ( IceCream, Flavor = "Chocolate" ) ) First ( Filtrar ( IceCream, Flavor = "Strawberry" ) ) )
Remove( IceCream,
First( Filter( IceCream, Flavor="Chocolate" ) ) First( Filter( IceCream, Flavor="Strawberry" ) ) )
Quita los dos registros del origen de datos.Removes two records from the data source.

El origen de datos IceCream se ha modificado.The IceCream data source has been modified.
RemoveIf ( IceCream, Cantidad > 150)RemoveIf( IceCream, Quantity > 150 ) Quita los registros que tienen una Cantidad superior a 150.Removes records that have a Quantity that's greater than 150.

El origen de datos IceCream se ha modificado.The IceCream data source has been modified.
RemoveIf( IceCream, Cantidad > 150, Left( Flavor, 1 ) = "S" )RemoveIf( IceCream, Quantity > 150, Left( Flavor, 1 ) = "S" ) Quita los registros que tienen una Cantidad superior a 150 y cuyo valor Flavor empieza con S.Removes records that have a Quantity that's greater than 150 and Flavor starts with an S.


El origen de datos IceCream se ha modificado.The IceCream data source has been modified.
RemoveIf ( IceCream, true)RemoveIf( IceCream, true ) Quita todos los registros del origen de datos.Removes all records from the data source.

El origen de datos IceCream se ha modificado.The IceCream data source has been modified.

Paso a pasoStep by step

  1. Importe o cree una colección denominada Inventory y muéstrela en una galería, como se describe en el artículo sobre la visualización de datos en una galería.Import or create a collection named Inventory, and show it in a gallery as Show data in a gallery describes.
  2. En la galería, establezca la propiedad AlSeleccionar de la imagen en la expresión:In the gallery, set the OnSelect property of the image to this expression:
    Quitar (Inventario, EsteElemento)Remove(Inventory, ThisItem)
  3. Presione F5 y, a continuación, seleccione una imagen en la galería.Press F5, and then select an image in the gallery.
    El elemento se quita de la galería y la colección.The item is removed from the gallery and the collection.