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

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

يدعم 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 من جميع المناطق الموجودة لمعرفة ما إذا كانت المنطقة الجديدة موجودة بالفعل. إذا كان الملف يحتوي على عدد كبير من التحققات، فإن ذلك يؤثر على الأداء. لتجاوز ذلك، توفر API طريقة Validation.AddAreaCellArea cellArea, bool checkIntersection, bool checkEdge) التي تتضمن معاملات للتحقق من التداخل والتفاصيل، حيث يشير checkIntersection إلى ما إذا كانت المنطقة الجديدة تتداخل مع التحقق الموجود، وcheckEdge يحدد ما إذا كانت ستتم إعادة بناء الإعدادات الداخلية عندما تصبح المنطقة الجديدة هي المنطقة العلوية اليسرى.

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

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

ملف المصدر

ملف الناتج

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

  • الحصول على التحقق من الخلية في ملفات ODS
  • الحصول على التحقق المطبق على خلية
  • التحقق من أن قيمة الخلية تلبي قواعد التحقق من البيانات
تصفية البيانات ترتيب البيانات