Munkavégzés a Táblázatkezeléssel

A táblázatkezelés használata

A táblázatkezelés lefedi a crate mindennapi objektumfelületét: munkalapok, cellagyűjtemények, típusos értékek, képletek, formázás, valamint a szerkezeti jellemzőket, amelyek használhatóvá teszik a munkafüzetet. A belépési pont mindig egy Workbook.

Worksheets

A lapok a munkafüzet munkalap-gyűjteményein keresztül kezelhetők — olvasási hozzáférés get_worksheets útján, módosítás get_worksheets_mut útján. A lapok index (get(0)) vagy név (get_by_name) alapján érhetők el, átnevezhetők set_name segítségével, és hozzáadhatók add_worksheet használatával:

let mut workbook = Workbook::new();
{
    let mut worksheets = workbook.get_worksheets_mut();
    let sheet = worksheets.get(0)?;
    sheet.set_name("Data")?;
}

Cella hozzáférés és típusos értékek

A cellákat A1-stílusban vagy numerikusan lehet hivatkozni. get_by_index(row, column) alkalmas generált elrendezésekhez:

let mut cells = sheet.get_cells_mut();
cells.get("A1")?.put_value_string("Month")?;
for month in 1..=12_u32 {
    cells
        .get_by_index(month, 0)
        .put_value_string(format!("Month {month}"))?;
}

Visszaolvasáskor a display_string_value visszaadja a megjelenített szöveget, a value_type pedig jelzi a tárolt típust.

Képletek gyorsítótárazott eredményekkel

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

A gyorsítótárazott érték az, amit az Excel az első újraszámolás előtt megjelenít — biztosítsd, hogy a fájl felhasználói azonnal a helyes eredményeket lássák.

Styling

CellStyle összegzi a Font, Fill és Borders elemeket; StyleFlag szabályozza, hogy a frissítés mely stílusaspektusokra vonatkozik, így a meglévő formázás megmarad, ahol nem írod felül. NumberFormat határozza meg, hogyan jelennek meg az értékek.

Oldalbeállítás és navigáció

PageSetup kezeli a nyomtatási elrendezést: PaperSizeType, PageOrientationType és a margókat. FreezePane láthatóvá teszi a fejlécsorokat a görgetés közben, és a sor- és oszlopszintű láthatóság a VisibilityType használatával.

Struktúra: Táblák, Nevek, Megjegyzések, Hiperhivatkozások

• ListObject egy tartományt strukturált táblává alakít TableStyleType stílusával és TotalsCalculation összegző sorokkal.
• DefinedName és DefinedNameCollection kezelik a névvel ellátott tartományokat.
• Comment / CommentCollection és Hyperlink / HyperlinkCollection lefedik a megjegyzéseket és a navigációt.

Tippek és legjobb gyakorlatok

• Tartsd a változtatható kölcsönzéseket (get_worksheets_mut, get_cells_mut) egy hatókör blokkban; a blokk lezárása után mentsd el a munkafüzetet.
• Használd a get_by_index ciklusokhoz és generált elrendezésekhez; A1 neveket rögzített pozíciókhoz.
• Alkalmazz stílusokat egy StyleFlag segítségével, hogy a nem kapcsolódó formázás érintetlen maradjon.
• Nevezd el a fontos tartományokat DefinedName használatával a címek kézi kódolása helyett.

Gyakori problémák

FAQ

Hogyan adhatok hozzá egy második munkalapot?

Hívja meg a add_worksheet függvényt a munkafüzeten, majd szerezze be a munkalapgyűjteményen keresztül index vagy név alapján.

Olvashatok és írhatok egyetlen átfutásban?

Igen — töltse be a Workbook::load_xlsx segítségével, módosítsa a get_worksheets_mut segítségével, és save ugyanarra vagy egy új útvonalra.

A típusos beállítók konvertálják az értékeket?

Nem történik átalakítás: minden put_value_* beállító a saját natív típusát tárolja; a display_string_value olvasáskor megjeleníti a megjelenítendő szöveget.

API Reference összefoglaló

Lásd még:

• Aspose.Cells — Enterprise Documentation