Bagikan melalui

Fungsi EndsWith dan StartsWith

  • Artikel

Berlaku untuk: Aplikasi kanvas Kolom Dataverse rumus alur desktop Aplikasi Power Platform berbasis model CLI

Menguji apakah string teks dimulai atau diakhiri string teks lainnya.

KETERANGAN

Fungsi EndsWith menguji bagaimana satu string teks berakhir dengan yang lain.

Fungsi StartsWith menguji bagaimana satu teks terikat bermula dengan yang lain.

Untuk kedua fungsi, uji tidak peka terhadap huruf besar-kecil. Nilai yang dihasilkan keduanya adalah Boolean true atau false.

Gunakan fungsi EndsWith dan StartsWith dengan fungsi Filter untuk mencari data dalam aplikasi Anda. Anda juga dapat menggunakan operator in atau fungsi Search untuk mencari di mana pun dalam string teks, bukan hanya di awal atau akhir. Pilihan fungsi anda akan tergantung pada kebutuhan aplikasi Anda dan fungsi yang dapat didelegasikan untuk sumber data tertentu. Jika salah satu fungsi ini tidak dapat didelegasikan, peringatan delegasi akan muncul pada waktu penulisan untuk memperingatkan Anda tentang pembatasan ini.

Sintaks

EndsWith( Text, EndText )

  • Text – Wajib. Teks yang akan diuji.
  • EndText – Wajib. Teks untuk dicari di akhir Teks. Jika EndText adalah string kosong, EndsWith menghasilkan true.

StartsWith( Text, StartText )

  • Text – Wajib. Teks yang akan diuji.
  • StartText – Wajib. Teks untuk dicari di awal Teks. Jika StartText adalah string kosong, StartsWith menghasilkan true.

Contoh

Rumus KETERANGAN Hasil
EndsWith( "Hello World", "world" ) Menguji apakah "Hello World" diakhiri dengan "world". Pengujian tidak peka terhadap huruf besar-kecil. true
EndsWith( "Good bye", "good" ) Menguji apakah "Good bye" diakhiri dengan "good". Argumen EndText ("good") muncul dalam teks, namun tidak di akhir. false
EndsWith( "Always say hello", "hello" ) Menguji apakah "Always say hello" diakhiri dengan "hello". true
EndsWith( "Bye bye", "" ) Menguji apakah "Bye bye" diakhiri dengan string teks kosong (Len menghasilkan 0). Memudahkan penggunaannya dalam ekspresi Filter, EndsWith didefinisikan untuk menghasilkan true dalam kasus ini. true
Rumus KETERANGAN Hasil
StartsWith( "Hello World", "hello" ) Menguji apakah "Hello World" dimulai dengan "hello". Pengujian tidak peka terhadap huruf besar-kecil. true
StartsWith( "Good bye", "hello" ) Menguji apakah "Good bye" dimulai dengan "hello". false
StartsWith( "Always say hello", "hello" ) Menguji apakah "Always say hello" dimulai dengan "hello". Meskipun "hello" muncul dalam teks, namun tidak muncul di awal. false
StartsWith( "Bye bye", "" ) Menguji apakah "Bye bye" dimulai dengan string teks kosong (Len menghasilkan 0). Memudahkan penggunaannya dalam ekspresi Filter, StartsWith didefinisikan untuk menghasilkan true dalam kasus ini. true

Mencari pengalaman pengguna

Di banyak aplikasi, Anda dapat mengetik satu atau beberapa karakter ke dalam kotak pencarian untuk memfilter daftar rekaman di himpunan data besar. Saat Anda mengetik, daftar hanya menampilkan rekaman yang sesuai dengan kriteria pencarian.

Contoh di bagian lain topik ini menampilkan hasil pencarian daftar Pelanggan, yang berisi data ini:

Contoh Daftar pelanggan.

Untuk membuat sumber data ini sebagai kumpulan, buat kontrol Tombol dan atur properti OnSelect ke rumus ini:

