EndsWith és StartsWith függvények

A következőkre vonatkozik: Vászonalapú alkalmazások Copilot Studio Desktop folyamatok Dataverse képletoszlopok Modellalapú alkalmazások Power Platform CLI Dataverse-függvények Power Pages

Teszteli, hogy egy szöveges sztring egy másik szöveges sztring eleje vagy vége-e.

Ismertetés

A EndsWith függvény ellenőrzi, hogy az egyik szöveges sztring egy másikkal végződik-e.

A StartsWith függvény azt ellenőrzi, hogy az egyik szöveges sztring egy másikkal kezdődik-e.

A tesztek mindkét függvény esetében megkülönböztetik a kis- és nagybetűket, ha a háttéradatforrás alapértelmezés szerint támogatja azt. A gyűjtemények, Dataverse, SharePoint, és a SQL Server például alapértelmezés szerint támogatja a kis- és nagybetűk megkülönböztetését. Az Oracle nem. Mindkét esetben a visszaadott érték egy logikai típusú igaz vagy hamis.

A EndsWith Szűrő függvénnyel és StartsWith a Szűrő függvénnyel kereshet az alkalmazásban lévő adatok között. Az in operátor vagy a Search függvény használatával bárhol lehet keresni a szöveges sztringben, nem csak az elején vagy a végén. A megfelelő függvény kiválasztása függ az alkalmazás igényeitől, illetve attól, hogy melyik függvény delegálható az adott adatforráshoz. Ha valamelyik függvény nem delegálható, erre a korlátozásra a szerkesztéskor megjelenő delegálási figyelmeztetés hívja fel a figyelmet.

Szintaxis

EndsWith( Szöveg, Végszöveg )

• Szöveg – Kötelező. A tesztelendő szöveg.
• EndText – Kötelező. A Szöveg végén keresendő szöveg. Ha a Végszöveg egy üres sztring, EndsWithigaz értéket ad vissza.

StartsWith( Szöveg, StartText )

• Szöveg – Kötelező. A tesztelendő szöveg.
• StartText – Kötelező. A Szöveg elején keresendő szöveg. Ha a StartText egy üres sztring, StartsWithigaz értéket ad vissza.

Példák

Képlet	Ismertetés	Eredmény
EndsWith( "Hello World", "world" )	Azt vizsgálja, hogy a „Hello World” a „world” szóra végződik-e. A teszt nem különbözteti meg a kis- és nagybetűket.	igaz
EndsWith( "Good bye", "good" )	Azt vizsgálja, hogy a „Good bye” a „good” szóval végződik-e. A Szövegvég argumentum („good”) megjelenik ugyan a szövegben, de nem a végén.	téves
EndsWith( "Mindig hello", "hello" )	Azt vizsgálja, hogy az „Always say hello” a „hello” szóra végződik-e.	igaz
EndsWith( "Bye bye", "" )	Azt vizsgálja, hogy a „Bye bye” üres szöveges sztringre végződik-e (a Len visszaadott értéke 0). A szűrőkifejezésekben való használat enyhítése úgy van definiálva, EndsWith hogy ebben az esetben igaz értéket ad vissza.	igaz

Képlet	Ismertetés	Eredmény
StartsWith( "Hello World", "hello" )	Azt vizsgálja, hogy a „Hello World” a „hello” szóval kezdődik-e. A teszt nem különbözteti meg a kis- és nagybetűket.	igaz
StartsWith( "Good bye", "hello" )	Azt vizsgálja, hogy a „Good bye” a „hello” szóval kezdődik-e.	téves
StartsWith( "Mindig hello", "hello" )	Azt vizsgálja, hogy „Always say hello” a „hello” szóval kezdődik-e. Bár a „hello” szerepel a szövegben, nem az elején jelenik meg.	téves
StartsWith( "Bye bye", "" )	Azt vizsgálja, hogy a „Bye bye” üres szöveges sztringgel kezdődik-e (a Len visszaadott értéke 0). A szűrőkifejezésekben való használat enyhítése úgy van definiálva, StartsWith hogy ebben az esetben igaz értéket ad vissza.	igaz

Keresési felhasználói élmény

Sok alkalmazásban ha karaktereket ír be a keresőmezőbe, azzal szűrni tudja a nagy adatkészletek rekordjainak listáját. A karakterek begépelésével a lista egyre rövidebb lesz, és csak azok a rekordok jelennek meg, amelyek megfelelnek a keresési feltételnek.

A témakör további részében található példák egy Customers (Ügyfelek) nevű lista keresési eredményét mutatják, amely a következő adatokat tartalmazza:

