الدالة Set

ينطبق على: تطبيقات اللوحة بطاقات قليل التعليمات البرمجية CLI Dataverse للمكونات Power Platform الإضافية

تعيين قيمة متغير عمومي

نظرة عامة‬

استخدم وظيفة Set لتعيين قيمة متغير عام ، يحتفظ مؤقتًا بجزء من المعلومات ، مثل عدد المرات التي حدد فيها المستخدم زرًا أو نتيجة عملية بيانات.

تتوفر المتغيرات العمومية في جميع أنحاء تطبيقك على جميع الشاشات. هذه هي أبسط أنواع المتغيرات وتفي باحتياجات معظم المواقف. هناك أيضًا متغيرات السياق التي يتم تحديد نطاقها على شاشة واحدة ومجموعات تسمح بتعديل مستوى الصف في الجداول. لمزيد من المعلومات حول هذه الخيارات الأخرى، راجع فهم المتغيرات.

يستند Power Apps إلى الصيغ التي تقوم تلقائيا بإعادة حسابها أثناء تفاعل المستخدم مع أحد التطبيقات. سيتم تحديث أي صيغ تعتمد على متغير تلقائيًا عندما تتغير. ومع ذلك، لن يتم تحديث المتغير تلقائيًا في حالة تغيير قيمة الصيغة المستخدمة في وظيفة Set. يتطلب هذا من صانع التطبيق تحديث المتغير يدويًا ، والذي يمكن أن يكون عرضة للخطأ ويصعب على الآخرين فهمه. قبل استخدام متغير، يمكنك مراجعة فهم المتغيرات.

‏‏الوصف

يتم إنشاء المتغيرات العمومية ضمنيا باستخدام وظيفة Set. لا يلزم إعلان صريح. في حالة قيامك بإزالة وظائف Set بالنسبة للمتغير العمومي، فإن هذا المتغير الشامل سوف يزول من الوجود. لمسح متغير، قم بتعيين قيمته إلى نتيجة وظيفة Blank.

يمكنك أن ترى قيم المتغيرات والتعاريف والاستخدامات مع عرض المتغيرات ضمن قائمة الملف في Power Apps Studio.

كما تظهر الأمثلة في هذا الموضوع لاحقًا ، يمكن للمتغيرات العالمية أن تحتفظ بعدة أنواع من المعلومات ، بما في ذلك ما يلي:

• قيمة واحدة
• سجل
• جدول‏‎
• مرجع كائن
• أي نتيجة من الصيغة

متغير عام يحتفظ بقيمته حتى يتم إغلاق التطبيق. بمجرد الإغلاق ، ستفقد قيمة المتغير العام ويجب إعادة إنشائه عند تحميل التطبيق مرة أخرى.

لا يمكن للمتغيرات العامة استخدام نفس الاسم كمجموعة أو عنصر تحكم موجود. يمكنه استخدام نفس الاسم كمتغير سياق. للتوضيح بين الاثنين ، استخدم عامل التوضيح.

لا يحتوي Set على قيمة إرجاع، ويمكنك استخدامه فقط ضمن صيغة سلوك. ...

بناء الجملة

تعيين ( اسم المتغير ، القيمة )

• اسم المتغير- مطلوب. اسم المتغير العمومي الذي سيتم إنشاؤه أو تحديثه.
• القيمة - مطلوبة. القيمة المطلوب تخصيصها لمتغير السياق.

الأمثلة

صيغة	‏‏الوصف	نتيجة
مجموعة (عداد ، 1)	إنشاء أو تعديل المتغير العام Counter، وتعيين قيمتها إلى 1.	العداد له القيمة 1. يمكنك الرجوع إلى هذا المتغير باستخدام الاسم Counter في صيغة على أي شاشة.
مجموعة (عداد ، 2)	قم بتعيين قيمة المتغير العمومي Counter من المثال السابق إلى 2.	العداد له القيمة 2.
مجموعة (عداد ، عداد + 1)	زيادة قيمة المتغير العمومي Counter من المثال السابق إلى 3.	العداد له القيمة 3.
مجموعة (الاسم ، "ليلي")	إنشاء أو تعديل المتغير العام Name، وتعيين قيمتها إلى Lily.	الاسم له قيمة ليلي.
مجموعة (شخص ، { الاسم: "ميلتون" ، العنوان: "1 الشارع الرئيسي") }	إنشاء أو تعديل المتغير العام Person، وتعيي قيمته إلى سجل. يحتوي السجل على عمودين باسم Name وAddress. وقيمة عمود Name هي Milton، وقيمة عمود العنوان هو 1 Main St.	الشخص لديه قيمة السجل { الاسم: "ميلتون" ، العنوان: "1 الشارع الرئيسي". } مرجع هذا السجل ككل بالاسم Person، أو مرجع عمود فردي لهذا السجل بـ Person.Name أو Person.Address.
مجموعة (شخص ، تصحيح (شخص ، { عنوان: "2 الشارع الرئيسي") }	التعامل مع وظيفة Patch لتحديث المتغير العمومي Person عن طريق تعيين قيمة عمود Address إلى 2 Main St.	الشخص لديه الآن قيمة اسم السجل { : "ميلتون" ، العنوان: "2 الشارع الرئيسي". }