Neste artigo

DescriçãoDescription

A função Filtrar localiza registros em uma tabela que atendem a uma fórmula.The Filter function finds records in a table that satisfy a formula.Use Filtrar para localizar um conjunto de registros que correspondem a um ou mais critérios e descartar aqueles que não correspondem.Use Filter to find a set of records that match one or more criteria and to discard those that don't.

A função Pesquisa localiza o primeiro registro em uma tabela que corresponda a uma fórmula.The LookUp function finds the first record in a table that satisfies a formula.Use a função Pesquisa para localizar um único registro que corresponda a um ou mais critérios.Use LookUp to find a single record that matches one or more criteria.

Para ambos os casos, a fórmula é avaliada para cada registro da tabela.For both, the formula is evaluated for each record of the table.Registros que resultam em true são incluídos no resultado.Records that result in true are included in the result.Além de operadores de fórmula normal, você pode usar os operadores in e exactin para correspondências de subsequências.Besides the normal formula operators, you can use the in and exactin operators for substring matches.

Os campos do registro que estão sendo atualmente processados estão disponíveis dentro da fórmula.Fields of the record currently being processed are available within the formula.Basta referenciá-los por nome como você faria com qualquer outro valor.You simply reference them by name as you would any other value.Também é possível fazer referência a propriedades de controle e a outros valores de todo o seu aplicativo.You can also reference control properties and other values from throughout your app.Para obter mais detalhes, consulte os exemplos abaixo e trabalhando com escopo de registro.For more details, see the examples below and working with record scope.

Se a delegação não for possível, o PowerApps extrairá um pequeno conjunto de registros para trabalhar no local.If delegation is not possible, PowerApps will pull down only a small set of records to work on locally.As funções de filtro e de classificação operarão em um conjunto reduzido de registros.Filter and sort functions will operate on a reduced set of records.O que está disponível na Galeria talvez não seja a história completa, que pode ser confusa para os usuários.What is available in the Gallery may not be the complete story, which could be confusing to users.

SintaxeSyntax

Formula(s) – Obrigatório.Formula(s) - Required.A fórmula com a qual cada registro da tabela é avaliado.The formula by which each record of the table is evaluated.A função retorna todos os registros que resultam em true.The function returns all records that result in true.É possível referenciar colunas dentro da tabela.You can reference columns within the table.Se você fornecer mais de uma fórmula, os resultados de todas as fórmulas serão combinados com a função And.If you supply more than one formula, the results of all formulas are combined with the And function.

ReductionFormula – Opcional.ReductionFormula - Optional.Essa fórmula é avaliada em um registro que foi encontrado e, depois, reduz o registro a um único valor.This formula is evaluated over the record that was found, and then reduces the record to a single value.É possível referenciar colunas dentro da tabela.You can reference columns within the table.Se você não usar esse parâmetro, a função retornará o registro completo da tabela.If you don't use this parameter, the function returns the full record from the table.Na interface do usuário, a sintaxe é mostrada como resultado acima da caixa de função.In the UI, the syntax is shown as result above the function box.

Procura um registro com Flavor igual a "Chocolate", que há um.Searches for a record with Flavor equal to "Chocolate", of which there is one.Para o primeiro registro for encontrado, retorna a Quantity desse registro.For the first record that's found, returns the Quantity of that record.

Procura um registro com Flavor igual a "Vanilla", que há um.Searches for a record with Flavor equal to "Vanilla", of which there is one.Como nenhuma fórmula de redução foi fornecida, todo o registro é retornado.Since no reduction formula was supplied, the entire record is returned.

Experiência do usuário de pesquisaSearch user experience

Em muitos aplicativos, você pode digitar um ou mais caracteres em uma caixa de pesquisa para filtrar uma lista de registros de um grande conjunto de dados.In many apps, you can type one or more characters into a search box to filter a list of records in a large data set.Conforme você digita, a lista mostra apenas os registros que correspondem aos critérios da pesquisa.As you type, the list shows only those records that match the search criteria.

Os exemplos no restante deste tópico mostram os resultados da pesquisa em uma lista chamada Clientes que contém esses dados:The examples in the rest of this topic show the results of searching a list, named Customers, that contains this data:

Assim como neste exemplo, você pode mostrar uma lista de registros em um Controle de galeria na parte inferior da tela.As in this example, you can show a list of records in a Gallery control at the bottom of a screen.Próximo à parte superior da tela, adicione um controle Entrada de texto, chamado SearchInput, para que os usuários possam especificar quais registros os interessam.Near the top of the screen, you can add a Text input control, named SearchInput, so that users can specify which records interest them.

