EndsWith ve StartsWith işlevleri

Şunlar için geçerlidir: Tuval uygulamaları Masaüstü akışları Dataverse formül sütunları Model temelli uygulamalar 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.	true
EndsWith( "Hoşça kal", "hoşça" )	"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.	false
EndsWith( "Her zaman merhaba de", "de" )	"Her zaman merhaba de" metninin "de" ile bitip bitmediğini test eder.	true
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.	true

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.	true
StartsWith( "Hoşça kal", "merhaba" )	"Hoşça kal" metninin "merhaba" ile başlayıp başlamadığını test eder.	false
StartsWith( "Her zaman merhaba de", "de" )	"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.	false
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.	true

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( 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" } ) )

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( Customers, StartsWith( Name, 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( Customers, SearchInput.Text in Name )	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( Customers, SearchInput.Text, "Name" )	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( Customers, StartsWith( Name, SearchInput.Text ) || StartsWith( Company, 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şlecitrue değerini taşır.
Filter( Customers, SearchInput.Text in Name || SearchInput.Text in Company )	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( Customers, SearchInput.Text, "Name", "Company" )	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.