Funkcije EndsWith i StartsWith

Odnosi se na: Aplikacije od gotovih gradivnih elemenata Stupci formule za tokove Dataverse radne površine CLI aplikacije stvorene Power Platform prema modelu

Ispituje da li jedan tekstni niz počinje ili završava neki drugi tekstni niz.

Opis

Funkcija EndsWith provjerava završava li jedan tekstni niz drugim.

Funkcija StartsWith provjerava počinje li jedan tekstni niz drugim.

Kod obje funkcije testovi ne razlikuju velika i mala slova. Povratna vrijednost obje je Booleovo true ili false.

Koristite EndsWith i StartsWith s funkcijom Filter kako bi se pretraživali podatci unutar vaše aplikacije. Također, možete upotrijebiti operator in ili funkciju Search za traženje bilo gdje unutar tekstnih nizova, a ne samo na početku ili kraju. Vaš izbor funkcija ovisit će o potrebama vaše aplikacije i tome koja funkcija može biti delegirana konkretnom izvoru podataka. Ako jednu od ovih funkcija nije moguće delegirati, pojavit će se upozorenje o delegiranju u vrijeme stvaranja kako bi vas upozorilo na ovo ograničenje.

Sintaksa

EndsWith( tekst, završni tekst )

  • Text – obavezno. Text koji se ispituje.
  • EndText – obavezno. Text koji se traži na kraju teksta. Ako je završni tekst prazan niz, EndsWith vraća true.

StartsWith( tekst, početni tekst )

  • Text – obavezno. Text koji se ispituje.
  • StartText – obavezno. Text koji se traži na početku teksta. Ako je početni tekst prazan niz, StartsWith vraća true.

Primjeri

Formula Opis Rezultat
EndsWith( "Hello World", "world" ) Ispituje završava li se „Hello World” s „world”. Test ne razlikuje velika i mala slova. true
EndsWith( "Good bye", "good" ) Ispituje završava li se „Good bye” s „good”. Argument završni tekst („good”) pojavljuje se u tekstu, ali ne na kraju. false
EndsWith( "Always say hello", "hello" ) Ispituje završava li se „Always say hello” s „hello”. true
EndsWith( "Bye bye", "" ) Ispituje završava li se „Bye bye” praznim tekstnim nizom (Len vraća 0). Olakšavajući njegovu upotrebu u izrazima Filter, EndsWith je definirano tako da u tom slučaju vraća true. true
Formula Opis Rezultat
StartsWith( "Hello World", "hello" ) Ispituje počinje li „Hello World” s „hello”. Test ne razlikuje velika i mala slova. true
StartsWith( "Good bye", "hello" ) Ispituje počinje li „Good bye” s „hello”. false
StartsWith( "Always say hello", "hello" ) Ispituje počinje li „Always say hello” s „hello”. Iako se „hello” pojavljuje u tekstu, nije na njegovom početku. false
StartsWith( "Bye bye", "" ) Ispituje počinje li „Bye bye” praznim tekstnim nizom (Len vraća 0). Olakšavajući njegovu upotrebu u izrazima Filter, StartsWith je definirano tako da u tom slučaju vraća true. true

Korisničko iskustvo pretraživanja

U mnogim aplikacijama možete upisati jedan ili više znakova u okvir za pretraživanje da biste filtrirali popis zapisa u nekom velikom skupu podataka. Dok tipkate, popis prikazuje samo one zapise koji odgovaraju kriterijima pretraživanja.

Primjeri u ostatku ove teme prikazuju rezultate pretraživanja popisa Customers, koji sadrži ove podatke:

Primjer popisa Klijenata.

Da biste stvorili ovaj izvor podataka kao zbirku, stvorite kontrolu Button i postavite svojstvo OnSelect na ovu formulu:

ClearCollect( klijenti, tablica( { ime: "Fred Garcia", tvrtka: "Northwind Traders" }, { ime: "Cole Miller", tvrtka: "Contoso" }, { ime: "Glenda Johnson", tvrtka: "Contoso" }, { ime: "Mike Collins", tvrtka: "Adventure Works" }, { ime: "Colleen Jones", tvrtka: "Adventure Works" } ) )

Kao u ovom primjeru, možete prikazati popis zapisa u kontroli Gallery pri dnu zaslona. Pri vrhu zaslona možete dodati kontrolu Text input, nazvanu SearchInput, tako da korisnici mogu odrediti koje ih zapise zanima.

Galerija klijenata.

Dok korisnik upisuje znakove u SearchInput, rezultati u galeriji automatski se filtriraju. U ovom slučaju, galerija je konfigurirana za prikaz zapisa u kojima ime kupca (a ne ime tvrtke) započinje redoslijedom znakova u SearchInput. Ako korisnik upiše co u okvir za pretraživanje, galerija prikazuje sljedeće rezultate:

Galerija klijenata s pretraživanjem.

Za filtriranje na temelju stupca Name, postavite svojstvo Items kontrole galerije na jednu od ovih formula:

Formula Opis Rezultat
Filter( Customers, StartsWith( Name, SearchInput.Text ) ) Filtrira izvor podataka Customers za zapise u kojima se traženi niz prikazuje na početku stupca Name. Test ne razlikuje velika i mala slova. Ako korisnik upiše co u okvir za pretraživanje, galerija prikazuje Colleen Jones i Cole Miller. Gallery ne prikazuje vrijednost Mike Collins jer stupac Name za taj zapis ne počinje traženim nizom. Primjer StartsWith.
Filter( Customers, SearchInput.Text in Name ) Filtrira izvor podataka Customers za zapise u kojima se traženi niz prikazuje bilo gdje u stupcu Name. Test ne razlikuje velika i mala slova. Ako korisnik upiše co u okvir za pretraživanje, galerija prikazuje Colleen Jones,Cole Miller, i Mike Collins jer se traženi niz pojavljuje negdje u stupcu Name svih tih zapisa. Primjer SearchInput.Text u Nazivu.
Search( Customers, SearchInput.Text, "Name" ) Slično kao kod korištenja operatora in, funkcija Search traži podudaranje bilo gdje unutar stupca Name svakog zapisa. Imajte na umu da naziv stupca morate okružiti dvostrukim navodnicima. Primjer SearchInput.Text s Nazivom.

Možete proširiti pretragu i uključiti stupac Company, kao i stupac Name:

Formula Opis Rezultat
Filtar( klijenti, StartsWith( ime, SearchInput.Text ) || StartsWith( tvrtka, SearchInput.Text ) ) Filtrira izvor podataka Customers za zapise u kojima stupac Name ili stupac Company počinje traženim nizom (na primjer, co). || operator je true ako bilo koja funkcija StartsWith ima rezultat true. Filtrirajte s pomoću StartsWith.
Filtar( Customers, SearchInput.Text in Name || SearchInput.Text in Company ) Filtrira izvor podataka Customers za zapise u kojima stupac Name ili stupac Company sadrži traženi niz (na primjer, co) bilo gdje unutar njega. Filtrirajte s tekstom pretraživanja u nazivu.
Search( Customers, SearchInput.Text, "Name", "Company" ) Slično kao kod korištenja operatora in, funkcija Search traži izvor podataka Customers za zapise u kojima stupac Name ili stupac Company sadrži traženi niz (na primjer, co) bilo gdje unutar njega. Funkcija Search lakše se čita i piše nego funkcija Filter ako želite navesti više stupaca i više operatora in. Imajte na umu da nazive stupaca morate okružiti dvostrukim navodnicima. Filtrirajte s tekstom pretraživanja u nazivu, tvrtki.