السابق

التالي

أرسل نموذجك

مكتمل

الخطوة الأخيرة فِي العمل باستخدام عنصر تحكم Form هي إرسال التعديلات. للقيام بذلك، استخدم الدالة SubmitForm. غالبًا ما يتم وضع هذه الوظيفة فِي عنصر تحكم الزر يسمى حفظ أو إرسال. الصيغة المخصصة لـ OnSelect هي SubmitForm(YourFormالاسم).

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

هام

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

بعد إرسال نموذجك

يعد عنصر التحكم Form سهل الاستخدام لأنه مع استدعاء الدالة SubmitForm، يتم نقل بياناتك بعيدًا ويتم تحديث مصدر بياناتك. يحتوي عنصر التحكم Form على ثلاث خصائص يتم معالجتها بعد إرسال البيانات بناءً على نتيجة الإرسال. هاتان الخصيتان هما OnSuccess وOnFailure وOnReset. بالإضافة إلى ذلك، توفر لك الخاصية LastSubmit سجلاً للبيانات التي تم إرسالها من النموذج.

ملاحظة

إذا كنت تريد إرسال النموذج الخاص بك للقيام بشيء آخر، مثل الانتقال إلى شاشة أخرى، فقم بإضافة الترميز إلى إحدى خصائص النموذج الثلاثة هذه. لا تقم بإضافة تعليمات برمجية إضافية إلى أي زر أو أيقونة أو دالة تستدعي الإجراء SubmitForm.

لكل من هذه الخصائص، يمكنك إدخال معادلة. على سبيل المثال، إذا كنت تريد أن ينتقل المستخدم إلى شاشة مختلفة بعد إرسال بياناته بنجاح، فعندئذٍ فِي OnSuccess، ستستخدم الدالة Navigate(SuccessScreen, ScreenTransition.Cover) لإرسالهم إلى الشاشة المسماة SuccessScreen.

الخاصية OnFailure

استخدم الخاصية OnFailure إذا كان هناك خطأ عند إرسال البيانات. يمكنك استخدام معادلة لتحديد رسالة تحذير تظهر عند حدوث الفشل. المعادلة التالية هي مثال على استخدام وظيفة يُخْطِر لتوفير مزيد من المعلومات للمستخدم.

Notify("Your data was not saved. Please try again or contact an administrator.", NotificationType.Error)

ستعرض هذه لدالة تحذيرًا أحمر أعلى الشاشة مع رسالة "لم يتم حفظ بياناتك. حاول مرة أخرى أو اتصل بالمسؤول". تسهل هذه الرسالة على المستخدم حل المشكلة.

خاصية إعادة تعيين

استخدم خاصية إعادة تعيين إذا تمت إعادة تعيين النموذج. تحدث إعادة ضبط النموذج عند استخدام وظيفة إعادة تعيين النموذج. تعيّن الدالة إعادة تعيين النموذج النموذج إلى قيمه الافتراضية ثم تقوم بتشغيل أي معادلة محددة فِي خاصية في إعادة تعيين. على سبيل المثال، إذا كنت تريد إعادة تعيين عنصر تحكم المتغير أو المؤقت مستخدم فِي التفاعل مع النموذج.

الخاصية LastSubmit

بعد إرسال النموذج بنجاح، يمكنك الرجوع إلى السجل المقدم مباشرةً. يتوفر آخر سجل تم إرساله باستخدام خاصية آخر إرسال التي تحتوي على السجل بأكمله. يمكنك الوصول إلى السجل باستخدام الصيغة Formالاسم.LastSubmit (استبدل اسم النموذج الخاص بك باسم Formالاسم). يمكنك أيضًا الوصول إلى عنصر من سجل LastSubmit عن طريق إدراج عنصر تحكم التسمية فِي تطبيقك، ثم استخدام صيغة مثل: الخاصية: FormName.LastSubmit.ID التي تقوم بإرجاع الخاصية ID لآخر سجل تم إرساله. يعد فهم LastSubmit مفهومًا قويًا عندما تبدأ فِي إنشاء بيانات علائقية حيث تحتاج إلى معرفة القيمة من إرسال نموذج سابق.

في الوحدة التالية، سنناقش بعض الخصائص الخاصة القيمة لعنصر التحكم فِي النموذج.

متابعة