Funkcijas EndsWith un StartsWith

Attiecas uz: audekla programmām Darbvirsmas plūsmas Dataverse formulu kolonnas Modeļa vadītas programmas Power Platform CLI

Pārbauda, vai teksta virkne sākas vai beidzas ar citu teksta virkni.

Apraksts

Funkcija EndsWith pārbauda, vai viena teksta virkne beidzas ar citu.

Funkcija StartsWith pārbauda, vai viena teksta virkne sākas ar citu.

Abām funkcijām pārbaudes ir reģistrnejutīgas. Abu funkciju atgrieztā vērtība ir Būla patiess vai aplams.

Izmantojiet funkciju EndsWith un StartsWith ar funkciju Filter, lai savā programmā meklētu datus. Varat arī izmantot operatoru in vai funkciju Search, lai meklētu jebkur teksta virknēs, ne tikai sākumā vai beigās. Jūsu funkciju izvēle būs atkarīga no jūsu programmas vajadzībām un tā, kuru funkciju var deleģēt jūsu konkrētajam datu avotam. Ja kādu no šīm funkcijām deleģēt nevar, autorēšanas laikā parādīsies deleģēšanas brīdinājums par šo ierobežojumu.

Sintakse

EndsWith( Text, EndText )

  • Teksts — Obligāti. Pārbaudāmais teksts.
  • EndText — Obligāti. Teksts, ko meklēt Teksta beigās. Ja EndText ir tukša virkne, funkcija EndsWith atgriež vērtību true.

StartsWith( Text, StartText )

  • Teksts — Obligāti. Pārbaudāmais teksts.
  • StartText — Obligāti. Teksts, ko meklēt Teksta sākumā. Ja StartText ir tukša virkne, funkcija StartsWith atgriež vērtību true.

Piemēri

Formula Apraksts Rezultāts
EndsWith( "Hello World", "world" ) Pārbauda, vai "Hello World" beidzas ar ""world. Pārbaude ir reģistrnejutīga. patiess
EndsWith( "Good bye", "good" ) Pārbauda, vai "Goodbye" beidzas ar "good". EndText arguments ("good") tiek parādīts tekstā, bet ne beigās. aplams
EndsWith( "Always say hello", "hello" ) Pārbauda, vai "Always say hello" beidzas ar "hello". patiess
EndsWith( "Bye bye", "" ) Pārbauda, vai "Bye bye" beidzas ar tukšu teksta virkni (Len atgriež 0). Vienkāršojot lietošanu Filtra izteiksmēs, EndsWith tiek definēta, lai šajā gadījumā atgrieztu vērtību true. patiess
Formula Apraksts Rezultāts
StartsWith ("Hello World", "hello" ) Pārbauda, vai "Hello World" sākas ar ""hello. Pārbaude ir reģistrnejutīga. patiess
StartsWith( "Good bye", "hello" ) Pārbauda, vai "Good bye" sākas ar ""hello. aplams
StartsWith( "Always say hello", "hello" ) Pārbauda, vai "Always say hello" sākas ar "hello". Lai gan tekstā parādās "hello", tas neparādās sākumā. aplams
StartsWith( "Bye bye", "" ) Pārbauda, vai "Bye bye" sākas ar tukšu teksta virkni (Len atgriež 0). Vienkāršojot lietošanu Filtra izteiksmēs, StartsWith tiek definēta, lai šajā gadījumā atgrieztu vērtību true. patiess

Meklēšanas lietotāja pieredze

Daudzās programmās varat meklēšanas lodziņā ievadīt vienu vai vairākas rakstzīmes, lai lielā datu kopā filtrētu ierakstu sarakstu. Rakstīšanas laikā saraksts rāda tikai tos ierakstus, kuri atbilst meklēšanas kritērijiem.

Piemēri šīs tēmas pārējā daļā rāda rezultātus, meklējot sarakstu Klienti, kas satur šos datus:

Klientu saraksta piemērs.

Lai izveidotu šo datu avotu kā kolekciju, izveidojiet vadīklu Button un iestatiet tās rekvizītu OnSelect uz šo formulu:

