التحقق من البيانات

أنواع التحقق من البيانات والتنفيذ

يدعم Microsoft Excel عددًا من أنواع التحقق المختلفة للبيانات. يُستخدم كل نوع للتحكم في نوع البيانات التي تُدخل إلى خلية أو نطاق الخلايا. أدناه، مقتطفات الكود توضح كيفية التحقق من:

التحقق من البيانات مع Microsoft Excel

لإنشاء التحققات باستخدام Microsoft Excel:

  1. في ورقة العمل، حدد الخلايا التي ترغب في تطبيق التحقق عليها.

  2. من قائمة البيانات، حدد التحقق. يتم عرض مربع الحوار للتحقق.

  3. انقر على علامة التبويب الإعدادات وأدخل الإعدادات كما هو موضح أدناه. 

    إعدادات التحقق من البيانات

todo:image_alt_text

التحقق من البيانات بواسطة Aspose.Cells

التحقق من البيانات هو ميزة قوية للتحقق من المعلومات المُدخلة في أوراق العمل. باستخدام التحقق من البيانات، يمكن للمطورين توفير للمستخدمين قائمة من الخيارات، وتقييد إدخالات البيانات إلى نوع معين أو حجم، الخ. في Aspose.Cells، كل نموذج البيانات يحتوي على كائن التحقق الذي يمثل مجموعة من أثبات صحة التحقق. لتعيين التحقق، قم بتعيين بعض خصائص التحقق الصنف:

  • النوع: يمثل نوع التحقق، والذي يمكن تحديده باستخدام أحد قيم محددة في تعداد نوع التحقق.
  • المشغل: يمثل المشغل الذي يجب استخدامه في التحقق، والذي يمكن تحديده باستخدام أحد القيم المحددة في تعداد نوع المشغل.
  • الصيغة1: تمثل القيمة أو التعبير المرتبط بالجزء الأول من التحقق من البيانات.
  • الصيغة2: تمثل القيمة أو التعبير المرتبط بالجزء الثاني من التحقق من البيانات.

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

أنواع التحقق من البيانات

يتيح التحقق من البيانات بناء قواعد الأعمال في كل خلية بحيث تؤدي الإدخالات غير الصحيحة إلى رسائل خطأ. قواعد الأعمال هي السياسات والإجراءات التي تحكم كيفية عمل الأعمال. تدعم Aspose.Cells جميع الأنواع الهامة للتحقق من البيانات.

تحتوي تعداد تحقق البيانات على الأعضاء التالية:

اسم العضو الوصف
ANY_VALUE يشير إلى قيمة من أي نوع.
WHOLE_NUMBER يشير إلى نوع التحقق للأرقام الصحيحة بأكملها.
DECIMAL يشير إلى نوع التحقق للأرقام العشرية.
LIST يشير إلى نوع التحقق لقائمة منسدلة.
DATE يشير إلى نوع التحقق للتواريخ.
TIME يشير إلى نوع التحقق للتوقيت.
TEXT_LENGTH يشير إلى نوع التحقق لطول النص.
CUSTOM يشير إلى نوع التحقق المخصص.

عينة برمجية: التحقق من البيانات لأرقام صحيحة كاملة

مع هذا النوع من التحقق، يمكن للمستخدمين إدخال أرقام صحيحة فقط ضمن نطاق محدد في الخلايا المحققة. تظهر الأمثلة البرمجية التالية كيفية تنفيذ نوع التحقق WHOLE_NUMBER. تقوم الأمثلة بإنشاء نفس التحقق من البيانات باستخدام Aspose.Cells الذي أنشأناه باستخدام Microsoft Excel أعلاه.

عينة برمجية: التحقق من البيانات لأرقام عشرية

مع هذا النوع من التحقق، يمكن للمستخدم إدخال أرقام عشرية في الخلايا المحققة. في المثال، يتم تقييد المستخدم لإدخال قيمة عشرية فقط ومنطقة التحقق هي A1:A10.

عينة برمجية: التحقق من البيانات لقائمة منسدلة

