ภาพรวมของคุณลักษณะ
ภาพรวมของฟีเจอร์
หน้านี้แสดงแผนที่คุณลักษณะของ Aspose.Cells FOSS สำหรับ Rust แต่ละพื้นที่เชื่อมโยงกับประเภทจุดเริ่มต้นที่คุณจะพบใน the API Reference.
วงจรชีวิตของ Workbook
Workbook คืออ็อบเจกต์ราก: Workbook::new สร้าง workbook ว่าง, Workbook::load_xlsx เปิดไฟล์ที่มีอยู่, และ save, save_xlsx หรือ save_with_format เขียนผลลัพธ์ XLSX ที่ถูกควบคุมโดย enum SaveFormat.
let mut workbook = Workbook::new();
workbook.save("report.xlsx")?;
let reloaded = Workbook::load_xlsx("report.xlsx")?;เซลล์, ค่า, และสูตร
คอลเลกชันของเซลล์มาจาก get_cells / get_cells_mut บนแผ่นงาน. ตัวตั้งค่าที่มีประเภท (put_value_string, put_value_i32, put_value_bool, put_value_decimal, put_value_date_time) ช่วยหลีกเลี่ยงการแปลงเป็นสตริง, และ put_formula_with_cached_value เก็บสูตรพร้อมกับผลลัพธ์ที่แคชไว้:
cells.get("F1")?.put_value_i32(10)?;
cells.get("G1")?
.put_formula_with_cached_value("=F1*2", CellValue::Number(20.0))?;แผนภูมิ
แผนภูมิจะเชื่อมโยงกับช่วงเซลล์ผ่านคอลเลกชันแผนภูมิของแผ่นงานด้วยตัวแปร ChartType เช่น Column และ Line; สามารถอ่านค่า anchor และประเภทกลับจากเวิร์กบุ๊กที่โหลดแล้วผ่าน Chart และ ChartCollection.
การจัดรูปแบบและเค้าโครง
CellStyle รวม Font, Fill และ Borders; StyleFlag เลือกด้านที่ใช้. NumberFormat แสดงค่า, PageSetup ควบคุม PaperSizeType และ PageOrientationType, และ FreezePane ยึดแถวหัวตาราง.
คุณภาพข้อมูลและโครงสร้าง
Validation (พร้อม OperatorType), การจัดรูปแบบตามเงื่อนไข FormatCondition, การกรอง AutoFilter, ตารางที่มีโครงสร้าง ListObject พร้อม TableStyleType, ช่วงที่ตั้งชื่อ DefinedName, และ WorkbookProtection / WorksheetProtection.
การโหลดเชิงป้องกัน
LoadOptions เปิดเผยแฟล็ก try_repair_package และ try_repair_xml; LoadDiagnostics รายงานปัญหาที่พบขณะโหลด. ข้อผิดพลาดทั่วพื้นผิว API ใช้ Result พร้อม CellsError.
เคล็ดลับและแนวปฏิบัติที่ดีที่สุด
- ขอบเขต
get_worksheets_mut/get_cells_mutยืมในบล็อกเพื่อให้สามารถบันทึกเวิร์กบุ๊คได้ภายหลัง. - ควรใช้ตัวตั้งค่าที่กำหนดประเภทแทนการจัดรูปแบบค่าเป็นสตริง.
- ควรให้ค่าที่แคชพร้อมสูตรเสมอ เพื่อให้ไฟล์เปิดด้วยผลลัพธ์ที่ถูกต้องก่อนการคำนวณใหม่.
- ใช้แฟล็กการซ่อมแซม
LoadOptionsเมื่อรับไฟล์จากบุคคลที่สาม.
API Reference สรุป
| คลาส | คำอธิบาย |
|---|---|
Workbook | อ็อบเจ็กต์ราก: สร้าง, โหลด และบันทึกสมุดงาน XLSX |
Worksheet | แผ่นงานเดียวและเซลล์, แผนภูมิ, และการตั้งค่าต่างๆ |
CellMut | เซลล์ที่เปลี่ยนแปลงได้: ตัวตั้งค่าค่าที่กำหนดประเภทและสูตร |
CellStyle | การจัดรูปแบบเซลล์ด้วย font, fill, และ borders |
ChartType | การเลือกประเภท Chart เมื่อเพิ่ม Chart |
Validation | กฎ Data validation |
AutoFilter | การกรอง Range |
LoadOptions | พฤติกรรมการโหลดและแฟล็กการซ่อมแซม |
CellsError | ประเภทข้อผิดพลาดที่ส่งคืนทั่วทั้ง API |