EndsWith ja StartsFunktsioonidega

Kehtib: lõuendirakendused Töölauavoogude Dataverse valemiveerud Mudelipõhised rakendused Power Platform CLI

Kontrollib, kas tekstistring alustab või lõpetab teist tekstistringi.

Kirjeldus

Funktsioon EndsWith kontrollib, kas üks tekstistring lõpeb teisega.

Funktsioon StartsWith kontrollib, kas üks tekstistring algab teisega.

Mõlema funktsiooni puhul on testid tõstutundlikud. Mõlema tagastusväärtus on loogiliselt true või false.

Kasutage funktsioone EndsWith ja StartsWith koos funktsiooniga Filter, et otsida rakendusest andmeid. Samuti saate kasutada tehtemärki in või funktsiooni Otsi, et otsida kõikjalt tekstistringist, mitte ainult algusest või lõpust. Teie valitud funktsioonid sõltuvad teie rakenduse vajadustest ja sellest, millist funktsiooni saab delegeerida teie konkreetsele andmeallikasle. Kui ühte nendest funktsioonidest ei saa delegeerida, kuvatakse koostamise ajal delegatsioonide hoiatus, et teid sellest piirangust hoiatada.

Süntaks

EndsWith( Text, EndText )

• Tekst – nõutav. Tekst kontrollimiseks.
• EndText – Nõutav. Tekst, mida soovite teksti Text lõpus otsida. Kui EndText on tühi string, tagastab EndsWith väärtuse true.

StartsWith( Text, StartText )

• Tekst – nõutav. Tekst kontrollimiseks.
• StartText – Nõutav. Tekst, mida soovite teksti Text alguses otsida. Kui StartText on tühi string, tagastab StartsWith väärtuse true.

Näited

Valem	Kirjeldus	Tulem
EndsWith( "Hello World", "world" )	Kontrollib, kas "Hello World" lõpeb väärtusega "world". Test on tõstutundlik.	true
EndsWith( "Good bye", "good" )	Kontrollib, kas "Good bye" lõpeb väärtusega "good". Argument EndText ("good") kuvatakse tekstina, kuid mitte lõpus.	false
EndsWith( "Always say hello", "hello" )	Kontrollib, kas "Always say hello" lõpeb väärtusega "hello".	true
EndsWith( "Bye bye", "" )	Kontrollib, kas "Bye bye" lõpeb tühja tekstistringiga (Len tagab väärtuse 0). Muudab selle kasutamise lihtsamaks valemites Filter, funktsioon EndsWith on määratletud sellisel juhul tagama väärtuse true.	true

Valem	Kirjeldus	Tulem
StartsWith( "Hello World", "hello" )	Kontrollib, kas "Hello World" algab väärtusega "hello". Test on tõstutundlik.	true
StartsWith( "Good bye", "hello" )	Kontrollib, kas "Good bye" algab väärtusega "hello".	false
StartsWith( "Always say hello", "hello" )	Kontrollib, kas "Always say hello" algeb väärtusega "hello". Kuigi tekstis kuvatakse "hello", ei kuvata seda alguses.	false
StartsWith( "Bye bye", "" )	Kontrollib, kas "Bye bye" algab tühja tekstistringiga (Len returns 0). Muudab selle kasutamise lihtsamaks valemites Filter, funktsioon StartsWith on määratletud sellisel juhul tagama väärtuse true.	true

Kasutaja otsingukogemus

Paljudes rakendustes saate otsinguväljale ühe või mitu märki tippida suure andmekogumiku kirjeteloendi filtreerimiseks. Tippimisel kuvatakse loendis ainult need kirjed, mis vastavad otsingukriteeriumidele.

Ülejäänud näited selles teemas näitavad loendist Kliendid, mis sisaldab neid andmeid, otsimise tulemusi:

Selle andmeallika loomiseks kogumikuna looge juhtelement Button ja määrake selle atribuut OnSelect.

ClearCollect( Kliendid, tabel( { Nimi: „Fred Garcia”, Ettevõte: „Northwind Traders” }, { Nimi: „Cole Miller”, Ettevõte: „Contoso” }, { Nimi: „Glenda Johnson”, Ettevõte: „Contoso” }, { Nimi: „Mike Collins”, Ettevõte: „Adventure Works” }, { Nimi: „Colleen Jones”, Ettevõte: „Adventure Works” } ) )

Nagu käesolevas näites, saate kuvada kirjeteloendi juhtelemenis Galerii ekraani allservas. Ekraani ülaosa lähedal saate lisada juhtelemendi Text input nimega SearchInput, et kasutajad saaksid määrata, millised kirjed neid huvitavad.

Kui kasutaja tipib märke väljale SearchInput, filtreeritakse galerii tulemused automaatselt. Sel juhul on galerii konfigureeritud kuvama kirjeid, mille jaoks kliendi nimi (mitte ettevõtte nimi) algab väärtuses SearchInput tärkide jadaga. Kui kasutaja tipib otsinguväljale co, kuvab galerii järgmised tulemused.

Veeru Nimi põhjal filtreerimiseks seadke galerii juhtelemendi atribuudi Üksused väärtuseks üks järgmistest valemitest.

Valem	Kirjeldus	Tulem
Filter( Customers, StartsWith( Name, SearchInput.Text ) )	Filtreerib andmeallikast Kliendid kirjed, milles otsitav string kuvatakse veeru Nimi alguses. Test on tõstutundlik. Kui kasutaja tipib otsinguväljale co, näitab galerii Colleen Jones ja Cole Miller. Galerii ei näita Mike Collins, sest selle kirje veerg Nimi ei alga otsingustringiga.
Filter( Customers, SearchInput.Text in Name )	Filtreerib andmeallikast Kliendid kirjed, milles otsitav string kuvatakse veeru Nimi mistahes kohas. Test on tõstutundlik. Kui kasutaja tipib otsinguväljale co, näitab galerii Colleen Jones,Cole Miller ja Mike Collins, sest otsingustring kuvatakse kusagil nende kirjete veerus Nimi.
Search( Customers, SearchInput.Text, "Name" )	Sarnaselt tehtemärgi in kasutamisega, funktsioon Search otsib vastet mistahes kohas kõikide kirjete hulgast veerus Nimi. Pange tähele, et veeru nimi tuleb lisada jutumärkidesse.

Saate laiendada otsingut nii et see hõlmab veergu Ettevõte, nagu ka veergu Nimi:

Valem	Kirjeldus	Tulem
Filter( Kliendid, StartsWith( Nimi, SearchInput.Text ) || StartsWith( Ettevõte, SearchInput.Text ) )	Filtreerib andmeallika Kliendid kirjed, milles kas veerud Nimi või Ettevõte algavad otsingustringiga (nt co). ||Tehtemärk on tõene, kui funktsioon StartsWith on tõene.
Filter( Kliendid, SearchInput.Text nimes || SearchInput.Text ettevõttes )	Filtreerib andmeallika Kliendid kirjed, milles kas veerg Nimi või Ettevõte sisaldab mistahes kohas otsingustringi (nt co).
Search( Customers, SearchInput.Text, "Name", "Company" )	Sarnaselt tehtemärgi in kasutamisele funktsioon Search andmeallika Kliendid kirjetest, kus veerg Nimi või Ettevõte sisaldab mistahes kohas otsingustringi (nt co). Funktsiooni Search on lihtsam lugeda ja kirjutada kui funktsiooni Filter, kui soovite määrata mitut veergu ja mitut in tehtemärki. Pange tähele, et veergude nimed tuleb lisada jutumärkidesse.