Share via

الدالة Set

  • مقالة

ينطبق على: تطبيقات قماش بطاقات Dataverse البرنامج المساعد ذو التعليمات البرمجية المنخفضة Power Platform CLI

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

نظرة عامة‬

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

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

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

‏‏الوصف

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

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

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

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

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

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

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

بناء الجملة

Set( VariableName, Value )

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

الأمثلة

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

مرجع هذا السجل ككل بالاسم Person، أو مرجع عمود فردي لهذا السجل بـ Person.Name أو Person.Address.
Set( Person, Patch( Person, {Address: "2 Main St" } ) ) التعامل مع وظيفة Patch لتحديث المتغير العمومي Person عن طريق تعيين قيمة عمود Address إلى 2 Main St. يشتمل Person الآن على قيمة السجل { Name: "Milton", Address: "2 Main St" }.