Working with Core Cell Operations

العمل مع عمليات الخلية الأساسية

نظرة عامة

يدعم 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");
}
 العربية