Συνάρτηση Set

Ισχύει σε: Εφαρμογές καμβά Κάρτες Προσθήκες Dataverse χαμηλών απαιτήσεων κώδικα Power Platform CLI

Ορίζει την τιμή μιας καθολικής μεταβλητής.

Επισκόπηση

Χρησιμοποιήστε τη συνάρτηση Set για να ορίσετε την τιμή μιας καθολικής μεταβλητής, η οποία διατηρεί προσωρινά ένα τμήμα πληροφοριών, όπως πόσες φορές επέλεξε ο χρήστης ένα κουμπί ή το αποτέλεσμα μιας λειτουργίας δεδομένων.

Οι καθολικές μεταβλητές είναι διαθέσιμες σε όλες τις οθόνες στην εφαρμογή σας. Αυτές είναι ο απλούστερος τύπος μεταβλητών και καλύπτουν τις ανάγκες στις περισσότερες περιπτώσεις. Υπάρχουν επίσης μεταβλητές περιβάλλοντος, οι οποίες εμφανίζονται σε μια μοναδική οθόνη, και συλλογές που επιτρέπουν τροποποιήσεις σε επίπεδο γραμμής στους πίνακες. Για περισσότερες πληροφορίες σχετικά με αυτές τις άλλες επιλογές, ρίξτε μια ματιά στο θέμα Κατανόηση μεταβλητών.

Το Power Apps βασίζεται σε τύπους που υπολογίζονται αυτόματα εκ νέου καθώς ο χρήστης αλληλεπιδρά με μια εφαρμογή. Όλοι οι τύποι που εξαρτώνται από μια μεταβλητή θα ενημερώνονται αυτόματα κατά την αλλαγή της. Ωστόσο, η μεταβλητή δεν θα ενημερώνεται αυτόματα εάν η τιμή του τύπου που χρησιμοποιείται στη συνάρτηση Set αλλάξει. Αυτό απαιτεί από τον δημιουργό της εφαρμογής να ενημερώσει με μη αυτόματο τρόπο τη μεταβλητή, η οποία μπορεί να είναι επιρρεπής σε σφάλματα και δυσκολότερη για τους άλλους να την κατανοήσουν. Πριν χρησιμοποιήσετε μια μεταβλητή, ανατρέξτε στο θέμα Κατανόηση μεταβλητών.

Περιγραφή

Οι καθολικές μεταβλητές δημιουργούνται με μη ρητό τρόπο με χρήση της συνάρτησης Set. Δεν απαιτείται κάποια ρητή δήλωση. Εάν καταργήσετε όλες τις συναρτήσεις Set για μια καθολική μεταβλητή, τότε αυτή η μεταβλητή θα πάψει να υφίσταται. Για τη απαλοιφή μιας μεταβλητής ορίστε την τιμή της στο αποτέλεσμα της συνάρτησης Blank.

Μπορείτε να δείτε τις τιμές, τους ορισμούς και χρήσεις των μεταβλητών σας με την προβολή Μεταβλητές στο μενού Αρχείο, στο Power Apps Studio.

Όπως παρουσιάζεται στα παραδείγματα παρακάτω σε αυτό το θέμα, οι καθολικές μεταβλητές μπορούν να τηρούν πολλών ειδών πληροφορίες, όπως τις παρακάτω:

• μια μεμονωμένη τιμή
• μια καρτέλα
• έναν πίνακα
• μια αναφορά αντικειμένου
• οποιοδήποτε αποτέλεσμα από έναν τύπο

Μια καθολική μεταβλητή διατηρεί την τιμή της μέχρι να κλείσει η εφαρμογή. Όταν κλείσει, η τιμή της καθολικής μεταβλητής θα χαθεί και πρέπει να δημιουργηθεί εκ νέου όταν φορτωθεί πάλι η εφαρμογή.

Οι καθολικές μεταβλητές δεν μπορούν να χρησιμοποιήσουν το ίδιο όνομα με μια υπάρχουσα συλλογή ή στοιχείο ελέγχου. Μπορεί να χρησιμοποιεί το ίδιο όνομα με μια μεταβλητή περιβάλλοντος. Για να τις διακρίνετε μεταξύ τους, χρησιμοποιήστε τον τελεστή αποσαφήνισης.

Η συνάρτηση Set δεν επιστρέφει καμία τιμή και μπορείτε να τη χρησιμοποιήσετε μόνο σε έναν τύπο συμπεριφοράς.

Σύνταξη

Set( VariableName, Value )

• VariableName - Υποχρεωτικό. Το όνομα μιας καθολικής μεταβλητής για δημιουργία ή ενημέρωση.
• Value - Υποχρεωτικό. Η τιμή προς εκχώρηση στη μεταβλητή περιβάλλοντος.

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

Τύπος	Περιγραφή	Αποτέλεσμα
Set( Counter, 1 )	Δημιουργεί ή τροποποιεί την καθολική μεταβλητή Counter ρυθμίζοντας την τιμή της σε 1.	Η μεταβλητή Counter έχει τιμή 1. Μπορείτε να αναφέρετε τη μεταβλητή αυτή χρησιμοποιώντας το όνομα Counter σε έναν τύπο σε οποιαδήποτε οθόνη.
Set( Counter, 2 )	Ορίζει την τιμή της καθολικής μεταβλητής Counter από το προηγούμενο παράδειγμα σε 2.	Η μεταβλητή Counter έχει τιμή 2.
Set( Counter, Counter + 1 )	Αυξάνει την τιμή της καθολικής μεταβλητής Counter από το προηγούμενο παράδειγμα σε 3.	Η μεταβλητή Counter έχει τιμή 3.
Set( Name, "Lily" )	Δημιουργεί ή τροποποιεί την καθολική μεταβλητή Name ρυθμίζοντας την τιμή της σε Lily.	Η μεταβλητή Name έχει τιμή Lily.
Set( Person, { Name: "Milton", Address: "1 Main St" } )	Δημιουργεί ή τροποποιεί την καθολική μεταβλητή Person ρυθμίζοντας την τιμή της σε μια εγγραφή. Η εγγραφή περιέχει δύο στήλες με τις ονομασίες Name και Address. Η τιμή της στήλης Name είναι Milton και η τιμή της στήλης Address είναι 1 Main St.	Η μεταβλητή Person έχει την τιμή εγγραφής {Name: "Milton", Address: "1 Main St"}. Αναφέρετε ολόκληρη την εγγραφή αυτή με το όνομα Person ή μια μεμονωμένη στήλη της εγγραφής με την ονομασία Person.Name ή Person.Address.
Set( Person, Patch( Person, {Address: "2 Main St" } ) )	Λειτουργεί με τη συνάρτηση Patch για να ενημερωθεί η καθολική μεταβλητή Person, ρυθμίζοντας την τιμή της στήλης Address σε 2 Main St.	Η μεταβλητή Person έχει τώρα την τιμή εγγραφής {Name: "Milton", Address: "2 Main St"}