ClearCollect(Customers, Table({ Nama: "Fred Garcia", Perusahaan: "Northwind Traders" }, { Nama: "Cole Miller", Perusahaan: "Contoso" }, { Nama: "Glenda Johnson", Perusahaan: "Contoso" }, { Nama: "Mike Collins", Perusahaan: "Adventure Works" }, { Nama: "Colleen Jones", Perusahaan: "Adventure Works" }) )

Seperti dalam contoh ini, Anda dapat menampilkan daftar rekaman dalam Kontrol galeri di bagian bawah layar. Di dekat bagian atas layar, Anda dapat menambahkan kontrol Input teks, bernama SearchInput, sehingga pengguna dapat menentukan rekaman yang menarik bagi mereka.

Galeri pelanggan.

Saat pengguna mengetik karakter dalam SearchInput, hasil di galeri secara otomatis difilter. Dalam kasus ini, galeri dikonfigurasi untuk menampilkan rekaman dengan nama pelanggan (bukan nama perusahaan) dimulai dengan urutan karakter di SearchInput. Jika pengguna mengetik co dalam kotak pencarian, galeri menampilkan hasil ini:

Galeri pelanggan dengan pencarian.

Untuk memfilter berdasarkan kolom Nama, atur properti Item kontrol galeri ke salah satu rumus berikut:

Rumus KETERANGAN Hasil
Filter( Customers, StartsWith( Name, SearchInput.Text ) ) Filter sumber data Pelanggan untuk rekaman yang menampilkan string pencarian yang muncul di awal kolom Nama. Pengujian tidak peka terhadap huruf besar-kecil. Jika pengguna mengetik co di kotak pencarian, galeri menunjukkan Colleen Jones dan Cole Miller. Galeri tidak menampilkan Mike Collins karena kolom Nama untuk rekaman tersebut tidak dimulai dengan string pencarian. Contoh: StartsWith.
Filter( Customers, SearchInput.Text in Name ) Filter sumber data Pelanggan untuk rekaman yang menampilkan string pencarian yang muncul di mana saja di kolom Nama. Pengujian tidak peka terhadap huruf besar-kecil. Jika pengguna mengetik co di kotak pencarian, galeri menampilkan Colleen Jones,Cole Miller, dan Mike Collins karena string pencarian muncul di suatu tempat di kolom Nama dari semua rekaman tersebut. Contoh SearchInput.Text dalam Nama.
Search( Customers, SearchInput.Text, "Name" ) Mirip dengan menggunakan operator in, fungsi Search mencari kecocokan di mana saja dalam kolom Nama pada setiap rekaman. Perhatikan bahwa Anda harus melampirkan nama kolom dalam tanda kutip ganda. Contoh SearchInput.Text dengan Nama.

Anda dapat memperluas pencarian untuk mencakup juga kolom Perusahaan serta kolom Nama:

Rumus KETERANGAN Hasil
Filter( Pelanggan, StartsWith( Nama, SearchInput.Text ) || StartsWith( Perusahaan, SearchInput.Text ) ) Filter sumber data Pelanggan untuk rekaman dengan kolom Nama atau kolom Perusahaan dimulai dengan string pencarian (misalnya, co). Operator || bernilai true jika fungsi StartsWith bernilai true. Filter dengan StartsWith.
Filter( Pelanggan, SearchInput.Text in Nama || SearchInput.Text in Perusahaan ) Filter sumber data Pelanggan untuk rekaman dengan kolom Nama atau kolom Perusahaan berisi string pencarian (misalnya, co) di mana saja di dalamnya. Filter dengan teks pencarian dalam nama.
Search( Customers, SearchInput.Text, "Name", "Company" ) Sama seprti menggunakan operator in, fungsi Search mencari sumber data Pelanggan untuk rekaman dengan kolom Nama atau kolom Perusahaan berisi string pencarian (misalnya, co) di mana saja di dalamnya. Fungsi Search lebih mudah dibaca dan ditulis daripada Filter, jika Anda ingin menentukan beberapa kolom dan beberapa operator in. Perhatikan bahwa Anda harus melampirkan nama kolom dalam tanda kutip ganda. Filter dengan teks pencarian dalam nama, perusahaan.