Finalitza amb i IniciaAmb funcions

S'aplica a: Aplicacions del llenç Fluxos d'escriptori Columnes Dataverse de fórmules Aplicacions Power Pages Power Platform basades en models CLI

Prova si una cadena de text comença o finalitza amb una altra cadena de text.

Descripció

La funció EndsWith prova si una cadena de text acaba amb una altra.

La funció StartsWith prova si una cadena de text comença amb una altra.

Per a ambdues funcions, les proves distingeixen entre majúscules i minúscules. El valor de retorn de totes dues funcions és un booleà true o false.

Utilitzeu EndsWith i StartsWith amb la funció Filter per cercar les dades de l'aplicació. També podeu utilitzar l'operador in o la funció Search per cercar en qualsevol part de les cadenes de text, no només al principi ni al final. L'elecció de les funcions dependrà de les necessitats de l'aplicació i la funció que es pot delegar per a la font de dades concreta. Si una d'aquestes funcions no es pot delegar, un advertiment de delegació apareixerà al moment de la creació per avisar-vos d'aquesta limitació.

Sintaxi

EndsWith(Text, EndText)

• Text: obligatori. El text que es provarà.
• EndText: obligatori. El text que es cercarà al final de Text. Si EndText és una cadena buida, EndsWith torna true.

StartsWith(Text, StartText)

• Text: obligatori. El text que es provarà.
• StartText: obligatori. El text que es cercarà al començament de Text. Si StartText és una cadena buida, StartsWith torna true.

Exemples

Fórmula	Descripció	Resultat
EndsWith("Hola món", "món")	Prova si "Hola món" acaba amb "món". La prova no distingeix entre majúscules i minúscules.	true
EndsWith("Adeu", "ad")	Prova si "Adeu" acaba amb "ad". L'argument EndText ("ad") apareix al text, però no al final.	false
EndsWith("Sempre digues hola", "hola")	Prova si "Sempre digues hola" acaba amb "hola".	true
EndsWith("Adeu", "")	Prova si "Adeu" acaba amb una cadena de text buida (Len torna 0). En facilitar-ne l'ús en expressions Filter, EndsWith es defineix per retornar true en aquest cas.	true

Fórmula	Descripció	Resultat
StartsWith("Hola món", "hola")	Prova si "Hola món" comença per "hola". La prova no distingeix entre majúscules i minúscules.	true
StartsWith("Adeu", "hola")	Prova si "Adeu" comença per "hola".	false
StartsWith("Sempre digues hola", "hola")	Prova si "Sempre digues hola" comença per "hola". Tot i que "hola" apareix al text, no apareix a l'inici.	false
StartsWith("Adeu", "")	Prova si "Adeu" comença per una cadena de text buida (Len torna 0). En facilitar-ne l'ús en expressions Filter, StartsWith es defineix per retornar true en aquest cas.	true

Experiència de cerca de l'usuari

En moltes aplicacions, podeu escriure un o més caràcters en un quadre de cerca per filtrar una llista de registres en un conjunt de dades gran. A mesura que teclegeu, la llista només mostra els registres que coincideixen amb els criteris de cerca.

Els exemples de la resta d'aquest tema mostren els resultats de la cerca d'una llista Clients que conté aquestes dades:

Per crear aquesta font de dades com una col·lecció, creeu un control Botó i definiu-ne la propietat OnSelect en aquesta fórmula:

ClearCollect(Clients, Taula({ Nom: "Fred Garcia", Empresa "Northwind Traders" }, { Nom: "Cole Miller", Empresa: "Contoso" }, { Nom: "Glenda Johnson", Empresa: "Contoso" }, { Nom: "Mike Collins", Empresa: "Adventure Works" }, { Nom: "Colleen Jones", Empresa: "Adventure Works" }) )

Com en aquest exemple, podeu mostrar una llista de registres en un control Galeria a la part inferior d'una pantalla. A prop de la part superior de la pantalla, podeu afegir un control Entrada de text, anomenat SearchInput, de tal manera que els usuaris puguin especificar els registres que els interessen.

A mesura que l'usuari escriu caràcters a SearchInput, els resultats de la galeria es filtren automàticament. En aquest cas, la galeria es configura per mostrar els registres on el nom del client (no el nom de l'empresa) comença per la seqüència de caràcters de SearchInput. Si l'usuari escriu co al quadre de cerca, la galeria mostra aquests resultats:

Per filtrar segons la columna Nom, definiu la propietat Items del control de galeria en una d'aquestes fórmules:

Fórmula	Descripció	Resultat
Filter(Clients, StartsWith(Nom, SearchInput.Text))	Filtra la font de dades Clients per als registres en els quals apareix la cadena de cerca a l'inici de la columna Nom. La prova no distingeix entre majúscules i minúscules. Si l'usuari escriu co al quadre de cerca, la galeria mostra Colleen Jones i Cole Miller. La galeria no mostra Mike Collins perquè la columna Nom d'aquest registre no comença per la cadena de cerca.
Filter(Clients, StartsWith, SearchInput.Text in Nom)	Filtra la font de dades Clients per als registres en els quals apareix la cadena de cerca a qualsevol part de la columna Nom. La prova no distingeix entre majúscules i minúscules. Si l'usuari escriu co al quadre de cerca, la galeria mostra Colleen Jones, Cole Miller, i Mike Collins perquè la cadena de cerca apareix a qualsevol part de la columna Nom de tots aquests registres.
Search(Clients, SearchInput.Text, "Nom")	De la mateixa que l'operador in, la funció Search cercarà una coincidència a qualsevol part de la columna Nom de cada registre. Tingueu en compte que heu de delimitar el nom de la columna entre cometes dobles.

Podeu ampliar la cerca per incloure la columna Empresa juntament amb la columna Nom:

Fórmula	Descripció	Resultat
Filter(Clients, StartsWith(Nom, SearchInput.Text) || StartsWith(Empresa, SearchInput.Text))	Filtra la font de dades Clients per als registres en els quals la columna Nom o la columna Empresa comença amb la cadena de cerca (per exemple, co). L'operador || és true si alguna funció StartsWith és true.
Filter(Clients, SearchInput.Text in Nom || SearchInput.Text in Empresa)	Filtra la font de dades Clients per als registres en els quals la columna Nom o la columna Empresa conté la cadena de cerca (per exemple, co) a qualsevol part.
Search(Clients, SearchInput.Text, "Nom", "Empresa")	Semblant a l'ús de l'operador in, la funció Search cerca a la font de dades Clients registres en els quals la columna Nom o la columna Empresa conté la cadena de cerca (per exemple, co) a qualsevol part. La funció Search és més fàcil de llegir i escriure que Filter si voleu especificar diverses columnes i diversos operadors in. Tingueu en compte que heu de delimitar els noms de les columnes entre cometes dobles.