KončíS a ZačínaS funkciami

Vzťahuje sa na: Aplikácie plátna Postupy v počítačovom prostredí Stĺpce Dataverse vzorcov Modelom riadené aplikácie Power Platform CLI

Testuje, či textovým reťazcom začína alebo končí iný textový reťazec.

Popis

Funkcia EndsWith testuje, či jeden textový reťazec končí iným textovým reťazcom.

Funkcia StartsWith testuje, či jeden textový reťazec začína iným textovým reťazcom.

Testy pri oboch funkciách nerozlišujú malé a veľké písmená. Vrátená hodnota je logická hodnota true alebo false.

Funkcie EndsWith a StartsWith môžete používať s funkciou Filter na vyhľadávanie údajov v aplikácii. Pomocou operátora in alebo funkcie Search môžete tiež vyhľadávať kdekoľvek v textových reťazcoch, nie iba na ich začiatku alebo konci. To, ktoré funkcie si vyberiete, bude závisieť na potrebách aplikácie a na tom, ktorú funkciu môžete pre konkrétny zdroj údajov delegovať. Ak niektorú z týchto funkcií nemožno delegovať, zobrazí sa pri vytváraní upozornenie týkajúce sa delegovania upozorňujúce na toto obmedzenie.

Syntax

EndsWith( Text, EndText )

• Text – povinné. Text, ktorý chcete otestovať.
• EndText – povinné. Text, ktorý chcete vyhľadať na konci reťazca Text. Ak je EndText prázdny reťazec, EndsWith vráti hodnotu true.

StartsWith( Text, StartText )

• Text – povinné. Text, ktorý chcete otestovať.
• StartText – povinné. Text, ktorý chcete vyhľadať na začiatku reťazca Text. Ak je StartText prázdny reťazec, StartsWith vráti hodnotu true.

Príklady

Vzorec	Popis	Výsledok
EndsWith ("Hello World", "world")	Otestuje, či reťazec "Hello World" končí reťazcom "world". V teste sa nerozlišujú malé a veľké písmená.	pravda
EndsWith( "Good bye", "good" )	Otestuje, či reťazec "Good bye" končí reťazcom "good". Argument EndText ("good") sa síce v texte nachádza, ale nie na jeho konci.	false
EndsWith( "Always say hello", "hello" )	Otestuje, či reťazec "Always say hello" končí reťazcom "hello".	true
EndsWith( "Bye bye", "" )	Otestuje, či reťazec "Bye bye" končí prázdnym textovým reťazcom (Len vráti hodnotu 0). V tomto prípade funkcia EndsWith vráti hodnotu true a uľahčuje tak použitie vo výrazoch funkcie Filter.	true

Vzorec	Popis	Výsledok
StartsWith( "Hello World", "hello" )	Otestuje, či reťazec "Hello World" začína reťazcom "hello". V teste sa nerozlišujú malé a veľké písmená.	true
StartsWith( "Good bye", "hello" )	Otestuje, či reťazec "Good bye" začína reťazcom "hello".	false
StartsWith( "Always say hello", "hello" )	Otestuje, či reťazec "Always say hello" začína reťazcom "hello". Reťazec "hello" sa síce v textu nachádza, ale nie na jeho začiatku.	false
StartsWith("Bye bye", "" )	Otestuje, či reťazec "Bye bye" začína prázdnym textovým reťazcom (Len vráti hodnotu 0). V tomto prípade funkcia StartsWith vráti hodnotu true a uľahčuje tak použitie vo výrazoch funkcie Filter.	true

Vyhľadávanie v používateľskom prostredí

V mnohých aplikáciách môžete do vyhľadávacieho poľa zadať jeden alebo viac znakov a vyfiltrovať si tak z veľkého množstva údajov zoznam záznamov. Pri písaní zoznam priebežne zobrazuje len tie záznamy, ktoré vyhovujú kritériám vyhľadávania.

Príklady vo zvyšnej časti tejto témy zobrazujú výsledky vyhľadávania v zozname Zákazníci, ktorý obsahuje tieto údaje:

