עבודה עם ניהול גיליונות אלקטרוניים

עבודה עם ניהול גיליונות אלקטרוניים

ניהול הגיליון האלקטרוני מכסה את המשטח היומיומי של האובייקט בחבילה: גיליונות עבודה, אוספי תאים, ערכים טיפוסיים, נוסחאות, עיצוב, והתכונות המבניות שהופכות חוברת עבודה לשימושית. נקודת הכניסה היא תמיד Workbook.

Worksheets

גיליונות מנוהלים דרך אוספי הגיליונות של חוברת העבודה — גישה לקריאה באמצעות get_worksheets, שינוי באמצעות get_worksheets_mut. גליונות נגישים לפי אינדקס (get(0)) או שם (get_by_name), משנים שם עם set_name, ומתווספים עם add_worksheet:

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

גישה לתאים וערכים טיפוסיים

תאים נגישים בסגנון A1 או מספרית. get_by_index(row, column) מתאים לפריסות שנוצרו:

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}"))?;
}

בקריאה חזרה, display_string_value מחזיר את הטקסט המוצג ו-value_type מדווח על הסוג השמור.

נוסחאות עם תוצאות שמורות במטמון

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

הערך השמור במטמון הוא מה שמציג Excel לפני החישוב הראשון שלו — ספק אותו כך שמקבלי הקובץ יראו תוצאות נכונות מיד.

Styling

CellStyle מאגד את Font, Fill, ו-Borders; StyleFlag שולט באילו היבטים של העיצוב עדכון חל, כך שהעיצוב הקיים נשמר במקומות בהם אינך משכתב אותו. NumberFormat שולט באופן שבו ערכים מוצגים.

הגדרת עמוד וניווט

PageSetup מנהל את פריסת ההדפסה: PaperSizeType, PageOrientationType, והשוליים. FreezePane שומר על שורות הכותרת גלויות בזמן גלילה, והצגת שורות ועמודות נעזרת ב-VisibilityType.

מבנה: טבלאות, שמות, הערות, קישורים

• ListObject הופך טווח לטבלה מובנית עם עיצוב TableStyleType ושורות סיכום TotalsCalculation.
• DefinedName ו-DefinedNameCollection מנהלים טווחים בשם.
• Comment / CommentCollection ו-Hyperlink / HyperlinkCollection מכסים הערה וניווט.

טיפים ושיטות עבודה מומלצות

• שמור על השאלות המשתנות (get_worksheets_mut, get_cells_mut) בתוך בלוק תחום; שמור את חוברת העבודה לאחר סגירת הבלוק.
• השתמש ב-get_by_index ללולאות ולפריסות שנוצרו; שמות A1 למיקומים קבועים.
• החל סגנונות עם StyleFlag כדי שהעיצוב הלא קשור יישאר ללא שינוי.
• שם טווחים חשובים עם DefinedName במקום לקודד כתובות באופן קבוע.

בעיות נפוצות

FAQ

איך מוסיפים גיליון שני?

קראו ל-add_worksheet על חוברת העבודה, ואז קבלו אותה דרך אוסף הגיליונות לפי אינדקס או שם.

האם אפשר לקרוא ולכתוב באותו מעבר?

כן — טען עם Workbook::load_xlsx, שנה דרך get_worksheets_mut, ו-save אל אותו הנתיב או לנתיב חדש.

האם ממלאים מסווגים ממירים ערכים?

אין המרות: כל ממלא put_value_* שומר את הסוג הטבעי שלו; display_string_value מציג את טקסט ההצגה בקריאה.

API Reference סיכום

ראה גם

• Aspose.Cells — Enterprise Documentation