EndsWith i StartsWith funcions

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

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

Descripció

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

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

Per a ambdues funcions, les proves no distingeixen entre majúscules i minúscules si la font de dades del back-end ho admet per defecte. Per exemple, les col·leccions, Dataverse, SharePoint, i SQL Server admeten la insensibilitat entre majúscules i minúscules per defecte. Oracle no. El valor de retorn de totes dues funcions és un booleà true o false.

Utilitzeu EndsWith i StartsWith amb la funció Filtre 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 retorna 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 retorna 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.	veritable
EndsWith( "Adéu", "bé" )	Prova si "Adeu" acaba amb "ad". L'argument EndText ("ad") apareix al text, però no al final.	fals
EndsWith( "Sempre digues hola", "hola")	Prova si "Sempre digues hola" acaba amb "hola".	veritable
EndsWith( "Adéu", "")	Prova si "Adeu" acaba amb una cadena de text buida (Len torna 0). Facilitar el seu ús en expressions de filtre , EndsWith es defineix per retornar true en aquest cas.	veritable

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.	veritable
StartsWith( "Adéu", "hola")	Prova si "Adeu" comença per "hola".	fals
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.	fals
StartsWith( "Adéu", "")	Prova si "Adeu" comença per una cadena de text buida (Len torna 0). Facilitar el seu ús en expressions de filtre , StartsWith es defineix per retornar true en aquest cas.	veritable

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", Companyia: "Adventure Works" }, { Nom: "Colleen Jones", Companyia: "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, SearchInput.Text al 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.
Cerca( 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 cert si alguna de les StartsWith funcions és certa.
Filter( Clients, SearchInput.Text al nom || SearchInput.Text a l'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.
Cerca( 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.