Aspose.Cells FOSS API Reference
Enumerations
Aspose.Cells FOSS is an open-source Python library for creating, reading, and modifying spreadsheet files without requiring Microsoft Excel. It supports XLSX and CSV formats for input, and adds Markdown export via save_as_markdown(). Thư viện được cấu trúc xung quanh một Workbook đối tượng gốc quản lý các worksheet, styles, charts và I/O.
Điểm vào cốt lõi là Workbook. Mỗi Workbook chứa một hoặc nhiều Worksheet đối tượng được truy cập qua wb.worksheets[index]. Các ô riêng lẻ được truy cập thông qua Cells bộ sưu tập bằng cách sử dụng ký hiệu A1 hoặc chỉ số hàng/cột bắt đầu từ 0.
from aspose.cells_foss import Workbook
wb = Workbook()
ws = wb.worksheets[0]
ws.cells["A1"].value = "Revenue"
ws.cells["B2"].value = 42
wb.save("output.xlsx")Workbook và Worksheet
Enumerations Workbook lớp là đối tượng gốc cho mọi thao tác spreadsheet. Nó xử lý việc tải, lưu file và truy cập các worksheet cũng như thuộc tính tài liệu.
from aspose.cells_foss import Workbook
wb = Workbook() # new workbook
wb = Workbook("input.xlsx") # open existing file
wb = Workbook("protected.xlsx", password="secret") # open encrypted file
ws = wb.worksheets[0] # first worksheet (0-based)
ws = wb.add_worksheet("Sheet2") # add a named worksheet
ws.cells["A1"].put_value("Hello") # write by A1 reference
ws.cells["A1"].value # read value (property, no parentheses)
ws.cells["A2"].formula = "=SUM(B1:B5)"
wb.save("output.xlsx") # save as XLSX
wb.save("output.csv") # auto-detects format from extension
wb.save_as_markdown("output.md") # export as Markdown table
wb.save("output.xlsx", password="secret") # save with AES encryptionEnumerations
Thêm charts vào worksheet bằng cách sử dụng add_* các phương thức trên ws.charts. Mỗi phương thức nhận bốn đối số vị trí: top_row, left_col, bottom_row, right_col. Truy cập chart theo chỉ mục để đặt tiêu đề và series dữ liệu.
from aspose.cells_foss import Workbook
wb = Workbook()
ws = wb.worksheets[0]
chart_idx = ws.charts.add_line(upper_left_row=0, upper_left_col=4,
lower_right_row=20, lower_right_col=12)
chart = ws.charts[chart_idx]
chart.title = "Monthly Sales"
chart.n_series.add("B2:B7", category_data="A2:A7", name="Sales")
# Other add methods: add_bar, add_pie, add_area, add_scatter,
# add_waterfall, add_combo, add_stock, add_surface, add_radar,
# add_treemap, add_sunburst, add_histogram, add_funnel,
# add_box_whisker, add_mapEnumerations
Thêm các drawing shapes và text boxes vào worksheet bằng cách sử dụng ws.shapes.
from aspose.cells_foss import Workbook
from aspose.cells_foss import MsoDrawingType, TextAlignmentType, TextAnchorType
wb = Workbook()
ws = wb.worksheets[0]
shape = ws.shapes.add(MsoDrawingType.ROUNDED_RECTANGLE, 1, 1, 5, 5)
shape.text = "Hello"
shape.fill.fore_color = "90EE90"
shape.font.bold = True
shape.text_horizontal_alignment = TextAlignmentType.CENTER
shape.text_vertical_alignment = TextAnchorType.MIDDLE
textbox = ws.shapes.add_text_box(7, 1, 11, 8)
textbox.text = "Notes"Giá trị và Kiểu dáng ô
Đọc và ghi giá trị ô bằng cách sử dụng .value thuộc tính. Thay đổi formatting bằng cách truy cập cell.style trực tiếp.
from aspose.cells_foss import Workbook
workbook = Workbook()
worksheet = workbook.worksheets[0]
# Write values
worksheet.cells["A1"].value = "Hello"
worksheet.cells["B1"].value = "World"
worksheet.cells["A2"].value = 42
worksheet.cells["B2"].value = 3.14
# Read a value
value = worksheet.cells["A1"].value
print(f"Cell A1 contains: {value}")
# Apply a style via the cell's style property
cell = worksheet.cells["A1"]
cell.style.font.bold = True
cell.style.font.size = 14
cell.style.font.color = "FF0000" # RRGGBB hex, no # prefix
cell.style.set_horizontal_alignment("center")
cell.style.set_number_format("#,##0.00")
cell.style.set_border("bottom", line_style="thin")
workbook.save("output.xlsx")Lưu ý: khi thiết lập font.color, sử dụng một chuỗi hex mà không có một # tiền tố (ví dụ,., "FF0000" cho màu đỏ).
Xác thực Dữ liệu
Thêm danh sách thả xuống hoặc các quy tắc xác thực khác cho một phạm vi ô bằng cách sử dụng ws.data_validations.
from aspose.cells_foss import Workbook, DataValidationType
workbook = Workbook()
worksheet = workbook.worksheets[0]
validation = worksheet.data_validations.add("A1:A10")
validation.type = DataValidationType.LIST
validation.formula1 = '"Option1,Option2,Option3"'
workbook.save("validation.xlsx")Enumerations
Lưu hoặc mở workbook được bảo vệ bằng mật khẩu:
from aspose.cells_foss import Workbook
workbook = Workbook()
worksheet = workbook.worksheets[0]
worksheet.cells["A1"].value = "Confidential Data"
# Save with password protection
workbook.save("protected.xlsx", password="mypassword")
# Open a password-protected file
workbook2 = Workbook("protected.xlsx", password="mypassword")API Công khai
Enumerations Cells lớp cung cấp quyền truy cập vào các ô riêng lẻ bằng cách sử dụng ký hiệu kiểu A1 (ví dụ,., "A1") hoặc chỉ số tuple (hàng, cột) bắt đầu từ 1. Các Cell lớp đại diện cho một ô duy nhất và cung cấp value, formula, và style như các thuộc tính đọc/ghi. Việc hợp nhất và tách hợp nhất các ô được hỗ trợ thông qua merge() và unmerge() phương thức trên Cells.
from aspose.cells_foss import Workbook
workbook = Workbook()
worksheet = workbook.worksheets[0]
worksheet.cells["A1"].value = "Hello"
worksheet.cells["B1"].value = "World" # A1 notation preferred
workbook.save("output.xlsx")| Enumerations | Enumerations | Enumerations |
|---|---|---|
Workbook | sổ làm việc | Đối tượng sổ làm việc gốc |
Worksheet | bảng tính | Bảng tính đơn lẻ với các ô, biểu đồ, hình dạng |
Cells | các ô | Bộ sưu tập ô với truy cập kiểu A1 và dựa trên chỉ số 1 (hàng, cột) |
Cell | ô | Ô đơn: giá trị, công thức, định dạng |
Style | định dạng | Định dạng ô: phông chữ, nền, viền, căn chỉnh |
Chart | biểu đồ | Biểu đồ nhúng |
DataValidation | kiểm tra dữ liệu | Quy tắc kiểm tra phạm vi ô |
CSVHandler | bộ xử lý csv | Nhập/Xuất CSV |
MarkdownHandler | bộ xử lý markdown | Xuất Markdown |
JsonHandler | bộ xử lý json | Xuất JSON |
Shape | hình dạng | Vẽ hình dạng hoặc hộp văn bản |
Table | bảng | bảng có cấu trúc trong Excel |
SparklineGroup | sparkline | biểu đồ sparkline |
HorizontalPageBreakCollection | ngắt trang | ngắt trang thủ công |
AgileEncryptionParameters | mã hoá | tham số mã hoá AES |
SaveFormat | sổ làm việc | Enum định dạng đầu ra |
Các mẫu chung
# Styling a cell
cell = ws.cells["A1"]
cell.style.font.bold = True
cell.style.font.size = 14
cell.style.font.color = "FF0000" # red (RRGGBB, no #)
cell.style.set_horizontal_alignment("center")
cell.style.set_number_format("#,##0.00")
cell.style.set_border("bottom", line_style="thin")# Add a dropdown validation
from aspose.cells_foss import DataValidationType
dv = ws.data_validations.add("B1:B10")
dv.type = DataValidationType.LIST
dv.formula1 = '"Red,Green,Blue"'
dv.show_dropdown = True