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

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

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

Περιγραφή

Η 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( Εταιρεία, 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. Σημειώστε ότι πρέπει να περικλείσετε τα ονόματα των στηλών σε διπλά εισαγωγικά.