Workbook
Workbook — Aspose.Cells FOSS for Python API Reference
ImageRenderOptions Workbook המחלקה היא האובייקט השורש לכל פעולות הגיליון האלקטרוני ב‑aspose-cells-foss. היא מנהלת גיליונות עבודה, מטפלת בקלט/פלט של קבצים, ומספקת גישה למאפייני המסמך.
ImageRenderOptions: aspose.cells_foss
from aspose.cells_foss import WorkbookImageRenderOptions
Workbook(path=None, password=None)| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|
path | `str | None` |
password | `str | None` |
ImageRenderOptions:
from aspose.cells_foss import Workbook
# Create a new empty workbook
wb = Workbook()
# Open an existing XLSX file
wb = Workbook("report.xlsx")
# Open an AES-encrypted file
wb = Workbook("protected.xlsx", password="secret")ImageRenderOptions
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|---|
worksheets | WorksheetCollection | ImageRenderOptions | אוסף מסודר של גיליונות עבודה. גישה לפי אינדקס (wb.worksheets[0]) או הוספה באמצעות wb.add_worksheet(name). |
document_properties | DocumentProperties | ImageRenderOptions | מטא‑נתוני מסמך בסיסיים ומותאמים (כותרת, מחבר, נושא, זוגות מפתח‑ערך מותאמים). |
ImageRenderOptions
save
wb.save(path, password=None)שומר את חוברת העבודה לקובץ. פורמט הפלט נקבע אוטומטית מהרחבת הקובץ.
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|
path | str | נתיב קובץ יעד. השתמש ב‑ .xlsx, .csv, .md, או .json סיומת. XLS אינו נתמך. |
password | `str | None` |
ImageRenderOptions:
wb.save("output.xlsx") # XLSX: default format
wb.save("output.csv") # CSV: first worksheet only
wb.save("protected.xlsx", password="secret") # encrypted XLSXsave_as_markdown
wb.save_as_markdown(path)מייצא את הגיליון הראשון כטבלת Markdown בפורמט של GitHub.
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|
path | str | ImageRenderOptions .md נתיב קובץ. |
wb.save_as_markdown("output.md")add_worksheet
wb.add_worksheet(name=None)מוסיף גיליון חדש לחוברת העבודה ומחזיר אותו.
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|
name | `str | None` |
worksheets (אינדקס של WorksheetCollection)
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|
__getitem__ | [index: int] -> Worksheet | החזר את גיליון העבודה במיקום אפס‑מבוסס index. |
__len__ | () -> int | מספר הגיליונות בחוברת העבודה הזו. |
דוגמאות שימוש
תהליך עבודה בסיסי של חוברת עבודה
from aspose.cells_foss import Workbook
wb = Workbook()
ws = wb.worksheets[0]
ws.name = "Sales"
ws.cells["A1"].put_value("Quarter")
ws.cells["B1"].put_value("Revenue")
ws.cells["A2"].put_value("Q1")
ws.cells["B2"].put_value(42000)
ws.cells["A3"].put_value("Q2")
ws.cells["B3"].put_value(58000)
ws.cells["B4"].formula = "=SUM(B2:B3)"
wb.save("sales.xlsx")הוספת מספר גליונות
from aspose.cells_foss import Workbook
wb = Workbook()
wb.worksheets[0].name = "Summary"
ws2 = wb.add_worksheet("Details")
ws3 = wb.add_worksheet("Charts")
print(len(wb.worksheets)) # 3
wb.save("multi-sheet.xlsx")פתיחה, שינוי ושמירה מחדש
from aspose.cells_foss import Workbook
wb = Workbook("existing.xlsx")
ws = wb.worksheets[0]
ws.cells["C1"].put_value("Updated")
wb.save("existing.xlsx") # overwrite in placeהצפנה בעת שמירה
from aspose.cells_foss import Workbook
wb = Workbook("report.xlsx")
wb.save("report-secure.xlsx", password="MyPassword123")