แชร์ผ่าน

ฟังก์ชัน EndsWith และ StartsWith

  • บทความ

ใช้กับ: แอปพื้นที่ทำงาน โฟลว์เดสก์ท็อป คอลัมน์สูตร Dataverse แอปแบบจำลอง Power Platform CLI

ทดสอบว่าสตริงข้อความเริ่มต้น หรือลงท้ายสตริงข้อความอื่นหรือไม่

คำอธิบาย

ฟังก์ชัน EndsWith ทดสอบว่าสตริงข้อความหนึ่งลงท้ายด้วยอีกสตริงหรือไม่

ฟังก์ชัน StartsWith ทดสอบว่าสตริงข้อความหนึ่งเริ่มต้นด้วยอีกสตริงหรือไม่

สำหรับทั้งสองฟังก์ชัน การทดสอบตรงตามตัวพิมพ์เล็ก-ใหญ่หรือไม่ ค่าที่ส่งกลับทั้งสองค่าเป็นบูลีน จริง หรือ เท็จ

ใช้ EndsWith และ StartsWith ด้วยฟังก์ชัน Filter ค้นหาข้อมูลภายในแอปของคุณ คุณยังสามารถใช้ตัวดำเนินการ in หรือฟังก์ชัน Search เพื่อค้นหาที่ใดก็ได้ภายในสตริงข้อความ ไม่ใช่เพียงแค่ที่จุดเริ่มต้นหรือจุดสิ้นสุดได้ ตัวเลือกของฟังก์ชันจะขึ้นอยู่กับความต้องการของแอปคุณ และฟังก์ชันที่สามารถ มอบหมาย สำหรับแหล่งข้อมูลเฉพาะของคุณ ถ้าไม่สามารถมอบสิทธิ์ให้หนึ่งในฟังก์ชันเหล่านี้ คำเตือนเกี่ยวกับการรับมอบสิทธิ์จะปรากฏขึ้นเมื่อทำการเขียน เพื่อเตือนคุณเกี่ยวกับข้อจำกัดนี้

ไวยากรณ์

EndsWith( Text, EndText )

  • ข้อความ - จำเป็น ข้อความที่จะทดสอบ
  • EndTex – จำเป็น ข้อความที่จะค้นหาที่ส่วนท้ายของ ข้อความ ถ้า EndText เป็นสตริงที่ว่างเปล่า EndsWith ส่งกลับว่า จริง

StartsWith( Text, StartText )

  • ข้อความ - จำเป็น ข้อความที่จะทดสอบ
  • StartText – จำเป็น ข้อความที่จะค้นหาที่ส่วนเริ่มต้นของ ข้อความ ถ้า StartText เป็นสตริงที่ว่างเปล่า StartsWith ส่งกลับว่า จริง

ตัวอย่าง

สูตร คำอธิบาย ผลลัพธ์
EndsWith( "Hello World", "world" ) ทดสอบว่า "Hello, World" สิ้นสุดด้วย "world" หรือไม่ การทดสอบไม่ต้องตรงตามตัวอักษรพิมพ์ใหญ่-เล็ก true
EndsWith( "Good bye", "good" ) ทดสอบว่า "Good bye" ลงท้ายด้วย "good" หรือไม่ อาร์กิวเมนต์ EndText ("good") ปรากฏในข้อความ แต่ไม่อยู่ที่ส่วนท้าย false
EndsWith( "Always say hello", "hello" ) ทดสอบว่า "Always say hello" ลงท้ายด้วย "hello" หรือไม่ true
EndsWith( "Bye bye", "" ) ทดสอบว่า "Bye bye" ลงท้ายด้วยเป็นสตริงข้อความว่าง (Len ส่งกลับค่า 0) หรือไม่ ช่วยแบ่งเบาการใช้งานในนิพจน์ ตัวกรองEndsWith ถูกกำหนดให้ส่งค่ากลับ จริง ในกรณีนี้ true
สูตร คำอธิบาย ผลลัพธ์
StartsWith( "Hello World", "hello" ) ทดสอบว่า "Hello, World" เริ่มต้นด้วย "hello" หรือไม่ การทดสอบไม่ต้องตรงตามตัวอักษรพิมพ์ใหญ่-เล็ก true
StartsWith( "Good bye", "hello" ) ทดสอบว่า "Good bye" เริ่มต้นด้วย "hello" หรือไม่ false
EndsWith( "Always say hello", "hello" ) ทดสอบว่า "Always say hello" เริ่มต้นด้วย "hello" หรือไม่ แม้ว่า "hello" ปรากฏในข้อความ แต่ไม่ปรากฏเมื่อเริ่มต้น false
StartsWith( "Bye bye", "" ) ทดสอบว่า "Bye bye" เริ่มต้นด้วยเป็นสตริงข้อความว่าง (Len ส่งกลับค่า 0) ช่วยแบ่งเบาการใช้งานในนิพจน์ ตัวกรองStartsWith ถูกกำหนดให้ส่งค่ากลับ จริง ในกรณีนี้ true

ประสบการณ์ของผู้ใช้การค้นหา

ในหลายแอป คุณสามารถพิมพ์อักขระอย่างน้อยหนึ่งตัวลงในกล่องค้นหาเพื่อกรองรายการของเรกคอร์ดในชุดข้อมูลขนาดใหญ่ ขณะที่คุณพิมพ์ รายการจะแสดงเฉพาะเรกคอร์ดที่ตรงกับเกณฑ์การค้นหาเท่านั้น

ตัวอย่างในส่วนที่เหลือของหัวข้อนี้แสดงผลลัพธ์ของการค้นหารายการ ลูกค้า ที่ประกอบด้วยข้อมูลนี้:

ตัวอย่างของรายการลูกค้า

