Συνάρτηση Set

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

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

Επισκόπηση

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

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

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

Περιγραφή

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

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

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

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

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

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

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

Σύνταξη

Set( VariableName, Value )

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

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

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