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

Remove os registros de uma fonte de dados.Removes records from a data source.

DescriçãoDescription

Função RemoveRemove function

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

Para coleções, todo o registro deve ser correspondente.For collections, the entire record must match. Você pode usar o argumento All para remover todas as cópias de um registro; caso contrário, apenas uma cópia do registro é 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

Use a função RemoveIf para remover um ou mais registros com base em uma condição ou um 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 qualquer fórmula que resulta em true ou false e pode fazer referência às colunas da fonte de dados pelo 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 registro e o registro é removido se todas as condições são avaliadas como true.Each condition is evaluated individually for each record, and the record is removed if all conditions evaluate to true.

Remover e RemoveIf retorna a fonte de dados modificada como uma tabela.Remove and RemoveIf return the modified data source as a table. Você pode usar ambas as funções somente nas fórmulas de comportamento.You can use both functions only in behavior formulas.

Você também pode usar a função Limpar para remover todos os registros em uma fonte de dados.You can also use the Clear function to remove all of the records in a data source.

DelegaçãoDelegation

Quando usadas com uma fonte de dados, essas funções não podem ser delegadas.When used with a data source, these functions can't be delegated. Somente a primeira parte da fonte de dados será recuperada, em seguida, a função é aplicada.Only the first portion of the data source will be retrieved and then the function applied. O resultado pode não representar a história completa.The result may not represent the complete story. Um ponto azul aparecerá no momento da criação para lembrá-lo sobre essa limitação e sugerir mudar para alternativas delegáveis onde for possível.A blue dot will appear at authoring time to remind you of this limitation and to suggest switching to delegable alternatives where possible. Para obter mais informações, consulte a visão geral da delegação.For more information, see the delegation overview.

SintaxeSyntax

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

  • Fonte de dados – Obrigatório.DataSource – Required. A fonte de dados que contém o registro ou os registros que você deseja remover.The data source that contains the record or records that you want to remove.
  • Record(s) - Obrigatório.Record(s) – Required. O registro ou registros a serem removidos.The record or records to remove.
  • All – opcional.All – Optional. Em uma coleção, o mesmo registro pode aparecer mais de uma vez.In a collection, the same record may appear more than once. Você pode adicionar o argumento All para remover todas as cópias do registro.You can add the All argument to remove all copies of the record.

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

  • Fonte de dados – Obrigatório.DataSource – Required. A fonte de dados que contém o registro ou os registros que você deseja remover.The data source that contains the records that you want to remove.
  • Table – Obrigatório.Table – Required. Uma tabela dos registros a serem removidos.A table of records to remove.
  • All – opcional.All – Optional. Em uma coleção, o mesmo registro pode aparecer mais de uma vez.In a collection, the same record may appear more than once. Você pode adicionar o argumento All para remover todas as cópias do registro.You can add the All argument to remove all copies of the record.

RemoveIf( DataSource, Condition [, ... ] )RemoveIf( DataSource, Condition [, ... ] )

  • Fonte de dados – Obrigatório.DataSource – Required. A fonte de dados que contém o registro ou os registros que você deseja remover.The data source that contains the record or records that you want to remove.
  • Condições – obrigatório.Condition(s) – Required. Uma fórmula que é avaliada como true para o registro ou registros a serem removidos.A formula that evaluates to true for the record or records to remove. Você pode usar nomes de coluna de DataSource na fórmula.You can use column names from the DataSource in the formula. Se você especificar vários Conditions, todas devem ser avaliadas como true para o registro ou registros serem removidos.If you specify multiple Conditions, all must evaluate to true for the record or records to be removed.

ExemplosExamples

Nesses exemplos, você removerá um ou mais registros em uma fonte de dados chamada Sorvete 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( Sorvete,
First( Filter( Sorvete, Sabor="Chocolate" ) ) )
Remove( IceCream,
First( Filter( IceCream, Flavor="Chocolate" ) ) )
Remove o registro Chocolate da fonte de dados.Removes the Chocolate record from the data source.

A fonte de dados Sorvete foi modificada.The IceCream data source has been modified.
Remove( Sorvete,
First( Filter( Sorvete, Sabor="Chocolate" ) ) First( Filter( Sorvete, Sabor="Morango" ) ) )
Remove( IceCream,
First( Filter( IceCream, Flavor="Chocolate" ) ) First( Filter( IceCream, Flavor="Strawberry" ) ) )
Remove os dois registros da fonte de dados.Removes two records from the data source.

A fonte de dados Sorvete foi modificada.The IceCream data source has been modified.
RemoveIf( Sorvete, Quantity > 150 )RemoveIf( IceCream, Quantity > 150 ) Remove os registros que possuem Quantity (quantidade) maior do que 150.Removes records that have a Quantity that's greater than 150.

A fonte de dados Sorvete foi modificada.The IceCream data source has been modified.
RemoveIf( Sorvete, Quantity > 150, Left( Sabor, 1 ) = "M" )RemoveIf( IceCream, Quantity > 150, Left( Flavor, 1 ) = "S" ) Remove os registros que possuem Quantity (quantidade) maior do que 150 e Sabor começando com M.Removes records that have a Quantity that's greater than 150 and Flavor starts with an S.


A fonte de dados Sorvete foi modificada.The IceCream data source has been modified.
RemoveIf ( Sorvete, true)RemoveIf( IceCream, true ) Remove os dois registros da fonte de dados.Removes all records from the data source.

A fonte de dados Sorvete foi modificada.The IceCream data source has been modified.

Passo a passoStep by step

  1. Importe ou crie uma coleção chamada Inventário como o primeiro subprocedimento, para isso, leia o artigo Como mostrar texto e imagens em uma 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:
    Remove(Inventário, ThisItem)Remove(Inventory, ThisItem)
  3. Pressione 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.