Remove os registros de uma fonte de dados.

Descrição

Função Remove

Use a função Remove para remover um ou mais registros específicos de uma fonte de dados.

Para coleções, todo o registro deve ser correspondente. 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.

Função RemoveIf

Use a função RemoveIf para remover um ou mais registros com base em uma condição ou um conjunto de condições. 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. Cada condição é avaliada individualmente para cada registro e o registro é removido se todas as condições são avaliadas como true.

Remover e RemoveIf retorna a fonte de dados modificada como uma tabela. Você pode usar ambas as funções somente nas fórmulas de comportamento.

Você também pode usar a função Limpar para remover todos os registros em uma fonte de dados.

Delegação

Quando usadas com uma fonte de dados, essas funções não podem ser delegadas. Somente a primeira parte da fonte de dados será recuperada, em seguida, a função é aplicada. O resultado pode não representar a história completa. 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. Para obter mais informações, consulte a visão geral da delegação.

Sintaxe

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

  • DataSource – Obrigatório. A fonte de dados que contém o registro ou os registros que você deseja remover.

  • Record(s) - Obrigatório. O registro ou registros a serem removidos.

  • All – opcional. Em uma coleção, o mesmo registro pode aparecer mais de uma vez. Você pode adicionar o argumento All para remover todas as cópias do registro.

Remove( DataSource, Table [, All ] )

  • DataSource – Obrigatório. A fonte de dados que contém o registro ou os registros que você deseja remover.

  • Table – Obrigatório. Uma tabela dos registros a serem removidos.

  • All – opcional. Em uma coleção, o mesmo registro pode aparecer mais de uma vez. Você pode adicionar o argumento All para remover todas as cópias do registro.

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

  • DataSource – Obrigatório. A fonte de dados que contém o registro ou os registros que você deseja remover.

  • Condições – obrigatório. Uma fórmula que é avaliada como true para o registro ou registros a serem removidos. Você pode usar nomes de coluna de DataSource na fórmula. Se você especificar vários Conditions, todas devem ser avaliadas como true para o registro ou registros serem removidos.

Exemplos

Nesses exemplos, você removerá um ou mais registros em uma fonte de dados chamada Sorvete e que começa com os dados nesta tabela:

Fórmula Descrição Resultado
Remove( Sorvete,
First( Filter( Sorvete, Sabor="Chocolate" ) ) )
Remove o registro Chocolate da fonte de dados.

A fonte de dados Sorvete foi modificada.
Remove( Sorvete,
First( Filter( Sorvete, Sabor="Chocolate" ) ) First( Filter( Sorvete, Sabor="Morango" ) ) )
Remove os dois registros da fonte de dados.

A fonte de dados Sorvete foi modificada.
RemoveIf( Sorvete, Quantity > 150 ) Remove os registros que possuem Quantity (quantidade) maior do que 150.

A fonte de dados Sorvete foi modificada.
RemoveIf( Sorvete, Quantity > 150, Left( Sabor, 1 ) = "M" ) Remove os registros que possuem Quantity (quantidade) maior do que 150 e Sabor começando com M.


A fonte de dados Sorvete foi modificada.
RemoveIf ( Sorvete, true) Remove os dois registros da fonte de dados.

A fonte de dados Sorvete foi modificada.

Passo a passo

  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.

  2. Na galeria, defina a propriedade OnSelect da imagem para esta expressão:
    Remove(Inventário, ThisItem)

  3. Pressione F5 e, em seguida, selecione uma imagem na galeria.
    O item é removido da galeria e da coleção.