Συναρτήσεις EndsWith και StartsWith

Ισχύει σε: Εφαρμογές καμβά Ροές επιφάνειας εργασίας Στήλες φόρμουλας Dataverse Εφαρμογές που βασίζονται σε μοντέλα Power Pages Power Platform CLI

Ελέγχει αν μια συμβολοσειρά κειμένου ξεκινά ή τελειώνει μια άλλη συμβολοσειρά κειμένου.

Περιγραφή

Η συνάρτηση EndsWith ελέγχει αν μια συμβολοσειρά κειμένου τελειώνει με μια άλλη.

Η συνάρτηση StartsWith ελέγχει αν μια συμβολοσειρά κειμένου ξεκινά με μια άλλη.

Και για τις δύο λειτουργίες, οι δοκιμές δεν κάνουν διάκριση πεζών-κεφαλαίων, εάν η προέλευση δεδομένων παρασκηνίου την υποστηρίζει από προεπιλογή. Για παράδειγμα, οι συλλογές, το Dataverse, το SharePoint και ο SQL Server υποστηρίζουν από προεπιλογή την έλλειψη ευαισθησίας στην πεζότητα. Η Oracle όχι. Η τιμή επιστροφής και των δύο είναι μια δυαδική τιμή true ή false.

Χρησιμοποιήστε το EndsWith και StartsWith με τη συνάρτηση Filter για αναζήτηση των δεδομένων μέσα στην εφαρμογή σας. Μπορείτε επίσης να χρησιμοποιήσετε τον τελεστή in ή τη συνάρτηση Search για να κάνετε αναζήτηση οπουδήποτε μέσα σε συμβολοσειρές κειμένου, όχι μόνο στην αρχή ή στο τέλος. Οι συναρτήσεις που θα επιλέξετε θα εξαρτώνται από τις ανάγκες της εφαρμογής σας και ποια λειτουργία μπορεί να ανατεθεί για τη συγκεκριμένη προέλευση δεδομένων. Εάν κάποια από αυτές τις συναρτήσεις δεν μπορεί να ανατεθεί, θα εμφανιστεί μια προειδοποίηση ανάθεσης κατά τη σύνταξη που σας προειδοποιεί για αυτόν τον περιορισμό.

Σύνταξη

EndsWith( Text, EndText )

• Text – Υποχρεωτικό. Το κείμενο για έλεγχο.
• EndText – Υποχρεωτικό. Το κείμενο για αναζήτηση στο τέλος του Κειμένου. Εάν το όρισμα EndText είναι μια κενή συμβολοσειρά, η συνάρτηση EndsWith επιστρέφει true.

StartsWith( Text, StartText )

• Text – Υποχρεωτικό. Το κείμενο για έλεγχο.
• StartText – Υποχρεωτικό. Το κείμενο για αναζήτηση στην αρχή του Κειμένου. Εάν το όρισμα StartText είναι μια κενή συμβολοσειρά, η συνάρτηση StartsWith επιστρέφει true.

Παραδείγματα

Τύπος	Περιγραφή	Αποτέλεσμα
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). Για διευκόλυνση της χρήσης της σε παραστάσεις Filter, η συνάρτηση EndsWith ορίζεται να επιστρέφει true σε αυτή την περίπτωση.	true

Τύπος	Περιγραφή	Αποτέλεσμα
StartsWith( "Hello World"; "hello" )	Ελέγχει εάν το "Hello World" ξεκινά με "hello". Η δοκιμή δεν κάνει διάκριση πεζών-κεφαλαίων.	true
StartsWith( "Good bye"; "hello" )	Ελέγχει εάν το "Good bye" ξεκινά με "hello".	false
StartsWith( "Always say hello"; "hello" )	Ελέγχει εάν το "Always say hello" ξεκινά με "hello". Παρόλο που το "hello" εμφανίζεται στο κείμενο, δεν εμφανίζεται στην αρχή.	false
StartsWith( "Bye bye"; "" )	Ελέγχει εάν το "Bye bye" ξεκινά με κενή συμβολοσειρά κειμένου (η συνάρτηση Len επιστρέφει 0). Για διευκόλυνση της χρήσης της σε παραστάσεις Filter, η συνάρτηση StartsWith ορίζεται να επιστρέφει true σε αυτή την περίπτωση.	true

Εμπειρία αναζήτησης χρήστη

Σε πολλές εφαρμογές, μπορείτε να πληκτρολογήσετε έναν ή περισσότερους χαρακτήρες σε ένα πλαίσιο αναζήτησης για να φιλτράρετε μια λίστα εγγραφών σε ένα μεγάλο σύνολο δεδομένων. Καθώς πληκτρολογείτε, η λίστα εμφανίζει μόνο εκείνες τις εγγραφές που ικανοποιούν τα κριτήρια αναζήτησης.

Τα παραδείγματα στο υπόλοιπο μέρος αυτού του θέματος εμφανίζουν τα αποτελέσματα αναζήτησης μιας λίστας Customers που περιέχει αυτά τα δεδομένα:

Για να δημιουργήσετε αυτήν την προέλευση δεδομένων ως συλλογή, δημιουργήστε ένα στοιχείο ελέγχου Button και ορίστε την ιδιότητα 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" } ) )

