EndsWith ve StartsWith işlevleri
Şunlar için geçerlidir: Tuval uygulamaları Masaüstü akışları Dataverse formül sütunları Model yönetimli uygulamalar Power Pages Power Platform CLI
Bir metin dizesinin başka bir metin dizesinin başında veya sonunda bulunup bulunmadığını test eder.
Açıklama
EndsWith işlevi, bir metin dizesinin başka bir metin dizesiyle bitip bitmediğini test eder.
StartsWith işlevi, bir metin dizesinin başka bir metin dizesiyle başlayıp başlamadığını test eder.
Her iki işlev için de testler büyük/küçük harfe duyarlı değildir. Her iki işlev de Boole (doğru veya yanlış) değeri döndürür.
Uygulamanızın içinde verileri aramak için EndsWith ve StartsWith'i Filter işleviyle birlikte kullanın. Yalnızca başta veya sonda değil, metin dizelerinin herhangi bir yerinde arama yapmak için in işlecini veya Search işlevini de kullanabilirsiniz. Tercih ettiğiniz işlevler, uygulamanızın ihtiyaçlarına ve özel veri kaynağınız için hangi işlevin temsilci seçilebileceğine bağlıdır. Bu işlevlerden biri temsilci seçilemiyorsa sizi bu sınırlamadan haberdar etmek için yazma zamanında temsilci uyarısı gösterilir.
Sözdizimi
EndsWith(Metin,EndText )
- Metin – Gerekli. Test edilecek metin.
- EndText – Gerekli. Metin öğesinin sonunda aranacak metin. EndText boş bir dize ise EndsWith, doğru değerini döndürür.
StartsWith(Metin,StartText )
- Metin – Gerekli. Test edilecek metin.
- StartText – Gerekli. Metin öğesinin başında aranacak metin. StartText boş bir dize ise StartsWith, doğru değerini döndürür.
Örnekler
Formül | Açıklama | Sonuç |
---|---|---|
EndsWith( "Merhaba Dünya", "dünya" ) | "Merhaba Dünya" metninin "dünya" ile bitip bitmediğini test eder. Test, büyük/küçük harfe duyarlı değildir. | doğru |
EndsWith( "Güle güle", "iyi" ) | "Hoşça kal" metninin "hoşça" ile bitip bitmediğini test eder. EndText bağımsız değişkeni ("hoşça") metinde görünür ancak sonda yer almaz. | YANLIŞ |
EndsWith( "Her zaman merhaba de", "merhaba" ) | "Her zaman merhaba de" metninin "de" ile bitip bitmediğini test eder. | doğru |
EndsWith( "Güle güle", "" ) | "Güle güle" metninin boş bir metin dizesi ile bitip bitmediğini test eder (Len, 0 döndürür). Filter ifadelerindeki kullanımını kolaylaştırmak için EndsWith, bu durumda doğru değerini döndürecek şekilde tanımlanmıştır. | doğru |
Formül | Açıklama | Sonuç |
---|---|---|
StartsWith( "Merhaba Dünya", "merhaba" ) | "Merhaba Dünya" metninin "merhaba" ile başlayıp başlamadığını test eder. Test, büyük/küçük harfe duyarlı değildir. | doğru |
StartsWith( "güle güle", "merhaba" ) | "Hoşça kal" metninin "merhaba" ile başlayıp başlamadığını test eder. | YANLIŞ |
StartsWith( "Her zaman merhaba de", "merhaba" ) | "Her zaman merhaba de" metninin "de" ile başlayıp başlamadığını test eder. "de" metnin içinde olsa da başlangıçta görünmez. | YANLIŞ |
StartsWith( "Güle güle", "" ) | "Güle güle" metninin boş bir metin dizesi ile başlayıp başlamadığını test eder (Len, 0 döndürür). Filter ifadelerindeki kullanımını kolaylaştırmak için StartsWith, bu durumda doğru değerini döndürecek şekilde tanımlanmıştır. | doğru |
Aramaya ilişkin kullanıcı deneyimi
Birçok uygulamada, büyük bir veri kümesindeki bir kayıt listesini filtrelemek için arama kutusuna bir veya daha fazla karakter yazabilirsiniz. Siz yazarken liste yalnızca arama ölçütleri ile eşleşen kayıtları gösterir.
Bu konu başlığının geri kalanındaki örneklerde, şu verileri içeren Müşteriler listesinde gerçekleştirilen aramanın sonuçları gösterilmektedir:
Bu veri kaynağını bir koleksiyon olarak oluşturmak için bir Button denetimi oluşturun ve OnSelect özelliğini şu formül olarak ayarlayın:
ClearCollect( Müşteriler, Tablo( { Ad: "Fred Garcia", Şirket: "Northwind Traders" }, { Ad: "Cole Miller", Şirket: "Contoso" }, { Ad: "Glenda Johnson", Şirket: "Contoso" }, { Ad: "Mike Collins", Şirket: "Adventure Works" }, { Ad: "Colleen Jones", Şirket: "Adventure Works" } ) )
Bu örnekte olduğu gibi, ekranın alt kısmındaki bir Gallery denetimi ile kayıt listesi gösterebilirsiniz. Ekranın üst kısmına yakın bir konuma SearchInput adlı bir Text input denetimi ekleyebilirsiniz. Böylece, kullanıcılar hangi kayıtlarla ilgilendiklerini belirtebilir.
Kullanıcı, SearchInput denetiminde karakterler yazdıkça galerideki sonuçlar otomatik olarak filtrelenir. Bu durumda galeri, müşteri adının (şirket adı değil) SearchInput kısmındaki karakter dizisiyle başladığı kayıtları göstermek üzere yapılandırılır. Kullanıcı, arama kutusuna co yazarsa galeri şu sonuçları gösterir:
Name sütununa göre filtreleme yapmak için gallery denetiminin Items özelliğini şu formüllerden biri olarak ayarlayın:
Formül | Açıklama | Sonuç |
---|---|---|
Filter( Müşteriler, StartsWith( Ad, SearchInput.Text ) ) | Arama dizesinin Name sütunun başında göründüğü kayıtlar için Customers veri kaynağını filtreler. Test, büyük/küçük harfe duyarlı değildir. Kullanıcı, arama kutusuna co yazarsa galeri, Colleen Jones ve Cole Miller öğelerini gösterir. Galeri, söz konusu kaydın Name sütunu arama dizesi ile başlamadığından Mike Collins öğesini göstermez. | |
Filter( Müşteriler, SearchInput.Text adında ) | Arama dizesinin, Name sütununun herhangi bir yerinde göründüğü kayıtlar için Customers veri kaynağını filtreler. Test, büyük/küçük harfe duyarlı değildir. Kullanıcı, arama kutusuna co yazarsa galeri Colleen Jones, Cole Miller ve Mike Collins öğelerini gösterir. Bunun nedeni, bu kayıtların tümünün Name sütununda arama dizesinin görünmesidir. | |
Search( Müşteriler, SearchInput.Text, "Ad" ) | in işlecinin kullanımına benzer şekilde, Search işlevi, her bir kayıttaki Name sütununun herhangi bir yerinde eşleşme arar. Sütun adının başında ve sonunda çift tırnak işareti kullanmanız gerektiğini unutmayın. |
Aramanızı Name sütununun yanı sıra Company sütununu da dahil edecek şekilde genişletebilirsiniz:
Formül | Açıklama | Sonuç |
---|---|---|
Filter( Müşteriler, StartsWith( Ad, SearchInput.Text ) || StartsWith( Şirket, SearchInput.Text ) ) | Name veya Company sütununun arama dizesiyle (örneğin, co) başladığı kayıtlar için Customers veri kaynağını filtreler. StartsWith işlevi true ise || işleci true değerini taşır. | |
Filter( Müşteriler, SearchInput.Text adında || Şirkette SearchInput.Text ) | Name veya Company sütununun herhangi bir yerinde arama dizesinin (örneğin, co) bulunduğu kayıtlar için Customer veri kaynağını filtreler. | |
Search( Müşteriler, SearchInput.Text, "Ad", "Şirket" ) | in işlecinin kullanımına benzer şekilde, Search işlevi, Name veya Company sütununun herhangi bir yerinde arama dizesinin (örneğin, co) bulunduğu kayıtlar için Customers veri kaynağını arar. Search işlevi, birden fazla sütun ve in işleci belirtmek istediğiniz durumlarda Filter işlevine göre daha kolay bir okuma ve yazma deneyimi sunar. Sütun adlarının başında ve sonunda çift tırnak işareti kullanmanız gerektiğini unutmayın. |