סקירת תכונות
סקירת תכונות
דף זה ממפה את משטח הפונקציות של Aspose.Cells FOSS עבור Rust. כל אזור מקשר את סוגי נקודת הכניסה שתפגשו ב- API Reference.
מחזור חיי חוברת עבודה
Workbook הוא האובייקט השורש: Workbook::new יוצר חוברת עבודה ריקה, Workbook::load_xlsx פותח קובץ קיים, ו-save, save_xlsx או save_with_format כותבים פלט XLSX הנשלט על ידי המונה 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; ניתן לקרוא חוגים וסוגים חזרה מקבצי עבודה טעונים באמצעות 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משאיל בחסימה כך שהחוברת יכולה להישמר לאחר מכן. - העדף typed setters על פני עיצוב ערכים למחרוזות.
- תמיד ספק ערך מטמון עם נוסחאות כדי שהקבצים ייפתחו עם תוצאות נכונות לפני חישוב מחדש.
- השתמש בדגלי תיקון
LoadOptionsבעת קלט קבצים של צד שלישי.
סיכום API Reference
| מחלקה | תיאור |
|---|---|
Workbook | אובייקט שורש: יצירה, טעינה ושמירת חוברות עבודה XLSX |
Worksheet | גליון יחיד והתאים שלו, תרשימים והגדרות |
CellMut | תא בר-עריכה: קובעי ערך טיפוסי ונוסחה |
CellStyle | עיצוב תאים עם font, fill ו-borders |
ChartType | בחירת סוג גרף בעת הוספת גרפים |
Validation | כללי אימות נתונים |
AutoFilter | סינון טווח |
LoadOptions | התנהגות טעינה ודגלי תיקון |
CellsError | סוג השגיאה שהוחזר דרך API |