เมื่อต้องการสร้างแหล่งข้อมูลนี้เป็นคอลเลกชัน ให้สร้างตัวควบคุม ปุ่ม และตั้งค่าคุณสมบัติ OnSelect เป็นสูตรดังนี้:

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

เช่นเดียวกับตัวอย่างนี้ คุณสามารถแสดงรายการของเรกคอร์ดใน ตัวควบคุมแกลเลอรี ที่ด้านล่างของหน้าจอได้ ใกล้กับด้านบนของหน้าจอ คุณสามารถเพิ่มตัวควบคุม การป้อนข้อความ ที่ชื่อ SearchInput เพื่อให้ผู้ใช้สามารถระบุเรกคอร์ดที่สนใจได้

แกลเลอรีลูกค้า

เมื่อผู้ใช้พิมพ์อักขระใน SearchInput ผลลัพธ์ในแกลเลอรีจะถูกกรองโดยอัตโนมัติ ในกรณีนี้ มีการกำหนดค่าแกลเลอรีให้แสดงเรกคอร์ดที่ชื่อของลูกค้า (ไม่ใช่ชื่อของบริษัท) เริ่มต้นด้วยลำดับของอักขระใน SearchInput ถ้าผู้ใช้พิมพ์ co ในกล่องค้นหา แกลเลอรีแสดงผลลัพธ์เหล่านี้:

แกลเลอรีลูกค้าพร้อมการค้นหา

เมื่อต้องการกรองโดยยึดตามคอลัมน์ ชื่อ ให้ตั้งค่าคุณสมบัติ Items ของตัวควบคุมแกลเลอรีเป็นหนึ่งในสูตรเหล่านี้:

สูตร คำอธิบาย ผลลัพธ์
Filter( Customers, StartsWith( Name, SearchInput.Text ) ) กรองแหล่งข้อมูล ลูกค้า สำหรับเรกคอร์ดที่สตริงการค้นหาปรากฏขึ้นที่จุดเริ่มต้นของคอลัมน์ ชื่อ การทดสอบไม่ต้องตรงตามตัวอักษรพิมพ์ใหญ่-เล็ก ถ้าผู้ใช้พิมพ์ co ในกล่องค้นหา แกลเลอรีจะแสดง Colleen Jones และ Cole Miller แกลเลอรีจะไม่แสดง Mike Collins เนื่องจากคอลัมน์ Name ของเรกคอร์ดนั้นไม่ได้เริ่มต้นด้วยสตริงการค้นหา ตัวอย่างของ StartsWith
Filter( Customers, SearchInput.Text in Name ) กรองแหล่งข้อมูล ลูกค้า สำหรับเรกคอร์ดที่สตริงการค้นหาปรากฏที่ใดก็ได้ในคอลัมน์ ชื่อ การทดสอบไม่ต้องตรงตามตัวอักษรพิมพ์ใหญ่-เล็ก ถ้าผู้ใช้พิมพ์ co ในกล่องค้นหา แกลเลอรีจะแสดง Colleen Jones,Cole Miller, และ Mike Collins เนื่องจากการค้นหา สตริงที่ปรากฏอยู่ที่ใดที่หนึ่งในคอลัมน์ ชื่อ ของเรกคอร์ดทั้งหมดเหล่านั้น ตัวอย่าง SearchInput.Text ในชื่อ
Search( Customers, SearchInput.Text, "Name" ) คล้ายกับการใช้ตัวดำเนินการ in ฟังก์ชัน Search ค้นหารายการตรงกันจากทุกที่ภายในคอลัมน์ ชื่อ ของแต่ละเรกคอร์ด โปรดทราบว่า คุณต้องใส่ชื่อคอลัมน์ในเครื่องหมายอัญประกาศคู่ ตัวอย่าง SearchInput.Text พร้อมชื่อ

คุณสามารถขยายการค้นหาของคุณให้รวมถึงคอลัมน์ บริษัท เช่นเดียวกับคอลัมน์ ชื่อ ได้:

สูตร คำอธิบาย ผลลัพธ์
Filter( Customers, StartsWith( Name, SearchInput.Text ) || StartsWith( Company, SearchInput.Text ) ) กรองแหล่งข้อมูล ลูกค้า สำหรับเรกคอร์ดที่คอลัมน์ ชื่อ หรือ บริษัท เริ่มต้นด้วยสตริงการค้นหา (ตัวอย่างเช่น co) || ตัวดำเนินการ เป็น จริง ถ้าฟังก์ชัน StartsWith ใดก็ตามเป็น จริง กรองด้วย StartsWith
Filter( Customers, SearchInput.Text in Name || SearchInput.Text in Company ) กรองแหล่งข้อมูล ลูกค้า สำหรับเรกคอร์ดที่คอลัมน์ ชื่อ หรือ บริษัท มีสตริงการค้นหา (ตัวอย่างเช่น co) ที่ใดก็ได้ภายในนั้น กรองด้วยข้อความค้นหาในชื่อ
Search( Customers, SearchInput.Text, "Name", "Company" ) คล้ายกับการใช้ตัวดำเนินการ in ฟังก์ชัน Search ค้นหาแหล่งข้อมูล ลูกค้า สำหรับเรกคอร์ดที่คอลัมน์ ชื่อ หรือ บริษัท มีสตริงการค้นหา (ตัวอย่างเช่น co) ที่ใดก็ได้ภายในนั้น ฟังก์ชัน Search จะง่ายต่อการอ่านและเขียนกว่า Filter ถ้าคุณต้องการระบุหลายคอลัมน์และหลายตัวดำเนินการ in โปรดทราบว่า คุณต้องใส่ชื่อของคอลัมน์ในเครื่องหมายอัญประกาศคู่ กรองด้วยข้อความค้นหาในชื่อ บริษัท