EndsWith ve StartsWith işlevleri

Şunlar için geçerlidir: Tuval uygulamaları Copilot Studio Desktop akışları Dataverse formül sütunları Model temelli uygulamalar Power Platform CLI Dataverse işlevleri Power Pages

Bir metin dizesinin başka bir metin dizesinin başında veya sonunda bulunup bulunmadığını test eder.

Açıklama

İşlev, EndsWith bir metin dizesinin diğeriyle bitip bitmediğini sınar.

İşlev, StartsWith bir metin dizesinin başka bir metin dizesiyle başlayıp başlamadığını sınar.

Her iki işlev için de, arka uç veri kaynağı varsayılan olarak destekliyorsa testler büyük/küçük harfe duyarlı değildir. Örneğin, koleksiyonlar, Dataverse, SharePoint ve SQL Server varsayılan olarak büyük/küçük harfe duyarlı olmamayı destekler. Oracle desteklemez. Her iki işlev de Boole (doğru veya yanlış) değeri döndürür.

Uygulamanızdaki verileri aramak için Filter işleviyle ve StartsWith kullanınEndsWith. 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, Son Metin )

• Metin: Gerekli. Test edilecek metin.
• EndText: Gerekli. Metin öğesinin sonunda aranacak metin. EndText boş bir dizeyse trueEndsWith döndürür.

StartsWith( Metin, Başlangıç Metni )

• Metin: Gerekli. Test edilecek metin.
• StartText: Gerekli. Metin öğesinin başında aranacak metin. StartText boş bir dizeyse trueStartsWith döndürür.

Örnekler

Formül	Açıklama	Sonuç
EndsWith( "Hello World", "world" )	"Merhaba Dünya" metninin "dünya" ile bitip bitmediğini test eder. Test, büyük/küçük harfe duyarlı değildir.	true
EndsWith( "Good bye", "good" )	"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", "merhaba" )	"Her zaman merhaba de" metninin "de" ile bitip bitmediğini test eder.	true
EndsWith( "Bye bye", "" )	"Güle güle" metninin boş bir metin dizesi ile bitip bitmediğini test eder (Len, 0 döndürür). Filtre ifadelerinde kullanımını kolaylaştırma, EndsWith bu durumda true döndürmek için tanımlanır.	true

Formül	Açıklama	Sonuç
StartsWith( "Hello World", "hello" )	"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( "Güle güle", "merhaba" )	"Hoşça kal" metninin "merhaba" ile başlayıp başlamadığını test eder.	false
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.	false
StartsWith( "Bye bye", "" )	"Güle güle" metninin boş bir metin dizesi ile başlayıp başlamadığını test eder (Len, 0 döndürür). Filtre ifadelerinde kullanımını kolaylaştırma, StartsWith bu durumda true döndürmek için tanımlanı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( Şirket, SearchInput.Text ) )	Name veya Company sütununun arama dizesiyle (örneğin, co) başladığı kayıtlar için Customers veri kaynağını filtreler. İşlevlerden || biri StartsWithtrue ise işleci true olur.
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.