Workbook

Workbook — Aspose.Cells FOSS for Python API Reference

ImageRenderOptions Workbook کلاس ریشه‌ای برای تمام عملیات صفحه‌گسترده در aspose-cells-foss است. این کلاس برگه‌های کاری را مدیریت می‌کند، ورودی/خروجی فایل‌ها را پردازش می‌کند و دسترسی به ویژگی‌های سند را فراهم می‌آورد.

ImageRenderOptions: aspose.cells_foss

from aspose.cells_foss import Workbook

ImageRenderOptions

Workbook(path=None, password=None)
ImageRenderOptionsImageRenderOptionsImageRenderOptions
path`strNone`
password`strNone`

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

ImageRenderOptionsImageRenderOptionsImageRenderOptionsImageRenderOptions
worksheetsWorksheetCollectionImageRenderOptionsمجموعهٔ مرتب‌شده‌ای از برگه‌های کاری. دسترسی با اندیس (wb.worksheets[0]) یا افزودن از طریق wb.add_worksheet(name).
document_propertiesDocumentPropertiesImageRenderOptionsمتادیتای اصلی و سفارشی سند (عنوان، نویسنده، موضوع، جفت‌های کلید‑مقدار سفارشی).

ImageRenderOptions

save

wb.save(path, password=None)

کتاب‌کار را در یک فایل ذخیره می‌کند. قالب خروجی به‌صورت خودکار از پسوند فایل تعیین می‌شود.

ImageRenderOptionsImageRenderOptionsImageRenderOptions
pathstrمسیر فایل مقصد. استفاده کنید .xlsx, .csv, .md,، یا .json پسوند. XLS پشتیبانی نمی‌شود.
password`strNone`

ImageRenderOptions:

wb.save("output.xlsx")        # XLSX: default format
wb.save("output.csv")         # CSV: first worksheet only
wb.save("protected.xlsx", password="secret")  # encrypted XLSX

save_as_markdown

wb.save_as_markdown(path)

ورق کاری اول را به‌صورت جدول Markdown با فرمت GitHub صادر می‌کند.

ImageRenderOptionsImageRenderOptionsImageRenderOptions
pathstrImageRenderOptions .md مسیر فایل.
wb.save_as_markdown("output.md")

add_worksheet

wb.add_worksheet(name=None)

یک ورق کاری جدید به کتاب‌کار اضافه می‌کند و آن را برمی‌گرداند.

ImageRenderOptionsImageRenderOptionsImageRenderOptions
name`strNone`

worksheets (نمایه‌گذاری WorksheetCollection)

ImageRenderOptionsImageRenderOptionsImageRenderOptions
__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")

همچنین ببینید

 فارسی