Funktionerne EndsWith og StartsWith

  • Artikel

Gælder for: Lærredsapps Skrivebordsflows Dataverse formelkolonner Modeldrevne apps Power Platform CLI

Tester, om en tekststreng begynder eller slutter med en anden tekststreng.

Beskrivelse

Funktionen EndsWith tester, om en tekststreng slutter med en anden.

Funktionen StartsWith tester, om en tekststreng begynder med en anden.

Der skelnes ikke mellem store og små bogstaver i testene for de to funktioner. Returværdien for begge funktioner er boolesk sand eller falsk.

Brug EndsWith og StartsWith med funktionen Filter for at søge efter data i appen. Du kan også bruge operatoren in eller funktionen Search for at søge overalt i tekststrengene og ikke kun i begyndelsen eller slutningen. Dit valg af funktioner afhænger af, hvilke funktioner der er brug for i din app, og hvilken funktion der kan delegeres for den pågældende datakilde. Hvis en af funktionerne ikke kan delegeres, vises en delegeringsadvarsel, når du redigerer, så du bliver gjort opmærksom på begrænsningen.

Syntaks

EndsWith(Text, EndText)

  • Text – påkrævet. Den tekst, der skal testes.
  • EndText – påkrævet. Den tekst, der skal søges efter i slutningen af Text. Hvis EndText er en tom streng, returnerer EndsWith værdien sand.

StartsWith(Text, StartText)

  • Text – påkrævet. Den tekst, der skal testes.
  • StartText – påkrævet. Den tekst, der skal søges efter i begyndelsen af Text. Hvis StartText er en tom streng, returnerer StartsWith værdien sand.

Eksempler

Formel Beskrivelse Resultat
EndsWith( "Hello World", "world" ) Tester, om "Hello World" slutter med "world". Der skelnes ikke mellem store og små bogstaver i testen. true
EndsWith( "Good bye", "good" ) Tester, om "Good bye" slutter med "good". Argumentet EndText ("good") findes i teksten men ikke i slutningen. false
EndsWith( "Always say hello", "hello" ) Tester, om "Always say hello" slutter med "hello". true
EndsWith( "Bye bye", "" ) Tester, om "Bye bye" slutter med en tom tekststreng (Len returnerer 0). Udtrykket EndsWith er defineret som sand i dette tilfælde for at gøre det nemmere at bruge Filter-udtryk. true
Formel Beskrivelse Resultat
StartsWith( "Hello World", "hello" ) Tester, om "Hello World" starter med "hello". Der skelnes ikke mellem store og små bogstaver i testen. true
StartsWith( "Good bye", "hello" ) Tester, om "Good bye" starter med "hello". false
StartsWith( "Always say hello", "hello" ) Tester, om "Always say hello" starter med "hello". Selvom "hello" findes i teksten, vises det ikke i starten. false
StartsWith( "Bye bye", "" ) Tester, om "Bye bye" starter med en tom tekststreng (Len returnerer 0). StartsWith er defineret til at returnere sand for at gøre det nemmere at bruge Filter-udtryk. true

Søgebrugeroplevelse

I mange apps kan du skrive et eller flere tegn i søgefeltet for at filtrere en liste over poster i et stort datasæt. Når du skriver, vises kun de poster, der opfylder søgekriterierne.

Eksemplerne i resten af dette emne viser søgeresultaterne for en Kunder-liste, der indeholder følgende data:

Eksempel på kundeliste.

Hvis du vil oprette denne datakilde som en samling, skal du oprette et Button-kontrolelement og angive dets OnSelect-egenskab til denne formel:

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" } ) )

Ligesom i dette eksempel kan du få vist en liste over poster i et Gallery-kontrolelement nederst i skærmbilledet. Næsten øverst i skærmbilledet kan du tilføje et Text input-kontrolelement, som hedder SearchInput, så brugerne kan angive, hvilke poster de er interesserede i.

Kundernes galleri.

Når brugeren skriver tegn i SearchInput, filtreres resultaterne i galleriet automatisk. I dette tilfælde er galleriet konfigureret til at vise de poster, hvor kundenavnet (ikke navnet på virksomheden) starter med rækkefølgen af de tegn, der angives i SearchInput. Hvis brugeren skriver ka i søgefeltet, vises følgende resultater i galleriet:

Kundernes galleri med søgning.

Hvis du vil filtrere på kolonnen Name, skal du indstille egenskaben Items for gallerikontrolelementet til en af disse formler:

Formel Beskrivelse Resultat
Filter( Customers, StartsWith( Name, SearchInput.Text ) ) Filtrerer Customers-datakilden, så de poster, hvor søgestrengen vises i starten af kolonnen Name, vises. Der skelnes ikke mellem store og små bogstaver i testen. Hvis brugeren skriver co i søgefeltet, vises Colleen Jones og Cole Miller i galleriet. Mike Collins vises ikke i galleriet, da kolonnen Name for den post ikke starter med søgestrengen. Eksempel på StartsWith.
Filter( Customers, SearchInput.Text in Name ) Filtrerer datakilden Customers, så det er de poster, hvor søgestrengen vises hvor som helst i kolonnen Name, der vises. Der skelnes ikke mellem store og små bogstaver i testen. Hvis brugeren skriver co i søgefeltet, vises Colleen Jones,Cole Miller, og Mike Collins, fordi søgestrengen findes et sted i kolonnen Navn i alle de pågældende poster. Eksempel på SearchInput.Text i navn.
Search( Customers, SearchInput.Text, "Name" ) Funktionen Search søger efter et match hvor som helst i kolonnen Name for hver enkelt post. Det svarer til at bruge operatoren in. Bemærk, at du skal bruge dobbelte anførselstegn rundt om kolonnenavnet. Eksempel på SearchInput.Text med navn.

Du kan udvide søgningen til at omfatte kolonnen Company og kolonnen Name:

Formel Beskrivelse Resultat
Filter( Customers, StartsWith( Name, SearchInput.Text ) || StartsWith( Company, SearchInput.Text ) ) Filtrerer datakilden Customers, så de poster, hvor kolonnen Name eller kolonnen Company starter med søgestrengen (f.eks. co), vises. ||-operatoren er sand, hvis en af funktionerne StartsWith er sand. Filter med StartsWith.
Filter( Customers, SearchInput.Text in Name || SearchInput.Text in Company ) Filtrerer datakilden Customers, så de poster, hvor kolonnen Name eller kolonnen Company indeholder søgestrengen (f.eks. co), vises. Filter med søgetekst i navn.
Search( Customers, SearchInput.Text, "Name", "Company" ) Funktionen Search søger i datakilden Customer efter de poster, hvor kolonnen Name eller Company indeholder søgestrengen (f.eks. co), vises. Det svarer til at bruge operatoren in. Funktionen Search er nemmere at læse og skrive end Filter, hvis du vil angive flere kolonner og flere operatorer af typen in. Bemærk, at du skal bruge dobbelte anførselstegn rundt om kolonnenavnene. Filtrer med søgetekst i navn, firma.