Funções EndsWith e StartsWith no PowerAppsEndsWith and StartsWith functions in PowerApps

Testa se uma cadeia de texto começa ou termina outra cadeia de texto.Tests whether a text string begins or ends another text string.

DescriçãoDescription

A função EndsWith testa se uma cadeia de texto começa com outra.The EndsWith function tests whether one text string ends with another.

A função StartsWith testa se uma cadeia de texto começa com outra cadeia de texto.The StartsWith function tests whether one text string begins with another.

Para ambas as funções, os testes não diferenciam maiúsculas de minúsculas.For both functions, the tests are case insensitive. O valor retornado é um booliano true ou false.The return value of both is a Boolean true or false.

Use EndsWith e StartsWith com a função Filter para pesquisar os dados no aplicativo.Use EndsWith and StartsWith with the Filter function to search the data within your app. Use também o operador in ou a função Search para pesquisar em qualquer lugar das cadeias de texto, não apenas no início ou no final.You can also use the in operator or the Search function to look anywhere within text strings, not just at the beginning or end. Sua escolha de funções dependerá das necessidades de seu aplicativo e de qual função pode ser delegada para sua fonte de dados específica.Your choice of functions will depend on the needs of your app and which function can be delegated for your particular data source. Se uma dessas funções não puder ser delegada, um ponto azul aparecerá no momento da criação para avisá-lo sobre essa limitação.If one of these functions can't be delegated, a blue dot will appear at authoring time to warn you of this limitation.

SintaxeSyntax

EndsWith( Text, EndText )EndsWith( Text, EndText )

  • Texto – Obrigatório.Text – Required. O texto a ser testado.The text to test.
  • EndText – obrigatório.EndText – Required. O texto a ser pesquisado no início de Text.The text to search for at the end of Text. Se EndText for uma cadeia de caracteres vazia, EndsWith retornará true.If EndText is an empty string, EndsWith returns true.

StartsWith( Texto, TextoInicial )StartsWith( Text, StartText )

  • Texto – Obrigatório.Text – Required. O texto a ser testado.The text to test.
  • TextoInicial – Obrigatório.StartText – Required. O texto a ser pesquisado no início do Texto.The text to search for at the beginning of Text. Se TextoInicial for uma cadeia de caracteres vazia, StartsWith retornará true.If StartText is an empty string, StartsWith returns true.

ExemplosExamples

FórmulaFormula DescriçãoDescription ResultadoResult
EndsWith( "Hello World", "world" )EndsWith( "Hello World", "world" ) Testa se "Hello World" termina com "world".Tests whether "Hello World" ends with "world". O teste diferencia maiúsculas de minúsculas.The test is case insensitive. truetrue
EndsWith( "Good bye", "good" )EndsWith( "Good bye", "good" ) Testa se "Good bye" termina com "good".Tests whether "Good bye" ends with "good". O argumento EndText ("good") aparece no texto, mas não no final.The EndText argument ("good") appears in the text but not at the end. falsefalse
EndsWith( "Always say hello", "hello" )EndsWith( "Always say hello", "hello" ) Testa se "Always say hello" termina com "hello".Tests whether "Always say hello" ends with "hello". truetrue
Endswith( "Bye bye", "" )Endswith( "Bye bye", "" ) Testa se "Bye bye" termina com uma cadeia de texto vazia (Len retorna 0).Tests whether "Bye bye" ends with an empty text string (Len returns 0). Facilitando seu uso em expressões Filter, EndsWith é definido para retornar true nesse caso.Easing its use in Filter expressions, EndsWith is defined to return true in this case. truetrue
FórmulaFormula DescriçãoDescription ResultadoResult
StartsWith( "Olá Mundo", "olá" )StartsWith( "Hello World", "hello" ) Testa se "Olá Mundo" começa com "olá".Tests whether "Hello World" begins with "hello". O teste diferencia maiúsculas de minúsculas.The test is case insensitive. truetrue
StartsWith( "Até logo", "logo" )StartsWith( "Good bye", "hello" ) Testa se "Até logo" começa com "logo".Tests whether "Good bye" begins with "hello". falsefalse
StartsWith( "Sempre diga olá", "olá" )StartsWith( "Always say hello", "hello" ) Testa se "Sempre diga olá" começa com "olá".Tests whether "Always say hello" begins with "hello". Embora "olá" apareça no texto, ele não aparece no início.Although "hello" appears in the text, it doesn't appear at the beginning. falsefalse
StartsWith( "Bye bye", "" )StartsWith( "Bye bye", "" ) Testa se "Bye bye" começa com uma cadeia de texto vazia (Len retorna 0).Tests whether "Bye bye" starts with an empty text string (Len returns 0). Facilitando seu uso em expressões Filter, StartsWith é definido para retornar true nesse caso.Easing its use in Filter expressions, StartsWith is defined to return true in this case. truetrue

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 Clientes que contém esses dados:The examples in the rest of this topic show the results of searching a Customers list that contains this data:

Para criar essa fonte de dados como uma coleção, crie um controle Botão e defina sua propriedade OnSelect como esta fórmula:To create this data source as a collection, create a Button control and set its OnSelect property to this formula:

ClearCollect( Customers, Table( { Name: "Fred Garcia", Company: "Northwind Traders" }, { Name: "Cole Miller", Company: "Contoso" }, { Name: "Glenda Johnson", Company: "Contoso" }, { Name: "Mike Collins", Company: "Adventure Works" }, { Name: "Colleen Jones", Company: "Adventure Works" } ) )ClearCollect( Customers, Table( { Name: "Fred Garcia", Company: "Northwind Traders" }, { Name: "Cole Miller", Company: "Contoso" }, { Name: "Glenda Johnson", Company: "Contoso" }, { Name: "Mike Collins", Company: "Adventure Works" }, { Name: "Colleen Jones", Company: "Adventure Works" } ) )

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. Se o usuário digita co na caixa de pesquisa, a galeria mostra estes resultados: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.If the user types co in the search box, the gallery shows these results:

Para filtrar com base na coluna Nome, 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:

FórmulaFormula DescriçãoDescription ResultadoResult
Filter( Customers, StartsWith( Name, SearchInput.Text ) )Filter( Customers, StartsWith( Name, SearchInput.Text ) ) 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.
Search( Customers, SearchInput.Text, "Name" )Search( Customers, SearchInput.Text, "Name" ) 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:

FórmulaFormula DescriçãoDescription ResultadoResult
Filter( Customers, StartsWith( Name, SearchInput.Text ) || StartsWith( Company, SearchInput.Text ) )Filter( Customers, StartsWith( Name, SearchInput.Text ) || StartsWith( Company, SearchInput.Text ) ) 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.
Search( Customers, SearchInput.Text, "Name", "Company" )Search( Customers, SearchInput.Text, "Name", "Company" ) 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.