Workbook

Properties Workbook الفئة هي الكائن الجذر لجميع عمليات الجداول الإلكترونية في aspose-cells-foss. تدير أوراق العمل، تتعامل مع إدخال/إخراج الملفات، وتوفر الوصول إلى خصائص المستند.

Properties: aspose.cells_foss

from aspose.cells_foss import Workbook

Properties

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

Properties:

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

Properties

PropertiesPropertiesPropertiesProperties
worksheetsWorksheetCollectionPropertiesمجموعة مرتبة من أوراق العمل. الوصول عبر الفهرس (wb.worksheets[0]) أو أضف عبر wb.add_worksheet(name).
document_propertiesDocumentPropertiesPropertiesالبيانات الوصفية الأساسية والمخصصة للمستند (العنوان، المؤلف، الموضوع، أزواج المفتاح-القيمة المخصصة).

Properties

save

wb.save(path, password=None)

احفظ دفتر العمل إلى ملف. يتم تحديد تنسيق الإخراج تلقائيًا من امتداد الملف.

PropertiesPropertiesProperties
pathstrمسار الملف الوجهة. استخدم .xlsx, .csv, .md,، أو .json امتداد. XLS غير مدعوم.
password`strNone`

Properties:

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.

PropertiesPropertiesProperties
pathstrProperties .md مسار الملف.
wb.save_as_markdown("output.md")

add_worksheet

wb.add_worksheet(name=None)

أضف ورقة عمل جديدة إلى دفتر العمل وأعدها.

PropertiesPropertiesProperties
name`strNone`

worksheets (فهرسة WorksheetCollection)

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

انظر أيضًا

 العربية