Workbook — Aspose.Cells FOSS for Python API Reference
Example Workbook class adalah objek akar untuk semua operasi hamparan dalam aspose-cells-foss. Ia mengurus lembar kerja, mengendalikan I/O fail, dan menyediakan akses kepada sifat dokumen.
Example: aspose.cells_foss
from aspose.cells_foss import WorkbookExample
Workbook(path=None, password=None)| Example | Example | Example |
|---|---|---|
path | `str | None` |
password | `str | None` |
Example:
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")Example
| Example | Example | Example | Example |
|---|---|---|---|
worksheets | WorksheetCollection | Example | Koleksi bertertib lembar kerja. Akses mengikut indeks (wb.worksheets[0]) atau tambah melalui wb.worksheets.add(name). |
document_properties | DocumentProperties | Example | Metadata dokumen teras dan khusus (tajuk, pengarang, subjek, pasangan kunci-nilai khusus). |
Example
save
wb.save(path, password=None)Simpan workbook ke dalam fail. Format output ditentukan secara automatik daripada sambungan fail.
| Example | Example | Example |
|---|---|---|
path | str | Laluan fail destinasi. Gunakan .xlsx, .xls, atau .csv sambungan. |
password | `str | None` |
Example:
wb.save("output.xlsx") # XLSX: default format
wb.save("output.xls") # XLS: legacy binary format
wb.save("output.csv") # CSV: first worksheet only
wb.save("protected.xlsx", password="secret") # encrypted XLSXsave_as_markdown
wb.save_as_markdown(path)Eksport lembar kerja pertama sebagai jadual Markdown berperisa GitHub.
| Example | Example | Example |
|---|---|---|
path | str | Example .md laluan fail. |
wb.save_as_markdown("output.md")worksheets (kaedah WorksheetCollection)
| Example | Example | Example |
|---|---|---|
add | (name: str) -> Worksheet | Tambah lembar kerja baru dengan nama yang diberikan dan kembalikan ia. |
__getitem__ | [index: int] -> Worksheet | Kembalikan lembar kerja pada indeks berasaskan sifar index. |
__len__ | () -> int | Bilangan lembar kerja dalam buku kerja ini. |
Contoh Penggunaan
Aliran Kerja Workbook Asas
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")Tambah Berbilang Lembar Kerja
from aspose.cells_foss import Workbook
wb = Workbook()
wb.worksheets[0].name = "Summary"
ws2 = wb.worksheets.add("Details")
ws3 = wb.worksheets.add("Charts")
print(len(wb.worksheets)) # 3
wb.save("multi-sheet.xlsx")Buka, Ubah, dan Simpan Semula
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 placeSulitkan semasa Simpan
from aspose.cells_foss import Workbook
wb = Workbook("report.xlsx")
wb.save("report-secure.xlsx", password="MyPassword123")