Funkcie EndsWith a StartsWith

Vzťahuje sa na: aplikácie plátna toky na počítači Dataverse stĺpce vzorcov aplikácie s podporou modelu Power Pages 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.

Pre obe funkcie testy nerozlišujú veľké a malé písmená, ak to koncový zdroj údajov štandardne podporuje. Napríklad kolekcie Dataverse, SharePoint a SQL Server štandardne podporujú nerozlišovanie malých a veľkých písmen. Oracle nie. 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

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( Zákazníci, Tabuľka( { Názov: "Fred Garcia", Spoločnosť: "Northwind Traders" }, { Názov: "Cole Miller", Spoločnosť: "Contoso" }, { Názov: "Glenda Johnson", Spoločnosť: "Contoso" }, { Meno: "Mike Collins", Spoločnosť: "Adventure Works" }, { Meno: "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 ( Zákazníci, 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.
Hľadať ( Zákazníci, 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( Zákazníci, StartsWith( Meno, 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( Zákazníci, 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).
Hľadať ( Zákazníci, 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.