Ak chcete vytvoriť tento zdroj údajov ako kolekciu, vytvorte ovládací prvok Tlačidlo a jeho vlastnosť OnSelect nastavte na tento vzorec:

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

Rovnako ako v tomto príklade môžete zoznam záznamov zobraziť v ovládacom prvku Galérie v dolnej časti obrazovky. Do hornej časti obrazovky môžete pridať ovládací prvok Zadávanie textu s názvom SearchInput, aby si používatelia mohli zobraziť len tie záznamy, ktoré ich zaujímajú.

Pri zadávaní znakov do poľa SearchInput sa výsledky v galérii automaticky filtrujú. V tomto prípade je galéria nakonfigurovaná tak, aby sa zobrazovali záznamy, v ktorých meno zákazníka (nie názov spoločnosti) začína sekvenciou znakov zadanou do poľa SearchInput. Ak používateľ zadá do vyhľadávacieho poľa co, galéria zobrazí tieto výsledky:

Ak chcete filtrovať podľa stĺpca Name, nastavte vlastnosť Items ovládacieho prvku galérie na jeden z týchto vzorcov:

Vzorec	Popis	Výsledok
Filter( Customers, StartsWith( Name, SearchInput.Text ) )	Zo zdroja údajov Customers vyfiltruje záznamy, v ktorých sa hľadaný reťazec v stĺpci Name vyskytuje na začiatku. V teste sa nerozlišujú malé a veľké písmená. Ak používateľ do vyhľadávacieho poľa zadá co, galéria zobrazí Colleen Jones a Cole Miller. Galéria nezobrazí reťazec Mike Collins, pretože stĺpec Meno pre tento záznam nezačína hľadaným reťazcom.
Filter( Customers, SearchInput.Text in Name )	Zo zdroja údajov Customers vyfiltruje záznamy, v ktorých sa hľadaný reťazec zobrazuje kdekoľvek v stĺpci Meno. V teste sa nerozlišujú malé a veľké písmená. Ak používateľ do vyhľadávacieho poľa zadá co, galéria zobrazí Colleen Jones, Cole Miller a Mike Collins, pretože vo všetkých týchto záznamoch sa hľadaný reťazec nachádza niekde v stĺpci Meno.
Search( Customers, SearchInput.Text, "Name" )	Podobne ako operátor in aj funkcia Search vyhľadá pre každý záznam zhodu kdekoľvek v stĺpci Meno. Nezabúdajte na to, že názov stĺpca musíte uzavrieť do dvojitých úvodzoviek.

Hľadanie môžete rozšíriť tak, aby zahŕňalo stĺpec Spoločnosť a aj stĺpec Meno:

Vzorec	Popis	Výsledok
Filter( Customers, StartsWith( Name, SearchInput.Text ) || StartsWith( Company, SearchInput.Text ) )	Zo zdroja údajov Customers vyfiltruje záznamy, v ktorých stĺpec Name alebo stĺpec Company začína hľadaným reťazcom (napríklad co). Operátor|| má príznak pravda ak má funkcia StartsWith príznak pravda.
Filter( Customers, SearchInput.Text in Name || SearchInput.Text in Company )	Zo zdroja údajov Zákazníci vyfiltruje záznamy, v ktorých sa niekde v stĺpci Meno alebo Spoločnosť nachádza hľadaný reťazec (napríklad Co).
Search( Customers, SearchInput.Text, "Name", "Company" )	Podobne ako v prípade operátora in a funkcie Search vyhľadá v zdroji údajov Zákazníci záznamy, v ktorých sa niekde v stĺpci Meno alebo Spoločnosť nachádza hľadaný reťazec (napríklad co). V prípade, že chcete zadať viac stĺpcov a operátorov in, funkcia Search sa v porovnaní s funkciou Filter ľahšie číta a píše. Nezabúdajte na to, že názvy stĺpcov musíte uzavrieť do dvojitých úvodzoviek.