تأكيد صحة البيانات

يوفر Microsoft Excel بعض الميزات الجيدة للتصفية التلقائية أو التحقق من صحة بيانات ورقة العمل.

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

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

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

• Numbers كلها، أي أنه ليس لديهم جزء عشري.
• الأعداد العشرية تتبع الهيكل الصحيح. يحدد مثال الكود أن نطاق الخلايا يجب أن يحتوي على مسافتين عشريتين.
• القيم مقيدة بقائمة من القيم. يعرّف التحقق من صحة القائمة قائمة منفصلة من القيم التي يمكن تطبيقها على خلية أو نطاق خلية.
• التواريخ تقع ضمن نطاق معين.
• الوقت ضمن نطاق معين.
• النص ضمن طول حرف معين.

التحقق من صحة البيانات باستخدام Excel Microsoft

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

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

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

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

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

التحقق من صحة البيانات مع Aspose.Cells

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

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

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

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

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

النوع التحققيتألف التعداد من الأعضاء التالية أسماؤهم:

اسم عضو	وصف
اي قيمة	تشير إلى قيمة من أي نوع.
الرقم كاملا	تشير إلى نوع التحقق من صحة الأعداد الصحيحة.
عدد عشري	تشير إلى نوع التحقق من صحة الأرقام العشرية.
قائمة	تشير إلى نوع التحقق من القائمة المنسدلة.
تاريخ	تشير إلى نوع التحقق من صحة التواريخ.
الوقت	تشير إلى نوع التحقق من صحة الوقت.
TEXT_LENGTH	تشير إلى نوع التحقق من طول النص.
العادة	تشير إلى نوع التحقق المخصص.

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

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

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-Java
// The path to the documents directory.
String dataDir = Utils.getSharedDataDir(WholeNumberDataValidation.class) + "data/";

// Instantiating an Workbook object
Workbook workbook = new Workbook();
WorksheetCollection worksheets = workbook.getWorksheets();

// Accessing the Validations collection of the worksheet
Worksheet worksheet = worksheets.get(0);

// Applying the validation to a range of cells from A1 to B2 using the
// CellArea structure
CellArea area = new CellArea();
area.StartRow = 0;
area.StartColumn = 0;
area.EndRow = 1;
area.EndColumn = 1;

ValidationCollection validations = worksheet.getValidations();

// Creating a Validation object
int index = validations.add(area);
Validation validation = validations.get(index);

// Setting the validation type to whole number
validation.setType(ValidationType.WHOLE_NUMBER);

// Setting the operator for validation to Between
validation.setOperator(OperatorType.BETWEEN);

// Setting the minimum value for the validation
validation.setFormula1("10");

// Setting the maximum value for the validation
validation.setFormula2("1000");

// Saving the Excel file
workbook.save(dataDir + "WNDValidation_out.xls");

// Print message
System.out.println("Process completed successfully");

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

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

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-Java
// The path to the documents directory.
String dataDir = Utils.getSharedDataDir(DecimalDataValidation.class) + "data/";

// Create a workbook object.
Workbook workbook = new Workbook();

// Create a worksheet and get the first worksheet.
Worksheet ExcelWorkSheet = workbook.getWorksheets().get(0);

// Specify the validation area of cells.
CellArea area = new CellArea();
area.StartRow = 0;
area.StartColumn = 0;
area.EndRow = 9;
area.EndColumn = 0;

// Obtain the existing Validations collection.
ValidationCollection validations = ExcelWorkSheet.getValidations();

// Create a validation object adding to the collection list.
int index = validations.add(area);
Validation validation = validations.get(index);

// Set the validation type.
validation.setType(ValidationType.DECIMAL);

// Specify the operator.
validation.setOperator(OperatorType.BETWEEN);

// Set the lower and upper limits.
validation.setFormula1("10");
validation.setFormula2("1000");

// Set the error message.
validation.setErrorMessage("Please enter a valid integer or decimal number");

// Save the workbook.
workbook.save(dataDir + "DDValidation_out.xls");

// Print message
System.out.println("Process completed successfully");

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

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

من المهم هنا أن تقوم بتعيين ملفValidation.setInCellDropDown ملكية لحقيقي.

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-Java
// The path to the documents directory.
String dataDir = Utils.getSharedDataDir(ListDataValidation.class) + "data/";

// Create a workbook object.
Workbook workbook = new Workbook();

// Get the first worksheet.
Worksheet ExcelWorkSheet = workbook.getWorksheets().get(0);

// Add a new worksheet and access it.
int sheetIndex = workbook.getWorksheets().add();
Worksheet worksheet2 = workbook.getWorksheets().get(sheetIndex);

// Create a range with name in the second worksheet.
Range range = worksheet2.getCells().createRange(0, 4, 4, 4);
range.setName("MyRange");

// Fill different cells with data in the range.
range.get(0, 0).setValue("Blue");
range.get(1, 0).setValue("Red");
range.get(2, 0).setValue("Green");
range.get(3, 0).setValue("Yellow");

