שתף באמצעות


Set פונקציה

חל על: אפליקציות Canvas שולחן העבודה זורם פונקציות CLI Dataverse של Power Platform

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

מבט כולל

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

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

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

תיאור

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

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

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

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

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

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

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

תחביר

Set( VariableName, Value )

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

דוגמאות

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

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