إشعار
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تسجيل الدخول أو تغيير الدلائل.
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تغيير الدلائل.
ينطبق على:
تطبيقات اللوحة التي تستند إلى نموذج التطبيقات
Validate تتحقق الدالة مما إذا كانت قيمة عمود واحد أو سجل كامل صالحة لمصدر بيانات.
الوصف
قبل أن يقوم المستخدم بإرسال تغيير البيانات ، يمكنك تقديم تعليقات فورية حول صحة هذا الإرسال ، مما يؤدي إلى تجربة أفضل للمستخدم.
يمكن أن توفر مصادر البيانات معلومات حول ما يشكل قيمًا صالحة داخل السجل. يمكن أن تتضمن هذه المعلومات العديد من القيود ، مثل هذه الأمثلة:
- ما إذا كان العمود يتطلب قيمة
- الطول الذي يمكن أن تكون به سلسلة نصية
- كيف يمكن أن يكون الرقم مرتفعًا ومنخفضًا
- كيف يمكن أن يكون موعد مبكر ومتأخر
Validate تستخدم الدالة هذه المعلومات لتحديد ما إذا كانت القيمة صالحة وإرجاع رسالة خطأ مناسبة إذا لم تكن صحيحة. يمكنك استخدام الدالة DataSourceInfo لعرض نفس المعلومات التي Validate تستخدمها.
تختلف مصادر البيانات في مقدار معلومات التحقق التي توفرها، بما في ذلك عدم تقديم أي منها على الإطلاق. Validate يمكن فقط التحقق من القيم استنادا إلى هذه المعلومات. حتى إذا Validate لم يعثر على مشكلة، فقد لا يزال تطبيق تغيير البيانات يفشل. يمكنك استخدام وظائف Errors للحصول على معلومات حول الفشل.
إذا Validate وجدت مشكلة، ترجع الدالة رسالة خطأ يمكنك إظهارها لمستخدم التطبيق. إذا كانت كافة القيم صالحة، Validate فترجع فارغة. عند تعاملك مع مجموعة التي لا تحتوي على معلومات التحقق، والقيم صالحة دائمًا.
بناء الجملة
Validate( مصدر البيانات، العمود، القيمة )
- DataSource – مطلوب. مصدر البيانات المراد التحقق منه.
- العمود - مطلوب. العمود المراد التحقق منه.
- القيمة - مطلوبة. قيمه العمود المحدد المراد التحقق من صحته.
Validate( DataSource, OriginalRecord, Updates )
- DataSource – مطلوب. مصدر البيانات المراد التحقق منه.
- السجل الأصلي- مطلوب. السجل الذي سيتم التحقق من صحة التحديثات له.
- التحديثات - مطلوبة. التغييرات لتطبيق السجل الأصلي.
الأمثلة
في هذه الأمثلة، يجب أن تكون القيم في عمود Percentage الخاص بمصدر بيانات Scores بين 0 و100، شامل الرقمين. إذا نجحت البيانات في التحقق من الصحة، فسترجع الوظيفة فارغ. وإلا، تقوم الوظيفة بإرجاع رسالة خطأ.
Validate بعمود واحد
| صيغة | الوصف | نتيجة |
|---|---|---|
| Validate( الدرجات، النسبة المئوية، 10 ) | التحقق مما إذا كانت 10 قيمة صالحة لعمود Percentage في مصدر بيانات Scores. | خلبي |
| Validate( النقاط، النسبة المئوية، 120 ) | التحقق مما إذا كانت 120 قيمة صالحة لعمود Percentage في مصدر بيانات Scores. | "يجب أن تتراوح القيم بين 0 و100". |
Validate مع سجل كامل
| صيغة | الوصف | نتيجة |
|---|---|---|
| Validate( الدرجات، EditRecord، Gallery.Updates ) | التحقق مما إذا كانت القيم في جميع الأعمدة صالحة لمصدر بيانات Scores. في هذا المثال، القيمة في عمود Percentage هي 10. | خلبي |
| Validate( الدرجات، EditRecord، Gallery.Updates ) | التحقق مما إذا كانت القيم في جميع الأعمدة صالحة لمصدر بيانات Scores. في هذا المثال، القيمة في عمود Percentage هي 120. | "يجب أن تتراوح القيم بين 0 و100". |