Panoramica delle funzionalità
Panoramica delle funzionalità
Questa pagina mappa la superficie delle funzionalità di Aspose.Cells FOSS per Rust. Ogni area collega i tipi di punto d’ingresso che incontrerai nel API Reference.
Ciclo di vita della cartella di lavoro
Workbook è l’oggetto radice: Workbook::new crea una cartella di lavoro vuota, Workbook::load_xlsx apre un file esistente, e save, save_xlsx o save_with_format scrivono l’output XLSX governato dall’enum SaveFormat.
let mut workbook = Workbook::new();
workbook.save("report.xlsx")?;
let reloaded = Workbook::load_xlsx("report.xlsx")?;Celle, valori e formule
Le raccolte di celle provengono da get_cells / get_cells_mut su un foglio di lavoro. I setter tipizzati (put_value_string, put_value_i32, put_value_bool, put_value_decimal, put_value_date_time) evitano conversioni di stringa, e put_formula_with_cached_value memorizza le formule insieme ai loro risultati memorizzati nella cache:
cells.get("F1")?.put_value_i32(10)?;
cells.get("G1")?
.put_formula_with_cached_value("=F1*2", CellValue::Number(20.0))?;Grafici
I grafici si ancorano a intervalli di celle tramite la raccolta di grafici di un foglio con varianti ChartType come Column e Line; gli ancoraggi e i tipi possono essere letti di nuovo dai workbook caricati tramite Chart e ChartCollection.
Stile e Layout
CellStyle combina Font, Fill e Borders; StyleFlag seleziona quali aspetti si applicano. NumberFormat rende i valori, PageSetup controlla PaperSizeType e PageOrientationType, e FreezePane fissa le righe di intestazione.
Qualità dei Dati e Struttura
Validation (con OperatorType), FormatCondition formattazione condizionale, AutoFilter filtraggio, ListObject tabelle strutturate con TableStyleType, DefinedName intervalli denominati, e WorkbookProtection / WorksheetProtection.
Caricamento Difensivo
LoadOptions espone i flag try_repair_package e try_repair_xml; LoadDiagnostics segnala i problemi riscontrati durante il caricamento. Gli errori su tutta la superficie API utilizzano Result con CellsError.
Suggerimenti e Migliori Pratiche
- Scope
get_worksheets_mut/get_cells_mutprende in prestito in un blocco in modo che la cartella di lavoro possa essere salvata successivamente. - Preferisci i setter tipizzati invece di formattare i valori in stringhe.
- Fornisci sempre un valore cache con le formule affinché i file si aprano con risultati corretti prima della ricalcolazione.
- Utilizza i flag di riparazione
LoadOptionsquando si importano file di terze parti.
API Reference Riepilogo
| Classe | Descrizione |
|---|---|
Workbook | Oggetto radice: crea, carica e salva cartelle di lavoro XLSX |
Worksheet | Un singolo foglio e le sue celle, grafici e impostazioni |
CellMut | Cella mutabile: impostatori di valore tipizzato e di formula |
CellStyle | Formattazione delle celle con carattere, riempimento e bordi |
ChartType | Selezione del tipo di grafico durante l’aggiunta di grafici |
Validation | Regole di convalida dei dati |
AutoFilter | Filtro di intervallo |
LoadOptions | Caricamento del comportamento e flag di riparazione |
CellsError | Tipo di errore restituito attraverso il API |