// Specify the validation area of cells.
CellArea area = new CellArea();
area.StartRow = 0;
area.StartColumn = 0;
area.EndRow = 4;
area.EndColumn = 0;

// Obtain the existing Validations collection.
ValidationCollection validations = ExcelWorkSheet.getValidations();

// Create a validation object adding to the collection list.
int index = validations.add(area);
Validation validation = validations.get(index);

// Set the validation type.
validation.setType(ValidationType.LIST);

// Set the in cell drop down.
validation.setInCellDropDown(true);

// Set the formula1.
validation.setFormula1("=MyRange");

// Enable it to show error.
validation.setShowError(true);

// Set the alert type severity level.
validation.setAlertStyle(ValidationAlertType.STOP);

// Set the error title.
validation.setErrorTitle("Error");

// Set the error message.
validation.setErrorMessage("Please select a color from the list");

// Save the excel file.
workbook.save(dataDir + "LDValidation_out.xls");

// Print message
System.out.println("Process completed successfully");

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

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

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-Java
// The path to the documents directory.
String dataDir = Utils.getSharedDataDir(DateDataValidation.class) + "data/";

// Create a workbook.
Workbook workbook = new Workbook();

// Obtain the cells of the first worksheet.
Cells cells = workbook.getWorksheets().get(0).getCells();

// Put a string value into the A1 cell.
cells.get("A1").setValue("Please enter Date b/w 1/1/1970 and 12/31/1999");

// Wrap the text.
Style style = cells.get("A1").getStyle();
style.setTextWrapped(true);
cells.get("A1").setStyle(style);

// Set row height and column width for the cells.
cells.setRowHeight(0, 31);
cells.setColumnWidth(0, 35);

// Set a collection of CellArea which contains the data validation
// settings.
CellArea area = new CellArea();

area.StartRow = 0;
area.StartColumn = 1;
area.EndRow = 0;
area.EndColumn = 1;

// Get the validations collection.
ValidationCollection validations = workbook.getWorksheets().get(0).getValidations();

// Add a new validation.
int i = validations.add(area);
Validation validation = validations.get(i);

// Set the data validation type.
validation.setType(ValidationType.DATE);

// Set the operator for the data validation
validation.setOperator(OperatorType.BETWEEN);

// Set the value or expression associated with the data validation.
validation.setFormula1("1/1/1970");

// The value or expression associated with the second part of the data
// validation.
validation.setFormula2("12/31/1999");

// Enable the error.
validation.setShowError(true);

// Set the validation alert style.
validation.setAlertStyle(ValidationAlertType.STOP);

// Set the title of the data-validation error dialog box
validation.setErrorTitle("Date Error");

// Set the data validation error message.
validation.setErrorMessage("Enter a Valid Date");

// Set and enable the data validation input message.
validation.setInputMessage("Date Validation Type");
validation.setIgnoreBlank(true);
validation.setShowInput(true);

// Save the excel file.
workbook.save(dataDir + "DDValidation_out.xls", FileFormatType.EXCEL_97_TO_2003);

// Print message
System.out.println("Process completed successfully");

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

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

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-Java
// The path to the documents directory.
String dataDir = Utils.getSharedDataDir(TimeDataValidation.class) + "data/";

// Create a workbook.
Workbook workbook = new Workbook();

// Obtain the cells of the first worksheet.
Cells cells = workbook.getWorksheets().get(0).getCells();

// Put a string value into A1 cell.
cells.get("A1").setValue("Please enter Time b/w 09:00 and 11:30 'o Clock");

// Wrap the text.
Style style = cells.get("A1").getStyle();
style.setTextWrapped(true);
cells.get("A1").setStyle(style);

// Set row height and column width for the cells.
cells.setRowHeight(0, 31);
cells.setColumnWidth(0, 35);

// Set a collection of CellArea which contains the data validation
// settings.
CellArea area = new CellArea();

area.StartRow = 0;
area.StartColumn = 1;
area.EndRow = 0;
area.EndColumn = 1;

// Get the validations collection.
ValidationCollection validations = workbook.getWorksheets().get(0).getValidations();

// Add a new validation.
int i = validations.add(area);
Validation validation = validations.get(i);

// Set the data validation type.
validation.setType(ValidationType.TIME);

// Set the operator for the data validation
validation.setOperator(OperatorType.BETWEEN);

// Set the value or expression associated with the data validation.
validation.setFormula1("09:00");

// The value or expression associated with the second part of the data
// validation.
validation.setFormula2("11:30");

// Enable the error.
validation.setShowError(true);

// Set the validation alert style.
validation.setAlertStyle(ValidationAlertType.INFORMATION);

// Set the title of the data-validation error dialog box.
validation.setErrorTitle("Time Error");

// Set the data validation error message.
validation.setErrorMessage("Enter a Valid Time");

