Funções Remove e RemoveIf no PowerAppsRemove and RemoveIf functions in PowerApps

Remove registos de uma origem de dados.Removes records from a data source.

DescriçãoDescription

Função RemoveRemove function

Utilize a função Remove para remover um ou mais registos específicos de uma origem de dados.Use the Remove function to remove a specific record or records from a data source.

Para as coleções, todo o registo tem de corresponder.For collections, the entire record must match. Pode utilizar o argumento Tudo para remover todas as cópias de um registo; caso contrário, apenas uma cópia do registo é removida.You can use the All argument to remove all copies of a record; otherwise, only one copy of the record is removed.

Função RemoveIfRemoveIf function

Utilize a função RemoveIf para remover um ou mais registos com base numa condição ou num conjunto de condições.Use the RemoveIf function to remove a record or records based on a condition or a set of conditions. Cada condição pode ser uma fórmula que resulta num valor verdadeiro ou falso e pode referenciar colunas da origem de dados por nome.Each condition can be any formula that results in a true or false and can reference columns of the data source by name. Cada condição é avaliada individualmente para cada registo e cada registo será removido se todas as condições forem avaliadas como verdadeiras.Each condition is evaluated individually for each record, and the record is removed if all conditions evaluate to true.

Remove e RemoveIf devolvem a origem de dados modificada como uma tabela.Remove and RemoveIf return the modified data source as a table. Pode utilizar ambas as funções apenas em fórmulas de comportamento.You can use both functions only in behavior formulas.

Também pode utilizar a função Clear para remover todos os registos numa origem de dados.You can also use the Clear function to remove all of the records in a data source.

DelegaçãoDelegation

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.

SintaxeSyntax

Remove( DataSource, Record1 [, Record2, ... ] [, Tudo ] )Remove( DataSource, Record1 [, Record2, ... ] [, All ] )

  • DataSource – Necessário.DataSource – Required. A origem de dados que contém um ou mais registos que pretende remover.The data source that contains the record or records that you want to remove.
  • Registo(s) – Necessário.Record(s) – Required. Um ou mais registos a remover.The record or records to remove.
  • Tudo – Opcional.All – Optional. Numa coleção, o mesmo registo pode aparecer mais do que uma vez.In a collection, the same record may appear more than once. Pode adicionar o argumento Tudo para remover todas as cópias do registo.You can add the All argument to remove all copies of the record.

Remove( DataSource, Tabela [, Tudo ] )Remove( DataSource, Table [, All ] )

  • DataSource – Necessário.DataSource – Required. A origem de dados que contém os registos que pretende remover.The data source that contains the records that you want to remove.
  • Tabela – Necessário.Table – Required. Uma tabela de registos a remover.A table of records to remove.
  • Tudo – Opcional.All – Optional. Numa coleção, o mesmo registo pode aparecer mais do que uma vez.In a collection, the same record may appear more than once. Pode adicionar o argumento Tudo para remover todas as cópias do registo.You can add the All argument to remove all copies of the record.

RemoveIf( DataSource, Condição [, ... ] )RemoveIf( DataSource, Condition [, ... ] )

  • DataSource – Necessário.DataSource – Required. A origem de dados que contém um ou mais registos que pretende remover.The data source that contains the record or records that you want to remove.
  • Condição/Condições – Necessário.Condition(s) – Required. Uma fórmula que avalia como verdadeiro um ou mais registos a remover.A formula that evaluates to true for the record or records to remove. Pode utilizar nomes de colunas do argumento DataSource na fórmula.You can use column names from the DataSource in the formula. Se especificar várias Condições, devem ser todas avaliadas como verdadeiras para um ou mais registos a remover.If you specify multiple Conditions, all must evaluate to true for the record or records to be removed.

ExemplosExamples

Nestes exemplos, vai remover um ou mais registos de uma origem de dados denominada Gelado e que começa com os dados nesta tabela: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 DescriçãoDescription ResultadoResult
Remove( Gelado,
Primeiro( Filtro( IceCream, Sabor="Chocolate" ) ) )
Remove( IceCream,
First( Filter( IceCream, Flavor="Chocolate" ) ) )
Remove o registo Chocolate da origem de dados.Removes the Chocolate record from the data source.

A origem de dados Gelado foi modificada.The IceCream data source has been modified.
Remove( Gelado,
Primeiro( Filtro( Gelado, Sabor="Chocolate" ) ) Primeiro( Filtro( Gelado, Sabor="Morango" ) ) )
Remove( IceCream,
First( Filter( IceCream, Flavor="Chocolate" ) ) First( Filter( IceCream, Flavor="Strawberry" ) ) )
Remove dois registos da origem de dados.Removes two records from the data source.

A origem de dados Gelado foi modificada.The IceCream data source has been modified.
RemoveIf( Gelado, Quantidade > 150 )RemoveIf( IceCream, Quantity > 150 ) Remove os registos que tenham uma Quantidade superior a 150.Removes records that have a Quantity that's greater than 150.

A origem de dados Gelado foi modificada.The IceCream data source has been modified.
RemoveIf( Gelado, Quantidade > 150, Restante( Sabor, 1 ) = "M" )RemoveIf( IceCream, Quantity > 150, Left( Flavor, 1 ) = "S" ) Remove os registos que tenham uma Quantidade superior a 150 e cujo Sabor comece pela letra M.Removes records that have a Quantity that's greater than 150 and Flavor starts with an S.


A origem de dados Gelado foi modificada.The IceCream data source has been modified.
RemoveIf( Gelado, verdadeiro )RemoveIf( IceCream, true ) Remove todos os registos da origem de dados.Removes all records from the data source.

A origem de dados Gelado foi modificada.The IceCream data source has been modified.

Passo a passoStep by step

  1. Importe ou crie uma coleção denominada Inventárioe exiba-a numa galeria tal como descrito em Mostrar dados numa galeria.Import or create a collection named Inventory, and show it in a gallery as Show data in a gallery describes.
  2. Na galeria, defina a propriedade OnSelect da imagem para esta expressão:In the gallery, set the OnSelect property of the image to this expression:
    Remover(Inventário, ThisItem)Remove(Inventory, ThisItem)
  3. Prima F5 e, em seguida, selecione uma imagem na galeria.Press F5, and then select an image in the gallery.
    O item é removido da galeria e da coleção.The item is removed from the gallery and the collection.