EndsWith и StartsWith функции

Отнася се за: Приложения за платно Copilot Studio Работен плот потоци Dataverse формули колони Модел-задвижвани приложения Power Platform CLI Dataverse функции Power Pages

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

Описание

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

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

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

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

Синтаксис

EndsWith( Текст, краен текст )

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

StartsWith( Текст, StartText )

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

Примери

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

Формула	Описание	Резултат
StartsWith( "Hello World", "hello" )	Тестове дали "Hello World" започва с "hello". Тестът нечувствителен към регистър.	верен
StartsWith( "Довиждане", "здравей" )	Тестове дали "Good bye" започва с "hello".	невярно
StartsWith( "Always say hello", "hello" )	Тестове дали "Always say hello" започва с "hello". Макар че "hello" се появява в текста, не се появява в началото.	невярно
StartsWith( "Чао довиждане", "" )	Тестове дали "Bye bye" започва с празен текстов низ (Len връща 0). Използването му във "Филтриране на изрази" е дефинирано да 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). Операторът|| е верен, ако някоя от двете StartsWith функции е вярна.
Filter( Клиенти, SearchInput.Text в името || SearchInput.Text в компанията )	Филтрира Клиенти източник на данни за записи, в които или име колоната, или Компания колоната съдържа низа за търсене (например, co), навсякъде с него.
Search( Клиенти, SearchInput.Text, "Име", "Компания" )	Подобно на използването на in оператор функцията Search търси Клиенти източник на данни за записи, в които или име колоната, или Компания колоната съдържа низа за търсене (например, co), навсякъде с него. Функцията Search е по-лесна за четене и писане, отколкото Filter, ако искате да посочите няколко колони и множество in оператори. Обърнете внимание, че трябва затворите името на колоните в двойни кавички.