التحقق من أن قيمة الخلية تفي بقواعد التحقق من البيانات
تسمح Microsoft Excel للمستخدمين بإضافة قواعد التحقق من البيانات إلى الخلايا. على سبيل المثال، يحدد التحقق العشري أنه يمكن إدخال أرقام فقط بين 10 و 20. إذا قام المستخدم بإدخال رقم مختلف، يعرض Microsoft Excel رسالة خطأ ويطالبه بإدخال رقم في النطاق الصحيح. إذا قام المستخدم بنسخ ولصق رقم، على سبيل المثال 3، في الخلية، لا يقوم Excel بتحقق التحقق أو عرض رسالة خطأ.
في بعض الأحيان، يكون من الضروري التحقق مما إذا كانت القيمة تلبي قواعد التحقق من البيانات المطبقة على الخلية بشكل برمجي. في المثال أعلاه، على سبيل المثال، يجب أن يفشل الإدخال.
مقدمة
يوفر Aspose.Cells الأسلوب Cell.GetValidationValue() للتحقق من قيم الخلية بشكل برمجي. إذا لم تلبي القيمة في الخلية قاعدة التحقق من البيانات المطبقة على تلك الخلية، يعيد False، وإلا True.
توضح العينة البرمجية التالية كيف يعمل أسلوب Cell.GetValidationValue(). أولاً، يُدخل القيمة 3 في C1. نظرًا لأن هذا الأمر لا يلبي قاعدة التحقق من البيانات، يُعيد أسلوب Cell.GetValidationValue() False. ثم، يُدخل القيمة 15 في C1. نظرًا لأن هذه القيمة تلبي قاعدة التحقق من البيانات، يُعيد أسلوب Cell.GetValidationValue() True. بالمثل، يُعيد False للقيمة 30.
// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET | |
// The path to the documents directory. | |
string dataDir = RunExamples.GetDataDir(System.Reflection.MethodBase.GetCurrentMethod().DeclaringType); | |
// Instantiate the workbook from sample Excel file | |
Workbook workbook = new Workbook(dataDir+ "sample.xlsx"); | |
// Access the first worksheet | |
Worksheet worksheet = workbook.Worksheets[0]; | |
// Access Cell C1 | |
// Cell C1 has the Decimal Validation applied on it. | |
// It can take only the values Between 10 and 20 | |
Cell cell = worksheet.Cells["C1"]; | |
// Enter 3 inside this cell | |
// Since it is not between 10 and 20, it should fail the validation | |
cell.PutValue(3); | |
// Check if number 3 satisfies the Data Validation rule applied on this cell | |
Console.WriteLine("Is 3 a Valid Value for this Cell: " + cell.GetValidationValue()); | |
// Enter 15 inside this cell | |
// Since it is between 10 and 20, it should succeed the validation | |
cell.PutValue(15); | |
// Check if number 15 satisfies the Data Validation rule applied on this cell | |
Console.WriteLine("Is 15 a Valid Value for this Cell: " + cell.GetValidationValue()); | |
// Enter 30 inside this cell | |
// Since it is not between 10 and 20, it should fail the validation again | |
cell.PutValue(30); | |
// Check if number 30 satisfies the Data Validation rule applied on this cell | |
Console.WriteLine("Is 30 a Valid Value for this Cell: " + cell.GetValidationValue()); |
الناتج
Is 3 a Valid Value for this Cell: False
Is 15 a Valid Value for this Cell: True
Is 30 a Valid Value for this Cell: False