EndsWith ja StartsWith funktiot

Koskee seuraavia: Pohjaan perustuvat sovellukset Copilot Studio Desktop työnkulkuja Dataverse-kaavasarakkeet Mallipohjaiset sovellukset Power Platform CLI Dataverse -funktiot Power Pages

Testaa, alkaako tekstimerkkijono toisella merkkijonolla tai päättyykö se toiseen tekstimerkkijonoon.

Kuvaus

Funktio EndsWith testaa, päättyykö tekstimerkkijono toiseen tekstimerkkijonoon.

Funktio StartsWith testaa, alkaako tekstimerkkijono toisella tekstimerkkijonolla.

Kummankaan funktion testeissä kirjainkoolla ei on merkitystä, jos taustatietolähde tukee sitä oletusarvoisesti. Esimerkiksi kokoelmat, Dataverse, SharePoint ja SQL Server tukevat kirjainkoon merkityksettömyyttä oletusarvoisesti. Oracle ei tee näin. Palautusarvo on totuusarvo true tai false.

Käytä EndsWithFilter-funktiota ja StartsWith sen kanssa tietohakuun sovelluksessasi. Voit etsiä mistä tahansa tekstijonojen sisältä, ei pelkästään alusta tai lopusta, käyttämällä in-operaattoria tai Search-funktiota. Funktioiden valinta riippuu sovelluksesi tarpeista ja siitä, mikä funktio tietolähteellesi voidaan delegoida. Jos jotakin näistä funktioista ei voi delegoida, näyttöön ilmestyy muokkaamisen aikana delegointivaroitus, joka varoittaa tästä rajoituksesta.

Syntaksi

EndsWith( Text, EndText )

• Teksti – Pakollinen. Testattava teksti.
• EndText – Pakollinen. Teksti, jota haetaan Teksti-kohdan lopusta. Jos EndText on tyhjä merkkijono, EndsWith palauttaa arvon true.

StartsWith( Text, StartText )

• Teksti – Pakollinen. Testattava teksti.
• StartText – Pakollinen. Teksti, jota haetaan Teksti-kohdan alusta. Jos StartText on tyhjä merkkijono, StartsWith palauttaa arvon true.

Esimerkit

Kaava	Kuvaus	Tulos
EndsWith( "Hello World", "world" )	Testaa, päättyykö ”Hei, Maailma” tekstiin ”maailma”. Testin kirjainkoolla ei ole merkitystä.	true
EndsWith( "Näkemiin", "näke" )	Testaa, päättyykö ”Näkemiin” tekstiin ”näke”. EndText-argumentti (”näke”) esiintyy tekstissä, mutta ei sen lopussa.	false
EndsWith( "Sano aina hei", "hei" )	Testaa, päättyykö ”Sano aina hei” tekstiin ”hei”.	true
EndsWith( "Hei hei", "" )	Testaa, päättyykö ”Hei hei” tyhjään tekstimerkkijonoon (Len palauttaa arvon 0). Sen käytön helpottamiseksi Suodatin-lausekkeissaEndsWith on määritetty palauttamaan tässä tapauksessa arvo true .	true

Kaava	Kuvaus	Tulos
StartsWith( "Hei maailma", "hei" )	Testaa, alkaako ”Hei, Maailma” tekstillä ”hei”. Testin kirjainkoolla ei ole merkitystä.	true
StartsWith( "Näkemiin", "hei" )	Testaa, alkaako ”Näkemiin” tekstillä ”hei”.	false
StartsWith( "Sano aina hei", "hei" )	Testaa, alkaako ”Sano aina hei” tekstillä ”hei”. ”Hei” esiintyy tekstissä, mutta ei sen alussa.	false
StartsWith( "Hei hei", "" )	Testaa, alkaako ”Hei hei” tyhjällä merkkijonolla (Len palauttaa arvon 0). Sen käytön helpottamiseksi Suodatin-lausekkeissaStartsWith on määritetty palauttamaan tässä tapauksessa arvo true .	true

Haun käyttökokemus

