Introducere

Gestionarea foilor de calcul este nucleul crate-ului aspose-cells-foss-rust: obiectele care modelează un registru de lucru, foile sale și celulele acestora, și operațiile care transformă datele Rust în fișiere XLSX prezentabile. Acest articol parcurge această suprafață — de la crearea foilor și scrierea valorilor tipizate până la stilizare, aspectul paginii și caracteristicile structurale care fac registrele de lucru utilizabile: comentarii, hyperlink-uri, tabele și nume definite.

Tot ce este prezentat aici face parte din crate-ul open-source, licențiat sub MIT. Nu este implicată nicio instalare Microsoft Office în niciun moment; biblioteca citește și scrie formatul de pachet XLSX direct.

Această secțiune a fost revizuită în raport cu modelul sursă curent pentru cel mai recent comportament al produsului și acoperirea API.

Caracteristici cheie

Foi de lucru și colecții de celule

Foi de lucru sunt gestionate prin colecțiile de foi de calcul ale registrului de lucru. Foile sunt accesate prin index sau nume, redenumite cu set_name, iar celulele lor sunt accesate prin get_cells (citire) sau get_cells_mut (scriere):

let mut workbook = Workbook::new();
{
    let mut worksheets = workbook.get_worksheets_mut();
    let sheet = worksheets.get(0)?;
    sheet.set_name("Charts")?;
    {
        let mut cells = sheet.get_cells_mut();
        cells.get("A1")?.put_value_string("Month")?;
        cells.get("B1")?.put_value_string("Sales")?;
    }
}

Valori tipizate prin nume sau index

Celulele acceptă șiruri de caractere, întregi, valori booleene, zecimale și date-oră prin setter-e tipizate. Celulele pot fi adresate în stil A1 (get("B3")) sau numeric (get_by_index(row, column)), ceea ce se potrivește cu structurile generate:

for month in 1..=12_u32 {
    cells
        .get_by_index(month, 0)
        .put_value_string(format!("Month {month}"))?;
    cells
        .get_by_index(month, 1)
        .put_value_i32((month as i32 * 1000) + (month as i32 * 50))?;
}

Formule cu valori în cache

put_formula_with_cached_value stochează textul formulei împreună cu valoarea pe care Excel ar trebui să o afișeze înainte de prima recalculare — important când fișierul este utilizat de alte instrumente care citesc rezultatele în cache:

cells.get("F1")?.put_value_i32(10)?;
cells.get("G1")?
    .put_formula_with_cached_value("=F1*2", CellValue::Number(20.0))?;

Stilizare și aspect de pagină

CellStyle conține Font, Fill și Borders; StyleFlag selectează care aspecte de stil se aplică la o actualizare. NumberFormat controlează redarea valorii, iar PageSetup gestionează PaperSizeType și PageOrientationType pentru tipărire. FreezePane și VisibilityType pentru rânduri/coloane mențin navigabilitatea foilor mari.

Comentarii, hyperlinkuri și nume

Fluxurile de lucru și navigarea recenzentului sunt acoperite de Comment și CommentCollection, Hyperlink împreună cu HyperlinkCollection și DefinedName cu DefinedNameCollection pentru intervale denumite.

Tabele structurate și filtre

ListObject transformă un interval într-un tabel structurat cu stil TableStyleType și rânduri de TotalsCalculation; AutoFilter adaugă filtrare cu condiții FilterColumn și FilterOperatorType.

Pornire rapidă

Adaugă pachetul la fișierul tău Cargo.toml ca o dependență git (pachetul nu este încă publicat pe crates.io):

# Cargo.toml
[dependencies]
aspose-cells-foss-rust = { git = "https://github.com/aspose-cells-foss/Aspose.Cells-FOSS-for-Rust" }

O sesiune minimală de gestionare a foilor de calcul — creează, scrie, salvează, reîncarcă:

use aspose_cells_foss_rust::{CellValue, Workbook};
use std::error::Error;

fn main() -> Result<(), Box<dyn Error>> {
    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("Item")?;
        cells.get("B1")?.put_value_string("Quantity")?;
        cells.get("A2")?.put_value_string("Apples")?;
        cells.get("B2")?.put_value_i32(12)?;
    }
    workbook.save("inventory.xlsx")?;

    let loaded = Workbook::load_xlsx("inventory.xlsx")?;
    let sheet = loaded.worksheet("Sheet1")?;
    let cells = sheet.get_cells();
    println!("A2 = {}", cells.get("A2")?.display_string_value());

    Ok(())
}

Formate suportate

FormatExtensieCitireScriere
XLSX.xlsx✓✓

Încărcarea acceptă flagurile de reparare LoadOptions (try_repair_package, try_repair_xml) cu LoadDiagnostics structurat; salvarea se realizează prin save, save_xlsx sau save_with_format cu enumul SaveFormat.

Open Source și Licențiere

Aspose.Cells FOSS pentru Rust este licențiată sub MIT. Codul sursă se află pe GitHub; utilizarea comercială, modificarea și redistribuirea sunt permise.

Începeți

Resurse conexe