Domande Frequenti
Licenze e Open Source
Quale licenza utilizza Aspose.Cells FOSS per Rust?
Il crate è rilasciato sotto la MIT License. Il testo completo è incluso nel repository come LICENSE.txt.
Posso usarlo in prodotti commerciali?
Sì. La MIT License consente l’uso commerciale, la modifica e la ridistribuzione. L’unico requisito è preservare il copyright e l’avviso di licenza nelle copie o nelle parti sostanziali del software.
Installazione e requisiti
Come installo il crate?
Aggiungi aspose-cells-foss-rust al tuo Cargo.toml come dipendenza git:
# Cargo.toml
[dependencies]
aspose-cells-foss-rust = { git = "https://github.com/aspose-cells-foss/Aspose.Cells-FOSS-for-Rust" }Vedi la guida all’installazione per una panoramica passo-passo.
Quali versioni di Rust sono supportate?
Il crate mira all’edizione Rust 2021.
Richiede Microsoft Office o librerie native?
No. La libreria legge e scrive direttamente il formato di pacchetto XLSX — non è necessaria alcuna installazione di Microsoft Office, automazione COM o runtime esterno.
Supporto dei formati
Quali formati possono essere letti e scritti?
XLSX è il formato supportato nella versione corrente: lettura e scrittura complete a ciclo completo. Il caricamento avviene tramite Workbook::load_xlsx (l’enumerazione LoadFormat copre Auto e Xlsx), e il salvataggio avviene tramite save, save_xlsx o save_with_format con l’enumerazione SaveFormat.
Può riparare i file XLSX danneggiati?
LoadOptions espone le flag try_repair_package e try_repair_xml, e LoadDiagnostics segnala i problemi riscontrati durante il caricamento:
let options = LoadOptions {
try_repair_package: true,
try_repair_xml: true,
..LoadOptions::default()
};
let loaded = Workbook::load_xlsx_with_options(&path, &options)?;API Usage
Qual è il modello tipico per creare un workbook?
Crea un Workbook, delimita i mutable borrow, scrivi i valori, quindi salva:
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("Hello")?;
}
workbook.save("hello.xlsx")?;Come scrivere diversi tipi di valore nelle celle?
Usa i setter tipizzati su una cella mutabile: put_value_string, put_value_i32, put_value_bool, put_value_decimal e put_value_date_time.
Come scrivo una formula?
Usa put_formula_with_cached_value, fornendo il valore che Excel dovrebbe visualizzare prima della prima ricalcolazione:
cells.get("G1")?
.put_formula_with_cached_value("=F1*2", CellValue::Number(20.0))?;Come leggere i valori da una cartella di lavoro caricata?
Recupera il foglio con worksheet (o la collezione di fogli di lavoro), poi leggi le celle tramite get_cells; display_string_value restituisce il testo visualizzato e value_type segnala il tipo memorizzato.
Limitazioni note
Il crate è su crates.io?
Non ancora — installalo come dipendenza git di Cargo dal repository GitHub. Cargo registra il commit esatto in Cargo.lock, così le compilazioni rimangono riproducibili.
Sono supportati formati diversi da XLSX?
No. L’attuale release si concentra sul round-trip di XLSX; altri formati di fogli di calcolo non sono letti né scritti.
