Ikhtisar Fitur
Ikhtisar Fitur
Halaman ini memetakan feature surface Aspose.Cells FOSS untuk Rust. Setiap area menautkan entry-point types yang akan Anda temui di the API Reference.
Siklus Hidup Buku Kerja
Workbook adalah objek akar: Workbook::new membuat buku kerja kosong, Workbook::load_xlsx membuka file yang ada, dan save, save_xlsx, atau save_with_format menulis output XLSX yang dikelola oleh enum SaveFormat.
let mut workbook = Workbook::new();
workbook.save("report.xlsx")?;
let reloaded = Workbook::load_xlsx("report.xlsx")?;Sel, Nilai, dan Formula
Koleksi sel datang dari get_cells / get_cells_mut pada lembar kerja. Setter yang bertipe (put_value_string, put_value_i32, put_value_bool, put_value_decimal, put_value_date_time) menghindari konversi string, dan put_formula_with_cached_value menyimpan formula bersama dengan hasil cache-nya:
cells.get("F1")?.put_value_i32(10)?;
cells.get("G1")?
.put_formula_with_cached_value("=F1*2", CellValue::Number(20.0))?;Diagram
Diagram menambat ke rentang sel melalui koleksi diagram lembar dengan varian ChartType seperti Column dan Line; penambatan dan tipe dapat dibaca kembali dari buku kerja yang dimuat melalui Chart dan ChartCollection.
Penataan dan Tata Letak
CellStyle menggabungkan Font, Fill, dan Borders; StyleFlag memilih aspek yang diterapkan. NumberFormat menampilkan nilai, PageSetup mengontrol PaperSizeType dan PageOrientationType, dan FreezePane menetapkan baris header.
Kualitas Data dan Struktur
Validation (dengan OperatorType), FormatCondition format bersyarat, AutoFilter penyaringan, ListObject tabel terstruktur dengan TableStyleType, DefinedName rentang bernama, dan WorkbookProtection / WorksheetProtection.
Pemuat Defensif
LoadOptions menampilkan try_repair_package dan try_repair_xml bendera; LoadDiagnostics melaporkan masalah yang ditemukan saat pemuatan. Kesalahan di seluruh permukaan API menggunakan Result dengan CellsError.
Tips dan Praktik Terbaik
- Scope
get_worksheets_mut/get_cells_mutmeminjam dalam sebuah blok sehingga workbook dapat disimpan setelahnya. - Lebih pilih setter yang bertipe daripada memformat nilai menjadi string.
- Selalu sediakan nilai cache dengan formula sehingga file terbuka dengan hasil yang benar sebelum perhitungan ulang.
- Gunakan flag perbaikan
LoadOptionssaat mengimpor file pihak ketiga.
API Reference Ringkasan
| Kelas | Deskripsi |
|---|---|
Workbook | Root object: membuat, memuat, dan menyimpan XLSX workbooks |
Worksheet | Satu sheet dan cells, charts, dan pengaturan |
CellMut | Mutable cell: typed value dan formula setters |
CellStyle | Pemformatan sel dengan font, isi, dan batas |
ChartType | Pemilihan tipe diagram saat menambahkan diagram |
Validation | Aturan validasi data |
AutoFilter | Penyaringan rentang |
LoadOptions | Perilaku pemuatan dan bendera perbaikan |
CellsError | Jenis kesalahan yang dikembalikan di seluruh API |