EndsWith și StartsWith funcții

Se aplică la: Aplicațiile Pânză Copilot Studio Desktop fluxurilor de dateVerse coloane de formule Model aplicații bazate pe platforma Power Platform CLI Dataverse funcții Power Pages

Testează dacă un șir de text începe sau se termină cu un alt șir de text.

Descriere

Funcția EndsWith testează dacă un șir text se termină cu altul.

Funcția StartsWith testează dacă un șir text începe cu altul.

Pentru ambele funcții, testele nu fac distincție între majuscule și minuscule dacă sursa de date back-end o acceptă implicit. De exemplu, colecțiile, Dataverse, SharePoint și SQL Server acceptă în mod implicit lipsa de diferență cu majuscule și minuscule. Oracle nu. Valoarea de returnare pentru ambele este o valoare booleană true sau false.

Utilizați EndsWith și StartsWith cu funcția Filter pentru a căuta în datele din aplicație. Puteți utiliza, de asemenea, operatorul in sau funcția Search pentru a căuta oriunde în șirurile de text, nu doar la început sau la sfârșit. Alegerea funcțiilor de către dvs. va depinde de necesitățile aplicației dvs. și de funcțiile care pot fi delegate pentru respectiva sursă de date. Dacă una dintre aceste funcții nu poate fi delegată, în momentul creării va apărea un avertisment de delegare pentru a vă avertiza cu privire la această limitare.

Sintaxă

EndsWith( Text, Text final )

• Text – Obligatoriu. Textul de testat.
• EndText – Obligatoriu. Textul de căutat la sfârșitul textului. Dacă EndText este un șir gol, EndsWith returnează true.

StartsWith( Text, Text StartText )

• Text – Obligatoriu. Textul de testat.
• StartText – Obligatoriu. Textul de căutat la începutul textului. Dacă StartText este un șir gol, StartsWith returnează true.

Exemple

Formulă	Descriere	Rezultat
EndsWith( "Bună lume", "lume" )	Testează dacă "Hello World" se termină cu "world". Testul nu este sensibil la literele mari și mici.	adevărat
EndsWith( "La revedare", "bun" )	Testează dacă "Good bye" se termină cu "good". Argumentul EndText ("good") apare în text, dar nu la sfârșit.	fals
EndsWith( "Spuneți întotdeauna salut", "salut" )	Testează dacă "Always say hello" se termină cu "hello".	adevărat
EndsWith( "Bye bye", "" )	Testează dacă "Bye bye" se termină cu un șir de text gol (Len returnează 0). Easing its use in Filter expressions, EndsWith is defined to return true in this case.	adevărat

Formulă	Descriere	Rezultat
StartsWith( "Hello World", "hello" )	Testează dacă "Hello World" începe cu "hello". Testul nu este sensibil la literele mari și mici.	adevărat
StartsWith( "La revedere", "salut" )	Testează dacă "Good bye" începe cu "hello".	fals
StartsWith( "Spuneți întotdeauna salut", "salut" )	Testează dacă "Always say hello" începe cu "hello". Deși "hello" apare în text, acesta nu apare la început.	fals
StartsWith( "Bye bye", "" )	Testează dacă "Bye bye" începe cu un șir de text gol (Len returnează 0). Easing its use in Filter expressions, StartsWith is defined to return true in this case.	adevărat

Experiența de căutare a utilizatorului

În multe aplicații, puteți tasta unul sau mai multe caractere într-o casetă de căutare pentru a filtra o listă de înregistrări într-un set mare de date. Pe măsură ce tastați, lista afișează doar acele înregistrări care corespund criteriilor de căutare.

Exemplele din cadrul acestui subiect arată rezultatele căutării unei liste de Clienți, care conține aceste date:

Pentru a crea această sursă de date ca o colecție, creați un control Button și setați proprietatea acestuia OnSelect conform următoarei formule:

ClearCollect( Clienți, Tabel( { Nume: „Fred Garcia”, Companie: „Comercianți Northwind” }, { Nume: „Cole Miller”, Companie: „Contoso” }, { Nume: „Glenda Johnson”, Companie: „Contoso” }, { Nume: „Mike Collins”, Companie: „Adventure Works” }, { Nume: „ Colleen Jones", Compania: "Adventure Works" } ) )

După cum se arată în acest exemplu, puteți afișa o listă de înregistrări într-un Control galerie în partea de jos a unui ecran. În partea de sus a ecranului, puteți adăuga un control Introducere text, numit SearchInput, astfel încât utilizatorii să poată specifica ce înregistrări îi interesează.

Pe măsură ce utilizatorul tastează caractere în SearchInput, rezultatele din galerie sunt filtrate automat. În acest caz, galeria este configurată pentru a afișa înregistrări pentru care numele clientului (nu numele companiei) începe cu secvența de caractere din SearchInput.Dacă utilizatorul tastează co în caseta de căutare, galeria prezintă următoarele rezultate:

Pentru a filtra pe baza coloanei Name, setați proprietatea Items a controlului galeriei la una dintre aceste formule:

Formulă	Descriere	Rezultat
Filter( Clienți, StartsWith( Nume, SearchInput.Text ) )	Filtrează sursa de date Customers pentru înregistrări în care șirul de căutare apare la începutul coloanei Name. Testul nu este sensibil la literele mari și mici. Dacă utilizatorul tastează co în caseta de căutare, galeria afișează Colleen Jones și Cole Miller. Galeria nu afișează Mike Collins deoarece coloana Name pentru respectiva înregistrare nu începe cu șirul de căutare.
Filtru (Clienți, SearchInput.Text in Name)	Filtrează sursa de date Customers pentru înregistrări în care șirul de căutare apare oriunde în coloana Name. Testul nu este sensibil la literele mari și mici. Dacă utilizatorul tastează co în caseta de căutare, galeria afișează Colleen JonesCole Miller, și Mike Collins deoarece șirul de căutare apare într-o anumită parte a coloanei Name pentru toate acele înregistrări.
Căutare (Clienți, SearchInput.Text, „Nume”)	Asemenea operatorului in, funcția Search caută o potrivire oriunde în interiorul coloanei Name a fiecărei înregistrări. Rețineți că numele coloanei trebuie pus între ghilimele duble.

Puteți extinde căutarea pentru a include coloana Company, precum și coloana Name:

Formulă	Descriere	Rezultat
Filter( Clienți, StartsWith( Nume, SearchInput.Text ) || StartsWith( Firmă, SearchInput.Text ) )	Filtrează sursa de date Customers pentru înregistrări în care coloana Name sau coloana Company începe cu șirul de căutare (de exemplu, co). Operatorul|| este adevărat dacă oricare StartsWith dintre funcții este adevărată.
Filtru (Clienți, SearchInput.Text în Nume || SearchInput.Text în Company )	Filtrează sursa de date Customers pentru înregistrări în care coloana Name sau coloana Company conține șirul de căutare (de exemplu, co) oriunde în interior.
Căutare( Clienți, SearchInput.Text, „Nume”, „Companie”)	Asemenea operatorului in, funcția Search caută în sursa de date Customers înregistrări în care coloana Name sau Company conține șirul de căutare (de exemplu, co) oriunde în interior. Funcția Search este mai ușor de citit și de scris decât Filter dacă doriți să specificați mai multe coloane și mai mulți operatori in. Rețineți că numele coloanelor trebuie pus între ghilimele duble.