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

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

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

Περιγραφή

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

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

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

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

Σύνταξη

EndsWith( Κείμενο; Τελικό κείμενο )

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

StartsWith( Κείμενο;ΚείμενοΈναρξης )

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

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

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

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

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

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

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

Για να δημιουργήσετε αυτήν την προέλευση δεδομένων ως συλλογή, δημιουργήστε ένα στοιχείο ελέγχου Button και ορίστε την ιδιότητα OnSelect σε αυτόν τον τύπο:

ClearCollect( Πελάτες, Πίνακας ( { Όνομα: "Fred Garcia", Εταιρεία: "Northwind Traders" }; { Όνομα: "Cole Miller", Εταιρεία: "Contoso" }; { Όνομα: "Glenda Johnson", Εταιρεία: "Contoso" }; { Όνομα: "Mike Collins", Εταιρεία: "Adventure Works" }; { Όνομα: "Colleen Jones", Εταιρεία: "Adventure Works" } ) )

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

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

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

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

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

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