Share via

הפונקציה Set

  • מאמר

חל על: יישומי בד ציור כרטיסים Dataverse יישומי plug-in בתכנות פשוט Power Platform CLI

מגדירה את הערך של משתנה כללי.

מבט כולל

השתמש בפונקציה Set כדי להגדיר את הערך של משתנה כללי, אשר שומר זמנית פיסת מידע, כגון מספר הפעמים שהמשתמש בחר בלחצן או התוצאה של פעולת נתונים.

משתנים כלליים זמינים בכל רחבי היישום שלך בכל המסכים. אלה המשתנים מהסוג הפשוט ביותר והם ממלאים את הצרכים של רוב המצבים. קיימים גם משתני הקשר שהטווח שלהם מיועד למסך יחיד ואוספים המאפשרים שינויים ברמת השורה בטבלאות. לקבלת מידע נוסף אודות אפשרויות אחרות אלה, סקור את הנושא הכרת משתנים.

Power Apps מבוססים על נוסחאות המבצעות חישוב מחדש באופן אוטומטי כאשר המשתמש מקיים אינטראקציה עם יישום. כל נוסחה התלויה במשתנה תתעדכן אוטומטית כאשר תשתנה. עם זאת, המשתנה לא יתעדכן אוטומטית אם ערך הנוסחה המשמש בפונקציה Set ישתנה. הדבר דורש מיוצר היישום לעדכן ידנית את המשתנה, מה שעשוי להיות מועד לשגיאות וקשה יותר להבנה עבור אחרים. לפני שתשתמש במשתנה, סקור את הנושא הכרת משתנים.

תיאור

משתנים כלליים נוצרים באופן מרומז באמצעות הפונקציה Set. לא נדרשת הצהרה מפורשת. אם תסיר את כל פונקציות Set עבור משתנה כללי, משתנה כללי זה יפסיק להתקיים. כדי לנקות משתנה, הגדר את ערכו לתוצאה של הפונקציה Blank.

באפשרותך לראות את ערכי המשתנים, את ההגדרות ואת השימושים עם התצוגה 'משתנים' תחת התפריט קובץ ב- Power Apps Studio.

כפי שהדוגמאות בהמשך הנושא מציגות, משתנים כלליים יכולים לשמור מספר סוגים של מידע, לרבות הסוגים הבאים:

  • ערך יחיד
  • רשומה
  • טבלה
  • הפניה לאובייקט
  • כל תוצאה מנוסחה

משתנה כללי שומר על הערך שלו עד שהיישום נסגר. לאחר סגירת היישום, ערך המשתנה הכללי יאבד ויש ליצור אותו מחדש כאשר היישום ייטען שוב.

משתנים כלליים אינם יכולים להשתמש באותו שם כשל אוסף או פקד קיימים. הם יכולים להשתמש באותו שם כמשתנה הקשר. כדי להבדיל בין השניים, השתמש באופרטור הבהרה.

ל- Set אין ערך החזרה ובאפשרותך להשתמש בה רק בתוך נוסחה של אופן פעולה.

תחביר

Set( VariableName, Value )

  • VariableName - נדרש. שם משתנה כללי ליצירה או עדכון.
  • Value - נדרש. הערך שיש להקצות למשתנה ההקשר.

דוגמאות

נוסחה תיאור תוצאה
Set( Counter, 1 ) יוצר או משנה את המשתנה הכללי מונה, ומגדיר את ערכו ל- 1. מונה הוא בעל ערך של 1. באפשרותך להפנות למשתנה זה באמצעות השם מונה בנוסחה במסך כלשהו.
Set( Counter, 2 ) מגדיר את הערך של המשתנה הכללי מונה מהדוגמה הקודמת ל- 2. מונה הוא בעל ערך של 2.
Set( Counter, Counter + 1 ) מגדיל באופן הדרגתי את הערך של המשתנה הכללי מונה מהדוגמה הקודמת ל- 3. מונה הוא בעל ערך של 3.
Set( Name, "Lily" ) יוצר או משנה את המשתנה הכללי שם, ומגדיר את ערכו לשירה. שם הוא בעל הערך שירה.
Set( Person, { Name: "Milton", Address: "1 Main St" } ) יוצר או משנה את המשתנה הכללי אדם, ומגדיר את ערכו לרשומה. הרשומה מכילה שתי עמודות בשם שם וכתובת. הערך של העמודה שם הוא איתי והערך של העמודה כתובת הוא רחוב צה"ל 1. אדם כולל את הערך של הרשומה { Name: "Milton", Address: "1 Main St" }.

הפנה לרשומה זו בשלמותה עם השם אדם, או הפנה לעמודה בודדת של רשומה זו עם Person.Name או Person.Address.
Set( Person, Patch( Person, {Address: "2 Main St" } ) ) עובד עם הפונקציה Patch כדי לעדכן את המשתנה הכללי אדם על-ידי הגדרת הערך של העמודה כתובת לרחוב צה"ל 2. אדם כולל כעת את הערך של הרשומה { Name: "Milton", Address: "2 Main St" }.