Όπως και σε αυτό το παράδειγμα, μπορείτε να εμφανίσετε μια λίστα εγγραφών σε ένα στοιχείο ελέγχου Συλλογή στο κάτω μέρος μιας οθόνης. Κοντά στο επάνω μέρος της οθόνης, μπορείτε να προσθέσετε ένα στοιχείο ελέγχου Text input, που ονομάζεται SearchInput, ώστε οι χρήστες να μπορούν να καθορίσουν τις εγγραφές που τους ενδιαφέρουν.

Καθώς ο χρήστης πληκτρολογεί χαρακτήρες στο στοιχείο ελέγχου SearchInput, τα αποτελέσματα της συλλογής φιλτράρονται αυτόματα. Στην περίπτωση αυτή, η συλλογή έχει ρυθμιστεί για την εμφάνιση εγγραφών για τις οποίες το όνομα του πελάτη (όχι το όνομα της εταιρείας) ξεκινά με τη σειρά των χαρακτήρων στο SearchInput. Εάν ο χρήστης πληκτρολογήσει co στο πλαίσιο αναζήτησης, η συλλογή εμφανίζει αυτά τα αποτελέσματα:

Για να φιλτράρετε με βάση τη στήλη Όνομα, ορίστε την ιδιότητα Items του στοιχείου ελέγχου "Συλλογή" σε έναν από αυτούς τους τύπους:

Τύπος	Περιγραφή	Αποτέλεσμα
Filter( Customers, StartsWith( Name, SearchInput.Text ) )	Φιλτράρει την προέλευση δεδομένων Customers για εγγραφές στις οποίες η συμβολοσειρά αναζήτησης εμφανίζεται στην αρχή της στήλης Name. Η δοκιμή δεν κάνει διάκριση πεζών-κεφαλαίων. Εάν ο χρήστης πληκτρολογήσει co στο πλαίσιο αναζήτησης, η συλλογή εμφανίζει Colleen Jones και Cole Miller. Η συλλογή δεν εμφανίζει το όνομα Mike Collins επειδή η στήλη Name για τη συγκεκριμένη εγγραφή δεν ξεκινά με τη συμβολοσειρά αναζήτησης.
Filter( Customers, SearchInput.Text in Name )	Φιλτράρει την προέλευση δεδομένων Customers για εγγραφές στις οποίες η συμβολοσειρά αναζήτησης εμφανίζεται οπουδήποτε στη στήλη Name. Η δοκιμή δεν κάνει διάκριση πεζών-κεφαλαίων. Εάν ο χρήστης πληκτρολογήσει co στο πλαίσιο αναζήτησης, η συλλογή εμφανίζει τα ονόματα Colleen Jones,Cole Miller και Mike Collins, επειδή η συμβολοσειρά αναζήτησης εμφανίζεται κάπου στη στήλη Name όλων αυτών των καρτελών.
Search( Customers, SearchInput.Text, "Name" )	Παρόμοια με τη χρήση του τελεστή in, η συνάρτηση Search αναζητεί μια αντιστοίχιση σε οποιοδήποτε σημείο μέσα στη στήλη Όνομα κάθε εγγραφής. Σημειώστε ότι πρέπει να περικλείσετε τη στήλη Όνομα σε διπλά εισαγωγικά.

Μπορείτε να επεκτείνετε την αναζήτησή σας για να συμπεριλάβετε τη στήλη Εταιρεία καθώς και τη στήλη Όνομα:

Τύπος	Περιγραφή	Αποτέλεσμα
Filter( Customers, StartsWith( Name, SearchInput.Text ) || StartsWith( Company, SearchInput.Text ) )	Φιλτράρει την πηγή δεδομένων Πελάτες για εγγραφές στις οποίες είτε η στήλη Όνομα είτε η στήλη Εταιρία ξεκινά με τη συμβολοσειρά αναζήτησης (για παράδειγμα, co). Ο ||τελεστής είναι true, εάν οποιαδήποτε συνάρτηση StartsWith είναι true.
Filter( Customers, SearchInput.Text in Name || SearchInput.Text in Company )	Φιλτράρει την προέλευση δεδομένων Company για εγγραφές στις οποίες είτε η στήλη Name, είτε η στήλη Company περιέχει οπουδήποτε τη συμβολοσειρά αναζήτησης (για παράδειγμα, co).
Search( Customers, SearchInput.Text, "Name", "Company" )	Παρόμοια με τη χρήση του τελεστή in, η συνάρτηση Search εκτελεί αναζήτηση στην προέλευση δεδομένων Πελάτες για εγγραφές στις οποίες είτε η στήλη Όνομα είτε η στήλη Εταιρεία περιέχει οπουδήποτε τη συμβολοσειρά αναζήτησης (για παράδειγμα, co). Η ανάγνωση και εγγραφή της συνάρτησης Search είναι πιο εύκολη από εκείνη της συνάρτησης Filter, αν θέλετε να καθορίσετε πολλές στήλες και πολλούς τελεστές in. Σημειώστε ότι πρέπει να περικλείσετε τα ονόματα των στηλών σε διπλά εισαγωγικά.