Monissa sovelluksissa hakukenttään voi kirjoittaa yhden tai useamman merkin. Tällä tavalla voit suodattaa tietueluetteloita suurissa tietojoukoissa. Luettelossa näytetään vain ne tietueet, jotka vastaavat kirjoittamiasi hakuehtoja.

Loput tämän ohjeaiheen esimerkeistä näyttävät hakutuloksia luettelosta, jonka nimi on Asiakkaat, joka sisältää nämä tiedot:

Luo tämä tietolähde kokoelmana luomalla Button-ohjausobjekti ja määrittämällä sen OnSelect-ominaisuuden arvoksi tämä kaava:

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

Kuten tässä esimerkissä, voit näyttää luettelon Gallery-ohjausobjektin tietueista näytön alareunassa. Näytön yläosassa voit lisätä Text input -ohjausobjektin nimeltä SearchInput, jotta käyttäjät voivat määrittää, mitkä tietueet kiinnostavat heitä.

Kun käyttäjä kirjoittaa merkkejä hakusyötteeseen, valikoiman tuloksia suodatetaan automaattisesti. Tässä tapauksessa valikoima on määritetty näyttämään tietueet, joiden asiakkaan nimi (ei yrityksen nimi) alkaa merkeillä, jotka on syötetty hakusyötteeseen. Jos käyttäjä kirjoittaa hakuruutuun co, valikoima näyttää seuraavat tulokset:

Voit suodattaa Nimi-sarakkeen perusteella määrittämällä valikoiman Items-ominaisuudeksi jonkin seuraavista kaavoista:

Kaava	Kuvaus	Tulos
Filter( Customers, StartsWith( Name, SearchInput.Text ) )	Suodattaa Customers-tietolähteestä tietueet, joiden Name-sarakkeen alussa esiintyy hakumerkkijono. Testin kirjainkoolla ei ole merkitystä. Jos käyttäjä kirjoittaa hakuruutuun co, valikoima näyttää tulokset Colleen Jones ja Cole Miller. Valikoima ei näytä tietuetta Mike Collins, koska sen Name-sarake ei ala hakumerkkijonolla.
Filter( Customers, SearchInput.Text in Name )	Suodattaa Customers-tietolähteestä tietueet, joiden Name-sarakkeen jossain kohdassa esiintyy hakumerkkijono. Testin kirjainkoolla ei ole merkitystä. Jos käyttäjä kirjoittaa hakukenttään co, valikoima näyttää tulokset Colleen Jones, Cole Miller ja Mike Collins, koska hakumerkkijono esiintyy jossain kohdassa tietueen Name-saraketta.
Search( Customers, SearchInput.Text, "Name" )	Search-funktio etsii vastaavuutta missä tahansa kunkin tietueen Name-sarakkeen osassa, samaan tapaan kuin in-operaattori. Huomaa, että sarakkeen nimi on kirjoitettava lainausmerkkeihin.

Voit laajentaa haun sisältämään sekä Company-sarakkeen että Name-sarakkeen:

Kaava	Kuvaus	Tulos
Filter( Customers, StartsWith( Name, SearchInput.Text ) || StartsWith( Company, SearchInput.Text ) )	Suodattaa Customers-tietolähteestä tietueet, joiden Name-sarake tai Company-sarake alkaa hakumerkkijonolla (esimerkiksi co). -||operaattori on true, jos jompikumpi StartsWith funktio on tosi.
Filter( Customers, SearchInput.Text in Name || SearchInput.Text in Company )	Suodattaa Customers-tietolähteestä tietueet, joiden Name-sarakkeen tai Company-sarakkeen jossain kohdassa esiintyy hakumerkkijono (esimerkiksi co).
Search( Customers, SearchInput.Text, "Name", "Company" )	Samoin kuin in-operaattori, Search-funktio hakee Customers-tietolähteestä tietueet, joiden Name-sarakkeen tai Company-sarakkeen jossain kohdassa esiintyy hakumerkkijono (esimerkiksi co). Search-funktio on helpompi lukea ja kirjoittaa kuin Filter-funktio, jos haluat määrittää useita sarakkeita ja useita in-operaattoreita. Huomaa, että sarakkeiden nimet on kirjoitettava lainausmerkkeihin.