إضافة واسترداد البيانات

إضافة بيانات إلى الخلايا

توفر Aspose.Cells فئة تمثل ملف Microsoft Excel تسمى Workbook. تحتوي فئة Workbook على WorksheetCollection التي تسمح بالوصول إلى كل ورقة عمل في ملف Excel. تمثل ورقة عمل بفئة Worksheet. توفر فئة Worksheet مجموعة Cells. يمثل كل عنصر في مجموعة Cells كائنًا من فئة Cell.

تسمح Aspose.Cells للمطورين بإضافة البيانات إلى الخلايا في ورقات العمل عن طريق استدعاء Cell و setValue. باستخدام خاصية setValue ، يمكن إضافة قيم مثل قيم Boolean و string و double و integer أو date/time وغيرها إلى الخلية.

// 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(AddingDataToCells.class) + "data/";
// Instantiating a Workbook object
Workbook workbook = new Workbook();
// Accessing the added worksheet in the Excel file
int sheetIndex = workbook.getWorksheets().add();
com.aspose.cells.Worksheet worksheet = workbook.getWorksheets().get(sheetIndex);
com.aspose.cells.Cells cells = worksheet.getCells();
// Adding a string value to the cell
com.aspose.cells.Cell cell = cells.get("A1");
cell.setValue("Hello World");
// Adding a double value to the cell
cell = cells.get("A2");
cell.setValue(20.5);
// Adding an integer value to the cell
cell = cells.get("A3");
cell.setValue(15);
// Adding a boolean value to the cell
cell = cells.get("A4");
cell.setValue(true);
// Adding a date/time value to the cell
cell = cells.get("A5");
cell.setValue(java.util.Calendar.getInstance());
// Setting the display format of the date
com.aspose.cells.Style style = cell.getStyle();
style.setNumber(15);
cell.setStyle(style);
// Saving the Excel file
workbook.save(dataDir + "AddingDataToCells_out.xls");
// Print message
System.out.println("Data Added Successfully");

تحسين الكفاءة

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

استرداد البيانات من الخلايا

توفر Aspose.Cells فئة تمثل ملف Excel تسمى Workbook التي تحتوي على مجموعة WorksheetCollection التي تسمح بالوصول إلى كل ورقة عمل في ملف Excel. تمثل ورقة عمل بفئة Worksheet. توفر فئة Worksheet مجموعة Cells. يمثل كل عنصر في مجموعة Cells كائنًا من فئة Cell.

توفر الفئة Cell العديد من الخصائص التي تسمح للمطورين باسترداد القيم من الخلايا وفقًا لأنواع بياناتها. تشمل هذه الخصائص:

  • StringValue، قيمة السلسلة في الخلية.
  • DoubleValue، تعيد قيمة الرقم العشري في الخلية.
  • BoolValue، قيمة بيانية في الخلية.
  • DateTimeValue، قيمة الوقت/التاريخ في الخلية.
  • FloatValue، قيمة عائمة في الخلية.
  • IntValue، قيمة العدد الصحيح للخلية.

وبالإضافة إلى ذلك، يمكن التحقق أيضًا من نوع البيانات الواردة في الخلية باستخدام خاصية Type لفئة Cell. في الواقع، تعتمد خاصية Type لفئة Cell على تعداد CellValueType والتي تحتوي على القيم المحددة مُسبقًا على النحو الوارد أدناه:

أنواع قيم الخلية الوصف
IS_BOOL يحدد أن قيمة الخلية هي قيمة منطقية.
IS_DATE_TIME يحدد أن قيمة الخلية هي تاريخ/وقت.
IS_ERROR يُمثل أن الخلية تحتوي على قيمة خطأ
IS_NULL يُمثل خلية فارغة.
IS_NUMERIC يحدد أن قيمة الخلية هي رقمية.
IS_STRING يحدد أن قيمة الخلية هي سلسلة نصية.
IS_UNKNOWN يحدد أن قيمة الخلية غير معروفة.
يمكنك أيضًا استخدام أنواع قيم الخلية المُحددة مُسبقًا أعلاه للمقارنة مع نوع البيانات الموجودة في كل خلية.
// 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(RetrievingDataFromCells.class) + "data/";
// Instantiating a Workbook object
Workbook workbook = new Workbook();
// Accessing the worksheet
com.aspose.cells.Worksheet worksheet = workbook.getWorksheets().get(0);
com.aspose.cells.Cells cells = worksheet.getCells();
// get cell from cells collection
com.aspose.cells.Cell cell = cells.get("A5");
switch (cell.getType()) {
case com.aspose.cells.CellValueType.IS_BOOL:
System.out.println("Boolean Value: " + cell.getValue());
break;
case com.aspose.cells.CellValueType.IS_DATE_TIME:
System.out.println("Date Value: " + cell.getValue());
break;
case com.aspose.cells.CellValueType.IS_NUMERIC:
System.out.println("Numeric Value: " + cell.getValue());
break;
case com.aspose.cells.CellValueType.IS_STRING:
System.out.println("String Value: " + cell.getValue());
break;
case com.aspose.cells.CellValueType.IS_NULL:
System.out.println("Null Value");
break;
}