يتيح هذا النوع من التحقق للمستخدم إدخال قيم من قائمة منسدلة. يوفر قائمة: سلسلة من الصفوف التي تحتوي على بيانات. يمكن للمستخدمين اختيار قيم فقط من القائمة. منطقة التحقق هي نطاق الخلية A1:A5 في ورقة العمل الأولى.

من المهم هنا أن تقوم بتعيين خاصية Validation.setInCellDropDown إلى true.

عينة برمجة: التحقق من صحة بيانات التاريخ

مع هذا النوع من التحقق، يقوم المستخدمون بإدخال قيم تاريخية ضمن النطاق المحدد، أو تلبية معايير محددة، داخل الخلايا المحققة. في المثال، يتم تقييد المستخدم لإدخال تواريخ بين 1970 و1999. هنا، منطقة التحقق هي خلية B1.

عينات البرمجة: التحقق من صحة بيانات الوقت

مع هذا النوع من التحقق، يمكن للمستخدمين إدخال أوقات ضمن نطاق محدد، أو تلبية بعض المعايير، في الخلايا الموجودة. ففي المثال، يتم تقييد المستخدم بإدخال الأوقات بين الساعة 09:00 و11:30 صباحًا. هنا، مجال التحقق هو خلية B1.

عينات البرمجة: التحقق من صحة طول النص

مع هذا النوع من التحقق، يمكن للمستخدمين إدخال قيم نصية من طول محدد في الخلايا الموجودة. في المثال، يتم تقييد المستخدم بإدخال قيم سلسلة نصية بأكثر من 5 أحرف. مجال التحقق هو الخلية B1.

قواعد تحقق البيانات

عندما يتم تنفيذ التحققات من البيانات، يمكن التحقق من التحقق من خلال تعيين قيم مختلفة في الخلايا. يمكن استخدام Cell.GetValidationValue() لاحضار نتيجة التحقق. يوضح المثال التالي هذه الميزة مع قيم مختلفة. يمكن تنزيل الملف العيني من الرابط التالي للفحص:

SampleDataValidationRules.xlsx

كود عينة

تحقق مما إذا كان التحقق في خلية قائمة منسدلة

كما رأينا، هناك العديد من أنواع التحققات التي يمكن تنفيذها داخل خلية. إذا كنت ترغب في التحقق مما إذا كان التحقق قائمة منسدلة أم لا، يمكن استخدام Validation.InCellDropDown الخاصية لاختبار هذا. يوضح الكود النموذجي التالي استخدام هذه الخاصية. يمكن تنزيل الملف العيني للفحص من الرابط التالي:

sampleDataValidationRules.xlsx

إضافة منطقة الخلية إلى التحقق القائم

قد تكون هناك حالات ترغب في إضافة CellArea إلى Validation الموجود. عند إضافة CellArea باستخدام Validation.AddArea(CellArea cellArea)، يقوم Aspose.Cells بفحص جميع المناطق الموجودة لمعرفة ما إذا كانت المنطقة الجديدة موجودة بالفعل. إذا كان للملف عدد كبير من التحققات، فإن هذا يؤدي إلى تقليل الأداء. للتغلب على ذلك، تقدم الواجهة البرمجية طريقة Validation.AddAreaCellArea cellArea, bool checkIntersection, bool checkEdge). يشير المعلمة checkIntersection إلى ما إذا كان يجب التحقق من تقاطع المنطقة المعطاه مع المناطق التحقق الموجودة. يتوفر تعيينها إلى false لتعطيل التحقق من المناطق الأخرى. تشير المعلمة checkEdge إلى ما إذا كان يجب التحقق من المناطق المطبقة. إذا كانت المنطقة الجديدة تصبح المنطقة العليا اليسرى، يتم إعادة بناء الإعدادات الداخلية. إذا كنت متأكدًا من أن المنطقة الجديدة ليست المنطقة العليا اليسرى، يمكنك ضبط هذه المعلمة على false.

يوضح مقتطف الكود التالي استخدام طريقة Validation.AddAreaCellArea cellArea, bool checkIntersection, bool checkEdge) لإضافة منطقة الخلية الجديدة إلى التحقق الموجود.

الملفات الإكسل المصدر والناتج مرفقة للرجوع إليها.

ملف المصدر

ملف الناتج

مواضيع متقدمة