Giriş

Cell sınıfı, Aspose.Cells FOSS for Java’da temel birimdir. Tiplenmiş değerleri depolar, bunların çalışma zamanı tipini CellValueType enumu aracılığıyla ortaya çıkarır, Excel’in değerlendirmesi için formül dizelerini kalıcı hâle getirir ve getStringValue() aracılığıyla tutarlı bir dize temsili sağlar. Bu gönderi, doğrulanmış örneklerle temel hücre API’sini ayrıntılı olarak inceler.

Aşağıdaki tüm kod örnekleri Maven bağımlılığını kullanır:

<dependency>
  <groupId>com.aspose</groupId>
  <artifactId>cells-foss</artifactId>
  <version>1.0.0</version>
</dependency>

Core Cell API

putValue() ile Tiplenmiş Değerleri Depolama

Cell.putValue() altı Java türünü kabul eder: String, int, double, boolean, LocalDateTime ve Object. Her çağrı hücrenin iç değerini ayarlar ve CellValueType‘i belirler cell.getType() tarafından döndürülen.

import com.aspose.cells_foss.Cell;
import com.aspose.cells_foss.CellValueType;
import com.aspose.cells_foss.Workbook;
import com.aspose.cells_foss.Worksheet;
import java.time.LocalDateTime;

try (Workbook workbook = new Workbook()) {
    Worksheet sheet = workbook.getWorksheets().get(0);

    Cell a1 = sheet.getCells().get("A1");
    a1.putValue("Revenue");
    assert a1.getType() == CellValueType.STRING;

    Cell b1 = sheet.getCells().get("B1");
    b1.putValue(42500.75);
    assert b1.getType() == CellValueType.NUMBER;

    Cell c1 = sheet.getCells().get("C1");
    c1.putValue(true);
    assert c1.getType() == CellValueType.BOOLEAN;

    Cell d1 = sheet.getCells().get("D1");
    d1.putValue(LocalDateTime.of(2026, 4, 27, 9, 0, 0));
    assert d1.getType() == CellValueType.DATE_TIME;

    workbook.save("typed.xlsx");
}

Boş hücreler CellValueType.BLANK değerini getType()‘den döndürür. Tam sayı değerleri putValue(int) ile saklanıp XLSX serileştirmesi üzerinden dönüşüm yapıldığında ondalık nokta eklenmeden — getStringValue(), "123.0" yerine "123" döndürür.

Çalışma Zamanında Değerleri İnceleme

cell.getValue() ham depolanmış değeri Object olarak döndürür. cell.getStringValue()
aşağı akış işleme için uygun, yerel bağımsız bir dize temsili döndürür
veya görüntüleme. CellValueType üzerine dallanma, tip‑güvenli için önerilen desendir
değer çıkarımı:

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);
    sheet.getCells().get("A1").putValue("Hello");
    sheet.getCells().get("B1").putValue(123);
    sheet.getCells().get("C1").putValue(true);
    sheet.getCells().get("D1").putValue(12.5d);
    sheet.getCells().get("G1").setFormula("=B1*2");

    Cell b1 = sheet.getCells().get("B1");
    if (b1.getType() == CellValueType.NUMBER) {
        System.out.println("Number: " + b1.getStringValue());
    }
    workbook.save("inspect.xlsx");
}

Formül Depolama

Formül dizeleri cell.setFormula() ile saklanır. Saklanan formül dizesi = ile başlar
ve standart Excel formül sözdizimini izler. getType() yöntemi
CellValueType.FORMULA formül hücreleri için döndürür. Aspose.Cells FOSS for Java saklar ve
formülleri XLSX’te yuvarlak geçiş yapar; formül, açıldığında Excel tarafından yeniden hesaplanır.

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");
    assert c1.getType() == CellValueType.FORMULA;
    workbook.save("formulas.xlsx");
}

XLSX Gidiş-Dönüş Doğruluğu

Tüm yazılmış değerler XLSX serileştirmesi ve yeniden yükleme sırasında korunur. Mevcut bir .xlsx dosyasını yüklemek, onarım modunu etkinleştirmek için new Workbook(path) veya new Workbook(path, options) ile LoadOptions kullanır. Yeniden yüklemeden sonra, getType() ve getStringValue() yazma zamanındaki aynı değerleri döndürür.

import com.aspose.cells_foss.LoadIssue;
import com.aspose.cells_foss.LoadOptions;
import com.aspose.cells_foss.Workbook;
import com.aspose.cells_foss.Worksheet;

LoadOptions options = new LoadOptions();
options.setStrictMode(false);
options.setTryRepairPackage(true);
options.setTryRepairXml(true);

try (Workbook workbook = new Workbook("input.xlsx", options)) {
    if (workbook.getLoadDiagnostics().hasRepairs()) {
        for (LoadIssue issue : workbook.getLoadDiagnostics().getIssues()) {
            System.out.println(issue.getMessage());
        }
    }
    Worksheet sheet = workbook.getWorksheets().get(0);
    System.out.println(sheet.getCells().get("A1").getStringValue());
    workbook.save("output.xlsx");
}

Desteklenen Formatlar

BiçimUzantıOkumaYazma
Excel Open XML.xlsx✓✓

Açık Kaynak ve Lisanslama

Aspose.Cells FOSS for Java MIT lisansı altında yayınlanmıştır. Kullanmakta özgürsünüz, değiştirmek ve kişisel, açık kaynak ve ticari projelerde dağıtmak için olmadan kısıtlama. Kaynak kodu şu adreste mevcuttur github.com/aspose-cells-foss/Aspose.Cells-FOSS-for-Java.

Başlarken