EndsWith и StartsWith функции

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

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

Описание

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

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

И за двете функции тестовете са нечувствителни към регистъра. Върнатата стойност на двете е булево вярно или невярно.

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

Синтаксис

EndsWith( Text, EndText )

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

StartsWith( Text, StartText )

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

Примери

Формула	Описание	Резултат
EndsWith( "Hello World", "world" )	Тестове дали "Hello World" завършва с "world". Тестът нечувствителен към регистър.	вярно
EndsWith( "Good bye", "good" )	Тестове дали "Good bye" завършва със "good". Аргументът EndText ("good") се появява в текста, но не в края.	невярно
EndsWith( "Always say hello", "hello" )	Тестове дали "Always say hello" завършва с "hello".	вярно
EndsWith( "Bye bye", "" )	Тестове дали "Bye bye" завършва с празен текстов низ (Len връща 0). Облекчаване на използването му във филтър изрази, EndsWith е дефиниран да върне вярно в такъв случай.	вярно

Формула	Описание	Резултат
StartsWith( "Hello World", "hello" )	Тестове дали "Hello World" започва с "hello". Тестът нечувствителен към регистър.	вярно
StartsWith( "Good bye", "hello" )	Тестове дали "Good bye" започва с "hello".	невярно
StartsWith( "Always say hello", "hello" )	Тестове дали "Always say hello" започва с "hello". Макар че "hello" се появява в текста, не се появява в началото.	невярно
StartsWith( "Bye bye", "" )	Тестове дали "Bye bye" започва с празен текстов низ (Len връща 0). Облекчаване на използването му във филтър изрази, StartsWith е дефиниран да върне вярно в такъв случай.	вярно

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

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

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

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

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

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

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

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

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

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

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