Функциите EndsWith и StartsWith

Отнася се за: Приложения за платно Колони Dataverse с формули за потоци на работния плот TCLI на приложения Power Pages Power Platform , управлявани от модел

Тества дали текстов низ започва или завършва друг текстов низ.

Описание

Функцията EndsWith тества дали един текстов низ завършва с друг.

Функцията StartsWith тества дали един текстов низ започва с друг.

И за двете функции тестовете са нечувствителни към малки и големи букви, ако сървърният източник на данни го поддържа по подразбиране. Например колекциите Dataverse SharePoint и SQL Server поддържат нечувствителност към малки и големи букви по подразбиране. Oracle не го прави. Върнатата стойност на двете е булево вярно или невярно.

Използвайте EndsWith и StartsWith с Filter функция за търсене на данни в приложението ви. Можете също да използвате оператор in или Search функция, за да търсите навсякъде в текстовите низове, а не само в началото или в края. Вашият избор на функции ще зависи от нуждите на вашето приложение и коя функция може да бъде делегиран за вашия конкретен източник на данни. Ако една от тези функции не може да бъде делегирана, в момента на създаване ще се появи предупреждение за делегиране, за да ви предупреди за това ограничение.

Синтаксис

Завършва С( Текст; Краен текст )

• Текст – Задължително. Текстът за тестване.
• EndText – Задължително. Текстът, който да търсите в края на Текст. Ако EndText е празен низ, EndsWith завръща вярно.

StartsWith( Текст; Начален текст )

• Текст – Задължително. Текстът за тестване.
• StartText – Задължително. Текстът, който да търсите в началото на Текст. Ако StartText е празен низ, StartsWith връща вярно.

Примери

Изживяване на търсене на потребител

В много приложения можете да въведете един или повече знака в поле за търсене, за да филтрирате списък от записи в голям набор от данни. Докато пишете, списъкът показва само онези записи, които отговарят на критериите за търсене.

Примерите в останалата част на тази тема показват резултатите от търсенето на Клиенти списък, който съдържа тези данни:

За да създадете този източник на данни като колекция, създайте контрола бутон и зададете свойството й OnSelect на тази формула:

ClearCollect( Клиенти, Таблица ( { Име: "Фред Гарсия", Компания: "Northwind Traders" }, { Име: "Коул Милър", Компания: "Contoso" }, { Име: "Гленда Джонсън", Компания: "Contoso" }, { Име: "Майк Колинс", Компания: "Adventure Works" }, { Име: "Колийн Джоунс", Компания: "Adventure Works" } )

Както в този пример, можете да покажете списък със записи в контрола Галерия в долната част на екрана. В горната част на екрана можете да добавите Въвеждане на текст контрол, назована SearchInput, така че потребителите да определят кои записи ги интересуват.

Тъй като потребителят въвежда символи в SearchInput, резултатите в галерията се филтрират автоматично. В този случай галерията е конфигурирана да показва записи, за които името на клиента (а не името на компанията) започва с поредицата от знаци в SearchInput. Ако типовете потребители co в полето за търсене галерията показва тези резултати:

За филтриране на базата на колона име, задайте свойството елементи на контрола на галерията към една от тези формули:

Формула	Описание	Резултат
Filter( Клиенти, StartsWith( Име, SearchInput.Text ) )	Филтрира Клиенти източник на данни за записи, в които низът за търсене се появява в началото на име колона. Тестът нечувствителен към регистър. Ако потребителят въведе co в полето за търсене показва галерията Colleen Jones и Cole Miller. Галерията не се показва Mike Collins, защото име колоната за този запис не започва с низ за търсене.
Filter( Клиенти, SearchInput.Text в името)	Филтрира Клиенти източник на данни за записи, в които низът за търсене се появява където и да е в колоната име. Тестът нечувствителен към регистър. Ако потребителят въведе co в полето за търсене показва галерията Colleen Jones, Cole Miller, и Mike Collins, защото низът за търсене се появява някъде в име колона на всички тези записи.
Search( Клиенти, SearchInput.Text, "Име" )	Подобно на използването на в оператора, функцията Търсене търси съвпадение навсякъде в име колона на всеки запис. Обърнете внимание, че трябва да прикрепите името на колоната в двойни кавички.

Можете да разширите търсенето си, за да включите колона фирма, както и колона име:

Формула	Описание	Резултат
Filter( Клиенти, StartsWith( Име, SearchInput.Text ) || StartsWith( Company, SearchInput.Text ) )	Филтрира Клиенти източник на данни за записи, в които или име колоната, или Компания колоната започва с низ за търсене (например, co). Операторът || е true, ако която и да е функция StartsWith е true.
Filter( Клиенти, SearchInput.Text в името || SearchInput.Text в компанията )	Филтрира Клиенти източник на данни за записи, в които или име колоната, или Компания колоната съдържа низа за търсене (например, co), навсякъде с него.
Search( Клиенти, SearchInput.Text, "Име", "Компания" )	Подобно на използването на in оператор функцията Search търси Клиенти източник на данни за записи, в които или име колоната, или Компания колоната съдържа низа за търсене (например, co), навсякъде с него. Функцията Search е по-лесна за четене и писане, отколкото Filter, ако искате да посочите няколко колони и множество in оператори. Обърнете внимание, че трябва затворите името на колоните в двойни кавички.