Rust'ta Elektronik Tablo Nasıl Yüklenir

Aspose.Cells Rust için FOSS, Excel XLSX çalışma kitaplarını paket formatından doğrudan yükler — Microsoft Office’a gerek yok. Bu kılavuz, aspose-cells-foss-rust crate’ini Cargo aracılığıyla kurar, bir çalışma kitabını Workbook::load_xlsx ile yükler ve kusurlu dosyaları LoadOptions onarım bayrakları ve LoadDiagnostics ile işler.

Adım Adım Rehber

Adım 1: Paketi Yükle

Crate’i Cargo.toml‘a Cargo git bağımlılığı olarak ekleyin:

# Cargo.toml
[dependencies]
aspose-cells-foss-rust = { git = "https://github.com/aspose-cells-foss/Aspose.Cells-FOSS-for-Rust" }

Ardından projeyi derleyin:

cargo build

Adım 2: Gerekli Sınıfları İçe Aktar

use aspose_cells_foss_rust::{LoadOptions, Workbook};
use std::error::Error;

Adım 3: Yüklemek İçin Örnek Bir Dosya Oluştur

Diskte hâlihazırda bir çalışma kitabınız yoksa, önce bir tane yazın:

let mut workbook = Workbook::new();
{
    let mut worksheets = workbook.get_worksheets_mut();
    let sheet = worksheets.get(0)?;
    let mut cells = sheet.get_cells_mut();

    cells.get("A1")?.put_value_string("Item")?;
    cells.get("B1")?.put_value_string("Quantity")?;
    cells.get("A2")?.put_value_string("Apples")?;
    cells.get("B2")?.put_value_i32(12)?;
}
workbook.save("inventory.xlsx")?;

Adım 4: Çalışma Kitabını Yükle

Workbook::load_xlsx düzgün biçimlendirilmiş bir XLSX dosyasını açar:

let loaded = Workbook::load_xlsx("inventory.xlsx")?;
let sheet = loaded.worksheet("Sheet1")?;
let cells = sheet.get_cells();
println!("A2 = {}", cells.get("A2")?.display_string_value());

Adım 5: Onarım Seçenekleriyle Savunmacı Şekilde Yükle

Üçüncü taraf dosyalar için, onarım bayraklarını etkinleştirin ve yükleyicinin topladığı tanı bilgilerini inceleyin:

let options = LoadOptions {
    try_repair_package: true,
    try_repair_xml: true,
    ..LoadOptions::default()
};

let loaded = Workbook::load_xlsx_with_options("inventory.xlsx", &options)?;
println!(
    "Loaded workbook with {} worksheet(s) and {} diagnostic issue(s).",
    loaded.get_worksheets().count(),
    loaded.get_load_diagnostics().issues().len()
);

Yaygın Sorunlar ve Çözümler

Yükleme çağrısı, Excel’de açılan bir dosya için hata döndürür. Enable try_repair_package and try_repair_xml in LoadOptions ve şu şekilde yükle Workbook::load_xlsx_with_options — Excel, katı yüklemenin reddettiği bazı paket düzensizliklerine tolerans gösterir.

worksheet("Sheet1") yükleme sonrasında başarısız olur. Sayfa farklı bir ada sahip olabilir. Şu şekilde enumerate edin get_worksheets ya da bunun yerine çalışma sayfası koleksiyonu üzerinden indeksle getir.

Değerler boş stringler olarak geri okunur. Kullan display_string_value hücredeki görüntü metni üzerinde ve kontrol edin value_type gerçekte neyin depolandığını görmek için.

Formüller eski sonuçlar gösteriyor. Yükleyici, dosyada depolanan önbelleklenmiş değerleri korur; yeniden hesaplama tüketicinin sorumluluğundadır. Yazarken, her zaman doğru bir önbelleklenmiş değeri şuraya aktarın put_formula_with_cached_value.

Sıkça Sorulan Sorular

Hangi formatlar yüklenebilir?

Şu anki sürümde yalnızca XLSX. LoadFormat enum’ı Auto ve Xlsx‘yi kapsar.

Microsoft Office yüklü olması gerekiyor mu?

Hayır. Kütüphane XLSX paketini doğrudan ayrıştırır; Office, COM veya harici bir çalışma zamanı kullanılmaz.

Yükleyicinin bir şey düzelttiğini nasıl anlayabilirim?

Yüklenen çalışma kitabında get_load_diagnostics okuyun — LoadDiagnostics yükleme sırasında karşılaşılan sorunları listeler.