Aperçu des fonctionnalités
Aperçu des fonctionnalités
Cette page cartographie la surface fonctionnelle de Aspose.Cells FOSS pour Rust. Chaque zone lie les types d’entrée que vous rencontrerez dans le API Reference.
Cycle de vie du classeur
Workbook est l’objet racine: Workbook::new crée un classeur vide, Workbook::load_xlsx ouvre un fichier existant, et save, save_xlsx ou save_with_format écrivent la sortie XLSX régie par l’énumération SaveFormat.
let mut workbook = Workbook::new();
workbook.save("report.xlsx")?;
let reloaded = Workbook::load_xlsx("report.xlsx")?;Cellules, valeurs et formules
Les collections de cellules proviennent de get_cells / get_cells_mut sur une feuille de calcul. Les setters typés (put_value_string, put_value_i32, put_value_bool, put_value_decimal, put_value_date_time) évitent les conversions de chaînes, et put_formula_with_cached_value stocke les formules avec leurs résultats mis en cache:
cells.get("F1")?.put_value_i32(10)?;
cells.get("G1")?
.put_formula_with_cached_value("=F1*2", CellValue::Number(20.0))?;Graphiques
Les graphiques sont ancrés aux plages de cellules via la collection de graphiques d’une feuille avec des variantes ChartType telles que Column et Line; les ancres et les types peuvent être relus à partir des classeurs chargés via Chart et ChartCollection.
Style et mise en page
CellStyle combine Font, Fill et Borders; StyleFlag sélectionne les aspects à appliquer. NumberFormat rend les valeurs, PageSetup contrôle PaperSizeType et PageOrientationType, et FreezePane fixe les lignes d’en-tête.
Qualité des données et structure
Validation (avec OperatorType), FormatCondition mise en forme conditionnelle, AutoFilter filtrage, ListObject tables structurées avec TableStyleType, DefinedName plages nommées, et WorkbookProtection / WorksheetProtection.
Chargement défensif
LoadOptions expose les indicateurs try_repair_package et try_repair_xml; LoadDiagnostics signale les problèmes détectés lors du chargement. Les erreurs sur la surface API utilisent Result avec CellsError.
Conseils et bonnes pratiques
- La portée
get_worksheets_mut/get_cells_mutemprunte dans un bloc afin que le classeur puisse être enregistré ensuite. - Privilégiez les setters typés plutôt que de formater les valeurs en chaînes.
- Fournissez toujours une valeur en cache avec les formules afin que les fichiers s’ouvrent avec les résultats corrects avant le recalcul.
- Utilisez les indicateurs de réparation
LoadOptionslors de l’ingestion de fichiers tiers.
API Reference Résumé
| Classe | Description |
|---|---|
Workbook | Objet racine : créer, charger et enregistrer des classeurs XLSX |
Worksheet | Une feuille unique ainsi que ses cellules, graphiques et paramètres |
CellMut | Cellule mutable : définisseurs de valeur typée et de formule |
CellStyle | Mise en forme des cellules avec police, remplissage et bordures |
ChartType | Sélection du type de graphique lors de l’ajout de graphiques |
Validation | Règles de validation des données |
AutoFilter | Filtrage de plage |
LoadOptions | Comportement de chargement et indicateurs de réparation |
CellsError | Type d’erreur renvoyé à travers le API |