Ha ezt az adatforrást szeretné létrehozni gyűjteményként, akkor hozzon létre egy Gomb vezérlőelemet, és az OnSelect tulajdonság értékeként adja meg a következő képletet:

ClearCollect( Ügyfelek, Tábla( { Név: "Fred Garcia", Cég: "Northwind Traders" }, { Név: "Cole Miller", Cég: "Contoso" }, { Név: "Glenda Johnson", Cég: "Contoso" }, { Név: "Mike Collins", Cég: "Adventure Works" }, { Név: "Colleen Jones", Cég: "Adventure Works" } ) )

Ahogy a példában is látható, megjeleníthet egy rekordlistát egy Katalógus vezérlőelemben a képernyő alján. A képernyő tetején felvehet egy Szövegbevitel vezérlőelemet, SearchInput (Keresés bemenete) névvel, így a felhasználók megadhatják, hogy milyen rekordok érdeklik őket.

Ahogy a felhasználó karaktereket gépel a SearchInput mezőbe, a rendszer automatikusan szűri a katalógus eredményeit. Ebben az esetben a katalógus arra van konfigurálva, hogy megjelenítse azon rekordokat, ahol a felhasználó neve (nem a vállalat neve) a SearchInput mezőben megadott karakterlánccal kezdődik. Ha a felhasználó begépeli a co karaktereket a keresőmezőbe, a katalógus a következő eredményeket jeleníti meg:

A Name (Név) oszlop alapján történő szűréshez a katalógus vezérlőelem Elemek tulajdonságának értékeként adja meg a következő képletek valamelyikét:

Képlet	Ismertetés	Eredmény
Filter( Customers, StartsWith( Name, SearchInput.Text ) )	Kiszűri a Customers (Ügyfelek) adatforrásból azon rekordokat, ahol a keresési sztring szerepel a Name (Név) oszlop elején. A teszt nem különbözteti meg a kis- és nagybetűket. Ha a felhasználó begépeli a co karaktereket a keresőmezőbe, a katalógusban megjelenik Colleen Jones és Cole Miller. Mike Collins nem jelenik meg a katalógusban, mivel a rekord Name (Név) oszlopának nem az elején szerepel a keresési sztring.
Filter( Ügyfelek, SearchInput.Text a névben )	Kiszűri a Customers (Ügyfelek) adatforrásból azon rekordokat, ahol a keresési sztring a Name (Név) oszlopban bárhol szerepel. A teszt nem különbözteti meg a kis- és nagybetűket. Ha a felhasználó begépeli a co karaktereket a keresőmezőbe, a katalógusban megjelenik Colleen Jones,Cole Miller és Mike Collins is, mivel a keresési sztring mindegyik rekord esetében szerepel valahol a Name (Név) oszlopban.
Search( Ügyfelek, SearchInput.Text, "Név" )	Az in operátor működéséhez hasonlóan a Search függvény az egyes rekordok Name (Név) mezőin belül bárhol keresi az egyezéseket. Vegye figyelembe, hogy az oszlop nevét dupla idézőjelbe ("") kell tenni.

Kiterjesztheti a keresést úgy, hogy a Company (Vállalat) és a Name (Név) oszlopban is keressen:

Képlet	Ismertetés	Eredmény
Filter( Customers, StartsWith( Name, SearchInput.Text ) || StartsWith( Cég, SearchInput.Text )	Kiszűri a Customers (Ügyfelek) adatforrásból azon rekordokat, ahol a keresési sztring (például co) szerepel akár a Name (Név), akár a Company (Vállalat) oszlop elején. Az || operátorigaz , ha bármelyik StartsWith függvény igaz.
Filter( Ügyfelek, SearchInput.Text a névben || SearchInput.Text a vállalatnál )	Kiszűri a Customers (Ügyfelek) adatforrásból azon rekordokat, ahol a keresési sztring (például co) bárhol szerepel akár a Name (Név), akár a Company (Vállalat) oszlopban.
Search( Ügyfelek, SearchInput.Text, "Név", "Vállalat" )	Az in operátor működéséhez hasonlóan a Search függvény kiszűri a Customers (Ügyfelek) adatforrásból azon rekordokat, ahol a keresési sztring (például co) bárhol szerepel akár a Name (Név), akár a Company (Vállalat) oszlopban. A Search függvényt könnyebb olvasni és megírni, mint a Filter függvényt, ha több oszlopot és több in operátort szeretnénk megadni. Vegye figyelembe, hogy az oszlopok neveit dupla idézőjelbe ("") kell tenni.