العمل مع عمليات الخلية الأساسية
نظرة عامة
يدعم API الخلية الأساسية القيم ذات النوع، وتخزين الصيغ، وفحص نوع القيمة عبر CellValueType، وتمثيل نصي موحد من خلال getStringValue().
تخزين القيم ذات النوع
import com.aspose.cells_foss.Cell;
import com.aspose.cells_foss.CellValueType;
import com.aspose.cells_foss.Workbook;
import com.aspose.cells_foss.Worksheet;
try (Workbook workbook = new Workbook()) {
Worksheet sheet = workbook.getWorksheets().get(0);
Cell a1 = sheet.getCells().get("A1");
a1.putValue("Revenue");
Cell b1 = sheet.getCells().get("B1");
b1.putValue(42500.75);
Cell c1 = sheet.getCells().get("C1");
c1.putValue(true);
Cell d1 = sheet.getCells().get("D1");
d1.setFormula("=B1*1.2");
// Type inspection
System.out.println(a1.getType()); // STRING
System.out.println(b1.getType()); // NUMBER
System.out.println(c1.getType()); // BOOLEAN
System.out.println(d1.getType()); // FORMULA
workbook.save("typed.xlsx");
}قِيَم تعداد CellValueType
| قيمة التعداد | الوصف |
|---|---|
STRING | قيمة نصية مخزنة بواسطة putValue(String) |
NUMBER | قيمة رقمية مخزنة بواسطة putValue(int) أو putValue(double) |
BOOLEAN | قيمة منطقية مخزنة بواسطة putValue(boolean) |
DATE_TIME | قيمة تاريخ/وقت مخزنة بواسطة putValue(LocalDateTime) |
FORMULA | سلسلة صيغة مخزنة بواسطة setFormula(String) |
BLANK | خلية فارغة — لم يتم تعيين قيمة |
الحصول على قيم السلسلة
cell.getStringValue() تُعيد سلسلة مستقلة عن الإعدادات المحلية مناسبة للعرض
أو للمعالجة اللاحقة بغض النظر عن نوع القيمة الأساسي:
import com.aspose.cells_foss.Cell;
import com.aspose.cells_foss.Workbook;
import com.aspose.cells_foss.Worksheet;
try (Workbook workbook = new Workbook()) {
Worksheet sheet = workbook.getWorksheets().get(0);
Cell b1 = sheet.getCells().get("B1");
b1.putValue(123);
System.out.println(b1.getStringValue()); // "123" — no decimal point
workbook.save("string-values.xlsx");
}تخزين الصيغ
import com.aspose.cells_foss.Cell;
import com.aspose.cells_foss.CellValueType;
import com.aspose.cells_foss.Workbook;
import com.aspose.cells_foss.Worksheet;
try (Workbook workbook = new Workbook()) {
Worksheet sheet = workbook.getWorksheets().get(0);
Cell b1 = sheet.getCells().get("B1");
b1.putValue(100.0);
Cell c1 = sheet.getCells().get("C1");
c1.setFormula("=B1*1.2");
System.out.println(c1.getType() == CellValueType.FORMULA); // true
workbook.save("formulas.xlsx");
}