EndsWith a StartsWith funkcie

Vzťahuje sa na: Aplikácie plátna Copilot Studio Desktop – postupy vzorcov Dataverse stĺpce Modelom riadené aplikácie Power Platform CLI Dataverse funkcie Power Pages

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.

Pomocou EndsWith funkcie Filter môžete vyhľadávať v údajoch v aplikácii a StartsWith s ňou. 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.	falošné
EndsWith( "Always say hello", "hello" )	Otestuje, či reťazec "Always say hello" končí reťazcom "hello".	pravda
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 Easing its use vo výrazoch EndsWithfunkcie Filter vráti hodnotu true.	pravda

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á.	pravda
StartsWith( "Good bye", "hello" )	Otestuje, či reťazec "Good bye" začína reťazcom "hello".	falošné
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.	falošné
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 Easing its use vo výrazoch StartsWithfunkcie Filter vráti hodnotu true.	pravda

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", Firma: "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( 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). Ak je niektorá StartsWith z funkcií pravdivá||, operátor je true.
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.