الدالة Validate

ينطبق على: تطبيقات اللوحة التطبيقات المستندة إلى النموذج

تتحقق وظيفة Validate مما إذا كانت قيمة عمود واحد أو سجل كامل صالحة لـ مصدر البيانات.

‏‏الوصف

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

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

• ما إذا كان العمود يتطلب قيمة
• الطول الذي يمكن أن تكون به سلسلة نصية
• كيف يمكن أن يكون الرقم مرتفعًا ومنخفضًا
• كيف يمكن أن يكون موعد مبكر ومتأخر

تستخدم وظيفة Validate هذه المعلومات لتحديد ما إذا كانت القيمة صالحة ولإرجاع رسالة خطأ مناسبة إذا لم تكن كذلك. يمكنك استخدام وظيفة DataSourceInfo لعرض نفس المعلومات التي تستخدمها وظيفة Validate.

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

في حالة عثور وظيفة Validate على مشكلة، تقوم الوظيفة بإرجاع رسالة خطأ يمكنك إظهارها لمستخدم التطبيق. وإذا كانت جميع القيم صالحة، فستقوم وظيفة Validate بإرجاع blank. عند تعاملك مع مجموعة التي لا تحتوي على معلومات التحقق، والقيم صالحة دائمًا.

بناء الجملة

التحقق من صحة ( مصدر البيانات ، العمود ، القيمة )

• مصدر البيانات- مطلوب. مصدر البيانات المراد التحقق منه.
• العمود - مطلوب. العمود المراد التحقق منه.
• القيمة - مطلوبة. قيمه العمود المحدد المراد التحقق من صحته.

التحقق من صحة ( مصدر البيانات ، السجل الأصلي ، التحديثات )

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

الأمثلة

في هذه الأمثلة، يجب أن تكون القيم في عمود Percentage الخاص بمصدر بيانات Scores بين 0 و100، شامل الرقمين. إذا نجحت البيانات في التحقق من الصحة، فسترجع الوظيفة فارغ. وإلا، تقوم الوظيفة بإرجاع رسالة خطأ.

التحقق من الصحة بعمود واحد

صيغة	‏‏الوصف	نتيجة
التحقق من صحة (الدرجات ، النسبة المئوية ، 10)	التحقق مما إذا كانت 10 قيمة صالحة لعمود Percentage في مصدر بيانات Scores.	خلبي
التحقق من صحة (الدرجات ، النسبة المئوية ، 120)	التحقق مما إذا كانت 120 قيمة صالحة لعمود Percentage في مصدر بيانات Scores.	"يجب أن تتراوح القيم بين 0 و100".

التحقق من صحة سجل كامل

صيغة	‏‏الوصف	نتيجة
التحقق من صحة (الدرجات ، EditRecord ، Gallery.Updates )	التحقق مما إذا كانت القيم في جميع الأعمدة صالحة لمصدر بيانات Scores. في هذا المثال، القيمة في عمود Percentage هي 10.	خلبي
التحقق من صحة (الدرجات ، EditRecord ، Gallery.Updates )	التحقق مما إذا كانت القيم في جميع الأعمدة صالحة لمصدر بيانات Scores. في هذا المثال، القيمة في عمود Percentage هي 120.	"يجب أن تتراوح القيم بين 0 و100".