Aperçu des fonctionnalités

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_mut emprunte 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 LoadOptions lors de l’ingestion de fichiers tiers.

API Reference Résumé

ClasseDescription
WorkbookObjet racine : créer, charger et enregistrer des classeurs XLSX
WorksheetUne feuille unique ainsi que ses cellules, graphiques et paramètres
CellMutCellule mutable : définisseurs de valeur typée et de formule
CellStyleMise en forme des cellules avec police, remplissage et bordures
ChartTypeSélection du type de graphique lors de l’ajout de graphiques
ValidationRègles de validation des données
AutoFilterFiltrage de plage
LoadOptionsComportement de chargement et indicateurs de réparation
CellsErrorType d’erreur renvoyé à travers le API

Voir aussi

 Français