Funciones EndsWith y StartsWith en PowerAppsEndsWith and StartsWith functions in PowerApps

Comprueba si una cadena de texto comienza o termina con otra cadena de texto.Tests whether a text string begins or ends another text string.

DescripciónDescription

La función EndsWith comprueba si una cadena de texto termina con otra.The EndsWith function tests whether one text string ends with another.

La función StartsWith comprueba si una cadena de texto comienza con otra.The StartsWith function tests whether one text string begins with another.

Para ambas funciones, las pruebas no distinguen mayúsculas de minúsculas.For both functions, the tests are case insensitive. El valor devuelto por ambas es un valor booleano true o false.The return value of both is a Boolean true or false.

Use EndsWith y StartsWith con la función Filter para buscar los datos dentro de la aplicación.Use EndsWith and StartsWith with the Filter function to search the data within your app. También puede usar el operador in o la función Search para realizar una búsqueda en cualquier lugar dentro de las cadenas de texto, no solo al principio o al 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. La selección de las funciones dependerá de las necesidades de la aplicación y las funciones que se pueden delegar para el origen de datos específico.Your choice of functions will depend on the needs of your app and which function can be delegated for your particular data source. Si una de estas funciones no se puede delegar, aparecerá un punto azul en el momento de la creación para avisarle de esta limitación.If one of these functions can't be delegated, a blue dot will appear at authoring time to warn you of this limitation.

SintaxisSyntax

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

  • Texto: requerido.Text – Required. Texto que se va a probar.The text to test.
  • EndText: requerido.EndText – Required. Texto que desea buscar al final de Text.The text to search for at the end of Text. Si EndText es una cadena vacía, EndsWith devuelve true.If EndText is an empty string, EndsWith returns true.

StartsWith( Text, StartText )StartsWith( Text, StartText )

  • Texto: requerido.Text – Required. Texto que se va a probar.The text to test.
  • StartText: requerido.StartText – Required. El texto que desea buscar al principio de Text.The text to search for at the beginning of Text. Si StartText es una cadena vacía, StartsWith devuelve true.If StartText is an empty string, StartsWith returns true.

EjemplosExamples

FórmulaFormula DescripciónDescription ResultadoResult
EndsWith( "Hola mundo", "mundo" )EndsWith( "Hello World", "world" ) Comprueba si "Hola mundo" termina con "mundo".Tests whether "Hello World" ends with "world". La prueba no distingue mayúsculas de minúsculas.The test is case insensitive. truetrue
EndsWith( "Hasta luego", "hasta" )EndsWith( "Good bye", "good" ) Comprueba si "Hasta luego" termina con "hasta".Tests whether "Good bye" ends with "good". El argumento EndText ("hasta") aparece en el texto, pero no al final.The EndText argument ("good") appears in the text but not at the end. falsefalse
EndsWith( "Di siempre hola", "hola" )EndsWith( "Always say hello", "hello" ) Comprueba si "Di siempre hola" termina con "hola".Tests whether "Always say hello" ends with "hello". truetrue
Endswith( "Adios", "" )Endswith( "Bye bye", "" ) Comprueba si "Adios" termina con una cadena vacía (Len devuelve 0).Tests whether "Bye bye" ends with an empty text string (Len returns 0). Para facilitar su uso en expresiones Filter, EndsWith está definida para devolver true en este caso.Easing its use in Filter expressions, EndsWith is defined to return true in this case. truetrue
FórmulaFormula DescripciónDescription ResultadoResult
StartsWith( "Hello World", "hello" )StartsWith( "Hello World", "hello" ) Prueba si "Hello World" comienza con "hello".Tests whether "Hello World" begins with "hello". La prueba no distingue mayúsculas de minúsculas.The test is case insensitive. truetrue
StartsWith( "Good bye", "hello" )StartsWith( "Good bye", "hello" ) Prueba si "Good bye" comienza con "hello".Tests whether "Good bye" begins with "hello". falsefalse
StartsWith( "Always say hello", "hello" )StartsWith( "Always say hello", "hello" ) Prueba si "Always say hello" comienza con "hello".Tests whether "Always say hello" begins with "hello". Aunque "hello" aparece en el texto, no aparece al principio.Although "hello" appears in the text, it doesn't appear at the beginning. falsefalse
StartsWith( "Adios", "" )StartsWith( "Bye bye", "" ) Comprueba si "Adios" comienza con una cadena vacía (Len devuelve 0).Tests whether "Bye bye" starts with an empty text string (Len returns 0). Para facilitar su uso en expresiones Filter, StartsWith está definida para devolver true en este caso.Easing its use in Filter expressions, StartsWith is defined to return true in this case. truetrue

Experiencia de búsqueda del usuarioSearch user experience

En muchas aplicaciones, puede escribir uno o varios caracteres en un cuadro de búsqueda para filtrar una lista de registros en un conjunto de datos grande.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. A medida que escribe, la lista muestra solo los registros que coinciden con los criterios de búsqueda.As you type, the list shows only those records that match the search criteria.

Los ejemplos que aparecen en el resto de este tema muestran los resultados de buscar en una lista Clientes, que contiene estos datos:The examples in the rest of this topic show the results of searching a Customers list that contains this data:

Para crear este origen de datos como una colección, cree un control Botón y establezca la propiedad AlSeleccionar en esta fórmula:To create this data source as a collection, create a Button control and set its OnSelect property to this formula:

ClearCollect( Clientes, Tabla( { Nombre: "Fred Garcia", Empresa: "Northwind Traders" }, { Nombre: "Cole Miller", Empresa: "Contoso" }, { Nombre: "Glenda Johnson", Empresa: "Contoso" }, { Nombre: "Mike Collins", Empresa: "Adventure Works" }, { Nombre: "Colleen Jones", Empresa: "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" } ) )

Como en este ejemplo, puede mostrar una lista de registros en un control Galería en la parte inferior de una pantalla.As in this example, you can show a list of records in a Gallery control at the bottom of a screen. Cerca de la parte superior de la pantalla, puede agregar un control Entrada de texto denominado SearchInput, de modo que los usuarios puedan especificar los registros que más les interesen.Near the top of the screen, you can add a Text input control, named SearchInput, so that users can specify which records interest them.

A medida que el usuario escribe caracteres en SearchInput, automáticamente se filtran los resultados en la galería.As the user types characters in SearchInput, the results in the gallery are automatically filtered. En este caso, se configura la galería para que muestre los registros para los que el nombre del cliente (no el nombre de la empresa) comienza con la secuencia de caracteres de SearchInput. Si el usuario escribe co en el cuadro de búsqueda, la galería muestra estos 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 según la columna Nombre, establezca la propiedad Elementos del control Galería en una de estas fórmulas:To filter based on the Name column, set the Items property of the gallery control to one of these formulas:

FórmulaFormula DescripciónDescription ResultadoResult
Filtrar( Clientes, StartsWith( Nombre, SearchInput.Text ) )Filter( Customers, StartsWith( Name, SearchInput.Text ) ) Filtra el origen de datos Clientes para los registros en los que la cadena de búsqueda aparece al principio de la columna Nombre.Filters the Customers data source for records in which the search string appears at the start of the Name column. La prueba no distingue mayúsculas de minúsculas.The test is case insensitive. Si el usuario escribe co en el cuadro de búsqueda, la galería mostrará Colleen Jones y Cole Miller.If the user types co in the search box, the gallery shows Colleen Jones and Cole Miller. La galería no mostrará Mike Collins porque la columna Nombre de ese registro no comienza por la cadena de búsqueda.The gallery doesn't show Mike Collins because the Name column for that record doesn't start with the search string.
Filtrar( Clientes, SearchInput.Text in Name )Filter( Customers, SearchInput.Text in Name ) Filtra el origen de datos Clientes para los registros en los que la cadena de búsqueda aparece en cualquier parte de la columna Nombre.Filters the Customers data source for records in which the search string appears anywhere in the Name column. La prueba no distingue mayúsculas de minúsculas.The test is case insensitive. Si el usuario escribe co en el cuadro de búsqueda, la galería mostrará Colleen Jones, Cole Miller y Mike Collins ya que la cadena de búsqueda aparece en algún lugar de la columna Nombre de todos esos 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.
Buscar( Clientes, SearchInput.Text, "Nombre" )Search( Customers, SearchInput.Text, "Name" ) De forma parecida al uso del operador in, la función Buscar busca una coincidencia en cualquier parte de la columna Nombre de cada registro.Similar to using the in operator, the Search function searches for a match anywhere within the Name column of each record. Tenga en cuenta que debe incluir el nombre de la columna entre comillas dobles.Note that you must enclose the column name in double quotation marks.

Puede expandir la búsqueda para incluir la columna Empresa además de la columna Nombre:You can expand your search to include the Company column as well as the Name column:

FórmulaFormula DescripciónDescription ResultadoResult
Filtrar( Clientes, StartsWith( Nombre, SearchInput.Text ) || StartsWith( Empresa, SearchInput.Text ) )Filter( Customers, StartsWith( Name, SearchInput.Text ) || StartsWith( Company, SearchInput.Text ) ) Filtra el origen de datos Clientes de aquellos registros en los que la columna Nombre o la columna Empresa comienza por la cadena de búsqueda (por ejemplo, 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). El operador || será true si la función StartsWith es también true.The || operator is true if either StartsWith function is true.
Filtrar( Clientes, SearchInput.Text en Nombre || SearchInput.Text en Empresa )Filter( Customers, SearchInput.Text in Name || SearchInput.Text in Company ) Filtra el origen de datos Clientes de aquellos registros en los que la columna Nombre o la columna Empresa contienen la cadena de búsqueda en cualquier lugar (por ejemplo, co).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.
Buscar( Clientes, SearchInput.Text, "Nombre", "Empresa" )Search( Customers, SearchInput.Text, "Name", "Company" ) De forma parecida al uso del operador in, la función Buscar busca en el origen de datos Clientes aquellos registros en los que la columna Nombre o la columna Empresa contienen la cadena de búsqueda en cualquier lugar (por ejemplo, co).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. La función Buscar es más fácil de leer y escribir que Filtrar si desea especificar varias columnas y varios operadores in.The Search function is easier to read and write than Filter if you want to specify multiple columns and multiple in operators. Tenga en cuenta que debe incluir los nombres de las columnas entre comillas dobles.Note that you must enclose the names of the columns in double quotation marks.