إشعار
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تسجيل الدخول أو تغيير الدلائل.
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تغيير الدلائل.
ينطبق على:
تطبيقات Canvas لسطح المكتب تتدفق وظائف Power Platform CLI Dataverse
تعيين قيمة متغير عمومي
نظرة عامة
استخدم الدالة Set لتعيين قيمة متغير عمومي، والذي يحتوي مؤقتا على جزء من المعلومات، مثل عدد المرات التي حدد فيها المستخدم زرا أو نتيجة عملية بيانات.
تتوفر المتغيرات العمومية في جميع أنحاء تطبيقك على جميع الشاشات. هذه هي أبسط أنواع المتغيرات وتفي باحتياجات معظم المواقف. هناك أيضًا متغيرات السياق التي يتم تحديد نطاقها على شاشة واحدة ومجموعات تسمح بتعديل مستوى الصف في الجداول. لمزيد من المعلومات حول هذه الخيارات الأخرى، راجع فهم المتغيرات.
يستند Power Apps إلى الصيغ التي تقوم تلقائيا بإعادة حسابها أثناء تفاعل المستخدم مع أحد التطبيقات. سيتم تحديث أي صيغ تعتمد على متغير تلقائيًا عندما تتغير. ومع ذلك، لن يتم تحديث المتغير تلقائيا إذا تغيرت قيمة الصيغة المستخدمة في الدالة Set . يتطلب هذا من صانع التطبيق تحديث المتغير يدويًا ، والذي يمكن أن يكون عرضة للخطأ ويصعب على الآخرين فهمه. قبل استخدام متغير، يمكنك مراجعة فهم المتغيرات.
الوصف
يتم إنشاء المتغيرات العمومية ضمنيا باستخدام الدالة Set . لا يلزم إعلان صريح. إذا قمت بإزالة كافة Set الدالات لمتغير عمومي، فسيتوقف هذا المتغير العمومي عن الوجود. لمسح متغير، قم بتعيين قيمته إلى نتيجة وظيفة Blank.
يمكنك أن ترى قيم المتغيرات والتعاريف والاستخدامات مع عرض المتغيرات ضمن قائمة الملف في Power Apps Studio.
كما تظهر الأمثلة في هذا الموضوع لاحقًا ، يمكن للمتغيرات العالمية أن تحتفظ بعدة أنواع من المعلومات ، بما في ذلك ما يلي:
- قيمة واحدة
- سجل
- جدول
- مرجع كائن
- أي نتيجة من الصيغة
متغير عام يحتفظ بقيمته حتى يتم إغلاق التطبيق. بمجرد الإغلاق ، ستفقد قيمة المتغير العام ويجب إعادة إنشائه عند تحميل التطبيق مرة أخرى.
لا يمكن للمتغيرات العامة استخدام نفس الاسم كمجموعة أو عنصر تحكم موجود. يمكنه استخدام نفس الاسم كمتغير سياق. للتوضيح بين الاثنين ، استخدم عامل التوضيح.
Set لا تحتوي على قيمة إرجاع، ويمكنك استخدامها فقط ضمن صيغة سلوك.
بناء الجملة
Set( VariableName, Value )
- اسم المتغير - مطلوب. اسم المتغير العمومي الذي سيتم إنشاؤه أو تحديثه.
- القيمة - مطلوبة. القيمة المطلوب تخصيصها لمتغير السياق.
الأمثلة
| صيغة | الوصف | نتيجة |
|---|---|---|
| Set( عداد، 1 ) | إنشاء أو تعديل المتغير العام Counter، وتعيين قيمتها إلى 1. | العداد له القيمة 1. يمكنك الرجوع إلى هذا المتغير باستخدام الاسم Counter في صيغة على أي شاشة. |
| Set( عداد، 2 ) | قم بتعيين قيمة المتغير العمومي Counter من المثال السابق إلى 2. | العداد له القيمة 2. |
| Set( عداد، عداد + 1 ) | زيادة قيمة المتغير العمومي Counter من المثال السابق إلى 3. | العداد له القيمة 3. |
| Set( Name, "Lily" ) | إنشاء أو تعديل المتغير العام Name، وتعيين قيمتها إلى Lily. | الاسم له قيمة ليلي. |
| Set( Person, { Name: "Milton", Address: "1 Main St" } ) | إنشاء أو تعديل المتغير العام Person، وتعيي قيمته إلى سجل. يحتوي السجل على عمودين باسم Name وAddress. وقيمة عمود Name هي Milton، وقيمة عمود العنوان هو 1 Main St. |
الشخص لديه قيمة اسم السجل { : "ميلتون" ، العنوان: "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". } |