ClearCollect(klienti, tabula({vārds: "Aldis Garais", uzņēmums: "Northwind Traders", }{vārds: "Kalvis Millers", uzņēmums: "Contoso" }, { vārds: "Gita Jansone", uzņēmums: "Contoso" }, { vārds: Miks Celmiņš", uzņēmums: "Adventure Works"}, { vārds: "Karīna Jansone", nosaukums: "Adventure Works" }) )

Kā tas ir šajā piemērā, jūs varat rādīt ierakstu sarakstu Galerijas vadīklā ekrāna lejasdaļā. Netālu no ekrāna augšpuses varat pievienot Teksta ievades vadīklu ar nosaukumu SearchInput, lai lietotāji varētu konkretizēt sev interesējošos ierakstus.

Klientu galerija.

Lietotājam rakstot rakstzīmes vadīklā SearchInput, rezultāti galerijā tiek automātiski filtrēti. Šajā gadījumā galerija tiek konfigurēta, lai rādītu ierakstus, kuriem klienta vārds (nevis uzņēmuma nosaukums) sākas ar rakstzīmju secību vadīklā SearchInput. Ja lietotājs meklēšanas lodziņā ievada co, galerija rāda šādus rezultātus:

Klientu galerija ar meklēšanu.

Lai filtrētu, pamatojoties uz kolonnu Vārds, iestatiet galerijas vadīklas rekvizītu Elementi uz vienu no šīm formulām:

Formula Apraksts Rezultāts
Filter( Customers, StartsWith( Name, SearchInput.Text ) ) Filtrē, vai datu avotā Customers nav ierakstu, kuros meklēšanas virkne parādās kolonnas Vārds sākumā. Pārbaude ir reģistrnejutīga. Ja lietotājs meklēšanas lodziņā ieraksta co, galerija rāda Colleen Jones un Cole Miller. Galerija nerāda Mike Collins, jo Vārda kolonna šim ierakstam nesākas ar meklēšanas virkni. Piemērs ar StartsWith.
Filtrs( Klienti, SearchInput.Text nosaukumā ) Filtrē, vai datu avotā Klienti nav ierakstu, kuros meklēšanas virkne parādās jebkur kolonnā Nosaukums. Pārbaude ir reģistrnejutīga. Ja lietotājs meklēšanas lodziņā ievada co, galerija rāda Colleen Jones, Cole Miller un Mike Collins, jo meklēšanas virkne parādās kādā vietā visu šo ierakstu kolonnā Vārds. Piemērs ar SearchInput.Text nosaukumā.
Meklēt( Klienti, SearchInput.Text, "Name" ) Līdzīgi kā izmantojot operatoru in, Meklēšanas funkcija meklē atbilstību jebkur katra ieraksta kolonnā Nosaukums. Ņemiet vērā, ka kolonnas nosaukums ir jāiekļauj pēdiņās. Piemērs ar SearchInput.Text nosaukumā.

Varat izvērst meklēšanu, lai tā ietvertu kolonnu Uzņēmums, kā arī kolonnu Nosaukums:

Formula Apraksts Rezultāts
Filter( Customers, StartsWith( Name, SearchInput.Text ) || StartsWith( Company, SearchInput.Text ) ) Filtrē datu avotu Klienti, lai atrastu ierakstus, kuros gan kolonna Vārds, gan kolonna Uzņēmums, sākas ar meklēšanas virkni (piemēram, co). || operators ir true, ja jebkura no StartsWith funkcijām ir true. Filtrēt ar StartsWith.
Filtrs( Klienti, SearchInput.Text nosaukumā || SearchInput.Text uzņēmumā ) Filtrē Klienti datu avotu, lai atrastu ierakstus, kuros kolonna Nosaukums vai kolonna Uzņēmums, satur meklēšanas virkni (piemēram, co) jebkur kolonnā. Filtrēšana, kurā ir meklējams teksts nosaukumā.
Meklēt( Klienti, SearchInput.Text, "Nosaukums", "Uzņēmums" ) Līdzīgi, kā izmantojot operatoru in, funkcija Search datu avotā Klienti meklē ierakstus kuros kolonna Vārds vai kolonna Uzņēmums satur meklēšanas virkni (piemēram co) jebkur kolonnā. Funkcija Search ir vieglāk lasāma un rakstāma nekā Filter, ja vēlaties konkretizēt vairākas kolonnas un vairākus in operatorus. Ņemiet vērā, ka kolonnu nosaukumus ir jāiekļauj pēdiņās. Filtrēšana, kurā ir meklējams teksts nosaukumā, uzņēmumā.