EndsWith- og StartsWith-funksjonene

Gjelder: Lerretsapper Skrivbordsflyt Dataverse-formelkolonner Modelldrevne apper Power Platform CLI

Tester om én tekststreng begynner eller slutter med en annen tekststreng.

Beskrivelse

EndsWith-funksjonen tester om én tekststreng slutter med en annen tekststreng.

StartsWith-funksjonen tester om én tekststreng begynner med en annen tekststreng.

Testene med begge funksjonene skiller ikke mellom små eller store bokstaver. Returverdien til begge er en boolsk sann- eller usann-verdi.

Bruk EndsWith og StartsWith med Filter-funksjonen for å søke i dataene i appen din. Du kan også bruke in-operatoren eller Search-funksjonen for å søke hvor som helst i tekststrenger, ikke bare i begynnelsen eller slutten. Funksjonene du velger, avhenger av behovet til appen og hvilke funksjoner som kan delegeres for din bestemte datakilde. Hvis én av disse funksjonene ikke kan delegeres, vises det en delegeringsadvarsel under redigeringen for å advare deg om denne begrensningen.

Syntaks

EndsWith( Text, EndText )

• Text – obligatorisk. Teksten som skal testes.
• EndText – obligatorisk. Teksten det skal søkes etter på slutten av Text. Hvis EndText er en tom streng, returnerer EndsWithsann.

StartsWith( Text, StartText )

• Text – obligatorisk. Teksten som skal testes.
• StartText – obligatorisk. Teksten det skal søkes etter i begynnelsen av Text. Hvis StartText er en tom streng, returnerer StartsWithsann.

Eksempler

Formel	Beskrivelse	Resultat
EndsWith( "Hello World", "world" )	Tester om "Hello World" slutter på "world". Testen skiller ikke mellom små og store bokstaver.	true
EndsWith( "Good bye", "good" )	Tester om "Good bye" slutter på "good". EndText-argumentet ("good") vises i teksten, men ikke på slutten.	false
EndsWith( "Always say hello", "hello" )	Tester om "Always say hello" slutter med "hello".	true
EndsWith( "Bye bye", "" )	Tester om "Bye bye" slutter på en tom tekststeng (Len returnerer 0). Det er enkelt å bruke EndsWith i Filter-uttrykk, og er angitt for å returnere sann i dette tilfellet.	true

Formel	Beskrivelse	Resultat
StartsWith( "Hello World", "hello" )	Tester om "Hello World" begynner med "hello". Testen skiller ikke mellom små og store bokstaver.	true
StartsWith( "Good bye", "hello" )	Tester om "Good bye" begynner med "hello".	false
StartsWith( "Always say hello", "hello" )	Tester om "Always say hello" begynner med "hello". Selv om "hello" vises i teksten, vises det ikke i begynnelsen.	false
StartsWith( "Bye bye", "" )	Tester om "Bye bye" begynner med en tom tekststeng (Len returnerer 0). Det er enkelt å bruke StartsWith i Filter-uttrykk, og er angitt for å returnere sann i dette tilfellet.	true

Brukeropplevelse for søk

I mange apper kan du skrive ett eller flere tegn i en søkeboks for å filtrere en liste over poster i et stort datasett. Mens du skriver viser listen bare de postene som samsvarer med søkevilkårene.

Eksemplene i resten av dette temaet viser resultatene av å søke i en Kunde-liste som inneholder disse dataene:

Hvis du vil opprette denne datakilden som en samling, oppretter du en Button-kontroll og angir egenskapen OnSelect til denne formelen:

ClearCollect(Customers, Table({ Name: "Fred Garcia", Company: "Northwind Traders" }, { Name: "Cole Miller", Company: "Contoso" }, { Name: "Glenda Johnson", Company: "Contoso" }, { Name: "Mike Collins", Company: "Adventure Works" }, { Name: "Colleen Jones", Company: "Adventure Works" }) )

Som du ser av dette eksemplet, kan du vise en liste over poster i en Gallery-kontroll nederst på skjermen. Nær toppen av skjermen kan du legge til en Text input-kontroll, som heter SearchInput, slik at brukerne kan angi hvilke poster de har interesse av.

Mens brukeren skriver tegn i SearchInput, filtreres resultatene i galleriet automatisk. I dette tilfellet er galleriet konfigurert til å vise poster der navnet på kunden (ikke navnet på firmaet) begynner med tegnsekvensen i SearchInput. Hvis brukeren skriver inn bj i søkeboksen, viser galleriet disse resultatene:

Hvis du vil filtrere basert på kolonnen Name, angir du egenskapen Items for Galleri-kontrollen til én av disse formlene:

Formel	Beskrivelse	Resultat
Filter( Customers, StartsWith( Name, SearchInput.Text ) )	Filtrerer Kunder-datakilden for poster der søkestrengen vises i begynnelsen av Navn-kolonnen. Testen skiller ikke mellom små og store bokstaver. Hvis brukeren skriver bj i søkeboksen, viser galleriet Bjarne Høgdal og Bjørn Rosendal. Galleriet viser ikke Finn Andresen, fordi kolonnen Name for den posten begynner ikke med den søkestrengen.
Filter( Customers, SearchInput.Text in Name )	Filtrerer Kunder-datakilden for poster der søkestrengen vises hvor som helst i Navn-kolonnen. Testen skiller ikke mellom små og store bokstaver. Hvis brukeren skriver jb i søkeboksen, viser galleriet Bjarne Høgdal,Bjørn Rosendal, og Bjarte Andresen, fordi søkestrengen finnes et sted Navn-kolonnen i alle postene.
Search( Customers, SearchInput.Text, "Name" )	Funksjonen Search ligner på operatoren in, og den søker etter et treff hvor som helst i Navn-kolonnen for hver post. Vær oppmerksom på at du må omslutte kolonnenavnet i doble anførselstegn.

Du kan utvide søket til å inkludere kolonnen Bedrift så vel som kolonnen Navn:

Formel	Beskrivelse	Resultat
Filter( Customers, StartsWith( Name, SearchInput.Text ) || StartsWith( Company, SearchInput.Text ) )	Filtrerer datakilden Customers for posten der enten kolonnen Name eller Company begynner med søkestrengen (for eksempel bj). ||-operatoren er sann hvis begge funksjonene StartsWith er sann.
Filter( Customers, SearchInput.Text in Name || SearchInput.Text in Company )	Filtrerer Kunder-datakilden for posten der enten Navn-kolonnen eller Bedrift-kolonnen inneholder søkestrengen (for eksempel bj).
Search( Customers, SearchInput.Text, "Name", "Company" )	Funksjonen Search ligner på operatoren in, og den søker i datakilden Kunder etter posten der enten Navn-kolonnen eller Bedrift-kolonnen inneholder søkestrengen (for eksempel bj). Funksjonen Search er enklere å lese og skrive enn Filter hvis du ønsker å angi flere kolonner og operatorer som in. Vær oppmerksom på at du må omslutte kolonnenavnet i doble anførselstegn.