Conforme o usuário digita os caracteres em SearchInput, os resultados da galeria são filtrados automaticamente.As the user types characters in SearchInput, the results in the gallery are automatically filtered.Nesse caso, a galeria está configurada para mostrar os registros dos quais o nome do cliente (não o nome da empresa) começa com a sequência de caracteres em SearchInput.In this case, the gallery is configured to show records for which the name of the customer (not the name of the company) starts with the sequence of characters in SearchInput.Se o usuário digitar co na caixa de pesquisa, a galeria mostrará estes resultados:If the user types co in the search box, the gallery shows these results:

Para filtrar com base na coluna Name, defina a propriedade Items do controle da galeria como uma destas fórmulas:To filter based on the Name column, set the Items property of the gallery control to one of these formulas:

Filtra a fonte de dados Clientes em busca de registros nos quais a cadeia de caracteres de pesquisa apareça no início da coluna Name.Filters the Customers data source for records in which the search string appears at the start of the Name column.O teste diferencia maiúsculas de minúsculas.The test is case insensitive.Se o usuário digitar co na caixa de pesquisa, a galeria mostrará Colleen Jones e Cole Miller.If the user types co in the search box, the gallery shows Colleen Jones and Cole Miller.A Galeria não mostra Mike Collins, porque a coluna Name desse registro não começa com a cadeia de caracteres de pesquisa.The gallery doesn't show Mike Collins because the Name column for that record doesn't start with the search string.

Filter( Customers, SearchInput.Text in Name )Filter( Customers, SearchInput.Text in Name )

Filtra a fonte de dados Customers em busca de registros nos quais a cadeia de caracteres de pesquisa apareça em qualquer lugar da coluna Name.Filters the Customers data source for records in which the search string appears anywhere in the Name column.O teste diferencia maiúsculas de minúsculas.The test is case insensitive.Se o usuário digitar co na caixa de pesquisa, a galeria mostrará Colleen Jones,Cole Miller e Mike Collins, pois a cadeia de caracteres de pesquisa aparecerá em algum lugar da coluna Name de todos os registros.If the user types co in the search box, the gallery shows Colleen Jones,Cole Miller, and Mike Collins because the search string appears somewhere in the Name column of all of those records.

Assim como o operador in, a função Pesquisar procura uma correspondência em qualquer lugar da coluna Name de cada registro.Similar to using the in operator, the Search function searches for a match anywhere within the Name column of each record.Observe que você deve colocar o nome da coluna entre aspas duplas.Note that you must enclose the column name in double quotation marks.

Você pode expandir sua pesquisa para incluir a coluna Company, bem como a coluna Name:You can expand your search to include the Company column as well as the Name column:

Filtra a fonte de dados Customers em busca de registros nos quais a coluna Name ou a coluna Company comece com a cadeia de caracteres de pesquisa (por exemplo, co).Filters the Customers data source for records in which either the Name column or the Company column starts with the search string (for example, co).O operador || será true se a função StartsWith for true.The || operator is true if either StartsWith function is true.

Filter( Customers, SearchInput.Text in Name || SearchInput.Text in Company )Filter( Customers, SearchInput.Text in Name || SearchInput.Text in Company )

Filtra a fonte de dados Customers em busca de registros nos quais a coluna Name ou a coluna Company contenham a cadeia de caracteres de pesquisa (por exemplo, co em qualquer lugar).Filters the Customers data source for records in which either the Name column or the Company column contains the search string (for example, co) anywhere within it.

Assim como o operador in, a função Pesquisar pesquisa na fonte de dados Customers por registros nos quais a coluna Name ou a coluna Company contém a cadeia de caracteres de pesquisa (por exemplo, co) em qualquer lugar.Similar to using the in operator, the Search function searches the Customers data source for records in which either the Name column or the Company column contains the search string (for example, co) anywhere within it.A função Pesquisar é mais fácil de ler e gravar do que Filtrar se quiser especificar várias colunas e vários operadores in.The Search function is easier to read and write than Filter if you want to specify multiple columns and multiple in operators.Observe que você deve colocar os nomes de coluna entre aspas duplas.Note that you must enclose the names of the columns in double quotation marks.

Note

The feedback system for this content will be changing soon. Old comments will not be carried over. If content within a comment thread is important to you, please save a copy. For more information on the upcoming change, we invite you to read our blog post.