EndsWith және StartsWith функциялары

Қолданылады: Canvas apps Desktop flows Dataverse формула бағандары Үлгіге негізделген CLI бағдарламалары Power Platform

Мәтін жолының басқа мәтін жолын бастайтынын немесе аяқтайтынын тексереді.

Сипаттама

EndsWith функциясы бір мәтін жолының екіншісімен аяқталатынын тексереді.

StartsWith функциясы бір мәтін жолының екіншісін бастайтынын тексереді.

Функциялардың екеуі де үшін тексерулерде регистр ескерілмейді. Екеуінің де қайтарылатын мәні — логикалық true немесе false.

Бағдарламаңызда деректерді іздеу үшін EndsWith және StartsWith функцияларын Filter функциясымен бірге пайдаланыңыз. Сондай-ақ тек басында немесе аяғында емес, мәтін жолдарының кез келген жерінде іздеу үшін in операторын немесе Search функциясын пайдалануға болады. Функцияларды таңдау бағдарламаңыздың қажеттіліктеріне және нақты деректер көзіңіз үшін қай функцияны өкілеттеуге болатынына байланысты болады. Егер осы функциялардың біреуін өкілеттеу мүмкін болмаса, өкілеттеу туралы ескерту сізге осы шектеу туралы ескерту үшін жасап жатқанда көрінеді.

Синтаксис

EndsWith( Text, EndText )

• Text – Міндетті. Тексеретін мәтін.
• EndText – Міндетті. Мәтін соңында іздейтін мәтін. EndText бос жол болса, EndsWith функциясы true мәнін қайтарады.

StartsWith( Text, StartText )

• Text – Міндетті. Тексеретін мәтін.
• StartText – Міндетті. Мәтін басында іздейтін мәтін. StartText бос жол болса, StartText функциясы true мәнін қайтарады.

Мысалдар

Формула	Сипаттама	Нәтиже
EndsWith( "Hello World", "world" )	"Hello World" жолы "world" деп аяқталатынын тексереді. Тексеруде регистр ескерілмейді.	true
EndsWith( "Good bye", "good" )	"Good bye" жолы "good" деп аяқталатынын тексереді. EndText аргументі ("good") мәтінде бар, бірақ соңында емес.	false
EndsWith( "Always say hello", "hello" )	"Always say hello" жолы "hello" деп аяқталатынын тексереді.	true
EndsWith( "Bye bye", "" )	"Bye bye" жолы бос мәтін жолымен аяқталатынын тексереді (Len функциясы 0 мәнін қайтарады). Filter өрнектерінде оны пайдалануды жеңілдету үшін EndsWith функциясы бұл жағдайда true мәнін қайтаратындай анықталған.	true

Формула	Сипаттама	Нәтиже
StartsWith( "Hello World", "hello" )	"Hello World" жолы "hello" деп басталатынын тексереді. Тексеруде регистр ескерілмейді.	true
StartsWith( "Good bye", "hello" )	"Good bye" жолы "hello" деп басталатынын тексереді.	false
StartsWith( "Always say hello", "hello" )	"Always say hello" жолы "hello" деп басталатынын тексереді. "hello" сөзі мәтінде болғанымен, ол басында емес.	false
StartsWith( "Bye bye", "" )	"Bye bye" жолы бос мәтін жолымен басталатынын тексереді (Len функциясы 0 мәнін қайтарады). Filter өрнектерінде оны пайдалануды жеңілдету үшін StartsWith функциясы бұл жағдайда true мәнін қайтаратындай анықталған.	true

Іздеу пайдалнаушы тәжірибесі

Көптеген бағдарламаларда үлкен деректер жиынындағы жазбалар тізімін сүзгілеу үшін іздеу жолағында бір немесе бірнеше таңбаны теруге болады. Теру кезінде тізім іздеу шарттарына сәйкес келетін жазбаларды ғана көрсетеді.

Осы тақырыптың қалған бөлігіндегі мысалдар мына деректерді қамтитын, Тұтынушылар тізімінде іздеудің нәтижелерін көрсетеді:

Бұл деректер көзін жинақ ретінде жасау үшін Button басқару элементін жасаңыз және оның 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 деп терсе, галерея мына нәтижелерді көрсетеді:

Name бағанының негізінде сүзу үшін галерея басқару элементінің Items сипатын мына формулалардың біреуіне орнатыңыз:

Формула	Сипаттама	Нәтиже
Filter( Customers, StartsWith( Name, SearchInput.Text ) )	Customers деректер көзінде іздеу жолы Name бағанының басында көрінетін жазбаларды сүзгілейді. Тексеруде регистр ескерілмейді. Егер пайдаланушы іздеу жолағында co деп терсе, галерея Colleen Jones және Cole Miller аттарын көрсетеді. Галерея Mike Collins атын көрсетпейді, өйткені бұл жазбаның Name бағаны іздеу жолымен басталмайды.
Filter( Customers, SearchInput.Text in Name )	Customers деректер көзінде іздеу жолы Name бағанының кез келген жерінде көрінетін жазбаларды сүзеді. Тексеруде регистр ескерілмейді. Егер пайдаланушы іздеу жолағында co деп терсе, галерея көрсетеді Colleen Jones,Cole Miller, және Mike Collins аттарын көрсетеді, өйткені іздеу жолы осы жазбалардың барлығының Name бағанында бір жерде көрінеді.
Search( Customers, SearchInput.Text, "Name" )	in операторын пайдалануға ұқсас, Search функциясы сәйкестікті әр жазбаның Name бағанының кез келген жерінде іздейді. Баған атауын қос тырнақшаға алу керек екенін ескеріңіз.

Іздеуді Company бағанын, сонымен бірге Name бағанын қамтитындай кеңейтуге болады:

Формула	Сипаттама	Нәтиже
Filter( Customers, StartsWith( Name, SearchInput.Text ) || StartsWith( Company, SearchInput.Text ) )	Customers деректер көзінде Name бағаны немесе Company бағаны іздеу жолымен басталатын (мысалы, co) жазбаларды сүзгілейді. StartsWith функцияларының біреуі true болса, || операторының мәні true.
Filter( Customers, SearchInput.Text in Name || SearchInput.Text in Company )	Customers деректер көзінде Name бағаны немесе Company бағаны кез келген жерінде іздеу жолын (мысалы, co) қамтитын жазбаларды сүзгілейді.
Search( Customers, SearchInput.Text, "Name", "Company" )	in операторын пайдалануға ұқсас, Search функциясы Customers деректер көзінде Name бағаны немесе Company бағаны кез келген жерінде іздеу жолын (мысалы, co) қамтитын жазбаларды сүзгілейді. Бірнеше бағанды және бірнеше in операторын көрсеткіңіз келсе, Filter функциясымен салыстырғанда, Search функциясы оқуға және жазуға оңайырақ. Бағандардың атауларын қос тырнақшаға алу керек екенін ескеріңіз.