EndsWith dan StartsWith fungsi

Digunakan untuk: Aplikasi kanvas Desktop mengalirkan Dataverse lajur formula Aplikasi berpandukan Power Pages Power Platform model CLI

Uji sama ada rentetan teks bermula atau berakhir teks rentetan yang lain.

Penerangan

Fungsi EndsWith menguji sama ada satu teks rentetan berakhir dengan yang lain.

Fungsi StartsWith menguji sama ada satu teks rentetan bermula dengan yang lain.

Untuk kedua-dua fungsi, ujian adalah tidak sensitif huruf. Nilai pulangan bagi kedua-duanya adalah Boolean benar atau palsu.

Gunakan EndsWith dan StartsWith dengan fungsi Filter untuk mencari data dalam aplikasi. Anda juga boleh menggunakan operator dalam atau fungsi Search untuk mencari di mana-mana dalam teks rentetan, bukan sahaja pada awal atau akhir. Pilihan fungsi anda akan bergantung pada keperluan aplikasi anda dan fungsi yang boleh diwakilkan untuk sumber data tertentu anda. Jika salah satu fungsi ini tidak boleh diwakilkan, amaran perwakilan akan dipaparkan pada masa pengarangan untuk memberi anda amaran tentang pengehadan ini.

Sintaks

EndsWith( Teks, EndText )

• Teks – Diperlukan. Teks untuk diuji.
• EndText – Diperlukan. Teks untuk dicari pada hujung Teks. Jika EndText adalah rentetan kosong, EndsWith mengembalikan benar.

StartsWith( Teks, StartText )

• Teks – Diperlukan. Teks untuk diuji.
• StartText – Diperlukan. Teks untuk dicari pada permulaan Teks. Jika StartText adalah rentetan kosong, StartsWith mengembalikan benar.

Contoh

Formula	Penerangan	Hasil
EndsWith( "Helo Dunia", "dunia" )	Uji sama ada "Helo Dunia" berakhir dengan "dunia". Ujian adalah sensitif huruf.	benar
EndsWith( "Selamat Tinggal", "tinggal" )	Uji sama ada "Selamat Tinggal" berakhir dengan "tinggal". Argumen EndText ("tinggal") dipaparkan dalam teks tetapi tidak pada akhiran.	palsu
EndsWith( "Sentiasa menyebut hello", "hello" )	Uji sama ada "Sentiasa menyebut hello" berakhir dengan "hello".	benar
EndsWith( "Selamat Tinggal", "" )	Uji sama ada "Selamat Tinggal" berakhir dengan rentetan teks kosong (Len kembalikan 0). Memudahkan penggunaannya dalam ungkapan Penapis, EndsWith ditakrifkan untuk mengembalikan benar dalam kes ini.	benar

Formula	Penerangan	Hasil
StartsWith( "Helo Dunia", "hello" )	Uji sama ada "Helo Dunia" bermula dengan "hello". Ujian adalah sensitif huruf.	benar
StartsWith( "Selamat tinggal", "hello" )	Uji sama ada "Selamat tinggal" bermula dengan "hello".	palsu
StartsWith( "Sentiasa menyebut hello", "hello" )	Uji sama ada "Sentiasa menyebut hello" bermula dengan "hello". Walaupun "hello" dipaparkan dalam teks, ia tidak dipaparkan pada permulaan.	benar
StartsWith( "Selamat tinggal", "" )	Uji sama ada "Selamat tinggal" bermula dengan rentetan teks kosong (Len kembalikan 0). Memudahkan penggunaannya dalam ungkapan Penapis, StartsWith ditakrifkan untuk mengembalikan benar dalam kes ini.	benar

Carian pengalaman pengguna

Dalam banyak aplikasi, anda boleh menaip satu atau lebih karakter ke dalam kotak carian untuk menapis senarai rekod dalam set data yang besar. Apabila anda menaip, senarai menunjukkan hanya rekod yang sepadan dengan kriteria carian.

Contoh dalam topik selebihnya menunjukkan hasil carian senarai Pelanggan yang mengandungi data ini:

Untuk mencipta sumber data ini sebagai pengumpulan, cipta kawalan Butang dan tetapkan sifat OnSelect ke formula ini:

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

Seperti dalam contoh ini, anda boleh menunjukkan senarai rekod dalam Kawalan galeri di bawah skrin. Berhampiran atas skrin, anda boleh tambah kawalan Input teksl, bernama SearchInput, supaya pengguna boleh menentukan rekod yang berkepentingan.

Apabila pengguna menaip karakter dalam SearchInput, hasil dalam galeri ditapis secara automatik. Dalam kes ini, galeri dikonfigurasi untuk menunjukkan rekod dengan nama pelanggan (bukan nama syarikat) bermula dengan jujukan karakter dalam SearchInput.Jika pengguna menaip co dalam kotak carian, galeri menunjukkan hasil ini:

Untuk menapis berasaskan pada lajur Nama, tetapkan sifat kawalan galeri Item ke salah satu formula ini:

Formula	Penerangan	Hasil
Filter( Customers, StartsWith( Name, SearchInput.Text ) )	Tapis sumber data pelanggan untuk rekod yang rentetan carian dipaparkan pada permulaan lajur Nama. Ujian adalah sensitif huruf. Jika pengguna menaip co dalam kotak carian, galeri menunjukkan Colleen Jones dan Cole Miller. Galeri tidak menunjukkan Mike Collins kerana lajur Nama column untuk rekod itu tidak bermula dengan rentetan carian.
Filter( Customers, SearchInput.Text in Name )	Tapis sumber data Pelanggan untuk rekod yang rentetan carian dipaparkan di mana-mana dalam lajur Nama. Ujian adalah sensitif huruf. Jika penggunakan menaip co dalam kotak carian, galeri menunjukkan Colleen Jones,Cole Miller, dan Mike Collins kerana rentetan carian muncul di suatu tempat dalam lajur Nama semua rekod tersebut.
Search( Customers, SearchInput.Text, "Name" )	Sama seperti menggunakan operator dalam, fungsi Carian mencari padanan di mana-mana sahaja dalam lajur Nama bagi setiap rekod. Perlu diingat bahawa anda mesti melampirkan nama lajur dalam tanda petikan berganda.

Anda boleh mengembangkan carian anda untuk memasukkan lajur Syarikat serta lajur Nama:

Formula	Penerangan	Hasil
Penapis( Pelanggan, StartsWith( Nama, SearchInput.Text ) || StartsWith( Syarikat, SearchInput.Text ) )	Menapis sumber data Pelanggan untuk rekod yang sama ada lajur Nama atau lajur Syarikat bermula dengan rentetan carian (contohnya, co). || operator adalah benar jika sama ada fungsi StartsWith adalah benar.
Penapis( Pelanggan, SearchInput.Text dalam Nama || SearchInput.Text dalam Syarikat )	Tapis sumber data Pelanggan untuk rekod yang sama ada lajur Nama atau lajur Syarikat mengandungi rentetan carian (contohnya, co) di mana-mana sahaja di dalamnya.
Search( Customers, SearchInput.Text, "Name", "Company" )	Sama seperti menggunakan operator dalam, fungsi Search mencari sumber data Pelanggan untuk rekod yang sama ada lajur Nama atau lajur Syarikat mengandungi rentetan carian (contohnya, co) di mana-mana di dalamnya. Fungsi Search mudah dibaca dan ditulis berbanding Filter jika anda mahu menentukan berbilang lajur dan berbilang operator dalam. Perlu diingat bahawa anda mesti melampirkan nama lajur dalam tanda petikan berganda.