// Set and enable the data validation input message.
validation.setInputMessage("Time Validation Type");
validation.setIgnoreBlank(true);
validation.setShowInput(true);

// Save the excel file.
workbook.save(dataDir + "TDValidation_out.xls", FileFormatType.EXCEL_97_TO_2003);

// Print message
System.out.println("Process completed successfully");

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

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

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-Java
// The path to the documents directory.
String dataDir = Utils.getSharedDataDir(TextLengthDataValidation.class) + "data/";

// Create a new workbook.
Workbook workbook = new Workbook();

// Obtain the cells of the first worksheet.
Cells cells = workbook.getWorksheets().get(0).getCells();

// Put a string value into A1 cell.
cells.get("A1").setValue("Please enter a string not more than 5 chars");

// Wrap the text.
Style style = cells.get("A1").getStyle();
style.setTextWrapped(true);
cells.get("A1").setStyle(style);

// Set row height and column width for the cells.
cells.setRowHeight(0, 31);
cells.setColumnWidth(0, 35);

// Set a collection of CellArea which contains the data validation
// settings.
CellArea area = new CellArea();

area.StartRow = 0;
area.StartColumn = 1;
area.EndRow = 0;
area.EndColumn = 1;

// Get the validations collection.
ValidationCollection validations = workbook.getWorksheets().get(0).getValidations();

// Add a new validation.
int i = validations.add(area);
Validation validation = validations.get(i);

// Set the data validation type.
validation.setType(ValidationType.TEXT_LENGTH);

// Set the operator for the data validation.
validation.setOperator(OperatorType.LESS_OR_EQUAL);

// Set the value or expression associated with the data validation.
validation.setFormula1("5");

// Enable the error.
validation.setShowError(true);

// Set the validation alert style.
validation.setAlertStyle(ValidationAlertType.WARNING);

// Set the title of the data-validation error dialog box.
validation.setErrorTitle("Text Length Error");

// Set the data validation error message.
validation.setErrorMessage(" Enter a Valid String");

// Set and enable the data validation input message.
validation.setInputMessage("TextLength Validation Type");
validation.setIgnoreBlank(true);
validation.setShowInput(true);

// Save the excel file.
workbook.save(dataDir + "TLDValidation_out.xls", FileFormatType.EXCEL_97_TO_2003);

// Print message
System.out.println("Process completed successfully");

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

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

SampleDataValidationRules.xlsx

عينة من الرموز

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-Java
// Instantiate the workbook from sample Excel file
Workbook workbook = new Workbook(srcDir + "sampleDataValidationRules.xlsx");

// Access the first worksheet
Worksheet worksheet = workbook.getWorksheets().get(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.getCells().get("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
System.out.println("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
System.out.println("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
System.out.println("Is 30 a Valid Value for this Cell: " + cell.getValidationValue());

// Enter large number 12345678901 inside this cell
// Since it is not between 1 and 999999999999, it should pass the validation again
Cell cell2 = worksheet.getCells().get("D1");
cell2.putValue(12345678901l);

// Check if number 12345678901 satisfies the Data Validation rule applied on this cell
System.out.println("Is 12345678901 a Valid Value for this Cell: " + cell2.getValidationValue());

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

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

sampleDataValidationRules.xlsx

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-Java
Workbook book = new Workbook(srcDir + "sampleValidation.xlsx");
Worksheet sheet = book.getWorksheets().get("Sheet1");
Cells cells  = sheet.getCells();
Cell a2 = cells.get("A2");
Validation va2 = a2.getValidation();
if(va2.getInCellDropDown()) {
    System.out.println("A2 is a dropdown");
} else {
    System.out.println("A2 is NOT a dropdown");
}
Cell b2 = cells.get("B2");
Validation vb2 = b2.getValidation();
if(vb2.getInCellDropDown()) {
    System.out.println("B2 is a dropdown");
} else {
    System.out.println("B2 is NOT a dropdown");
}
Cell c2 = cells.get("C2");
Validation vc2 = c2.getValidation();
if(vc2.getInCellDropDown()) {
    System.out.println("C2 is a dropdown");
} else {
    System.out.println("C2 is NOT a dropdown");
}

إضافة CellArea إلى التحقق الموجود

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

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

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-Java
// The path to the directories.
String sourceDir = Utils.Get_SourceDirectory();
String outputDir = Utils.Get_OutputDirectory();

Workbook workbook = new Workbook(sourceDir + "ValidationsSample.xlsx");

// Access first worksheet.
Worksheet worksheet = workbook.getWorksheets().get(0);

// Accessing the Validations collection of the worksheet
Validation validation = worksheet.getValidations().get(0);

// Create your cell area.
CellArea cellArea = CellArea.createCellArea("D5", "E7");

// Adding the cell area to Validation
validation.addArea(cellArea, false, false);

// Save the output workbook.
workbook.save(outputDir + "ValidationsSample_out.xlsx");

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

مصدر الملف

ملف إلاخراج

موضوعات مسبقة

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