API Overview

Aspose.Cells FOSS API Reference

Properties

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(). ไลบรารีถูกจัดโครงสร้างรอบ ๆ a Workbook อ็อบเจ็กต์รากที่จัดการ worksheets, styles, charts, และ I/O.

จุดเริ่มต้นหลักคือ Workbook. แต่ละ Workbook มีหนึ่งหรือมากกว่า Worksheet วัตถุที่เข้าถึงผ่าน wb.worksheets[index]. เซลล์แต่ละเซลล์จะเข้าถึงผ่าน Cells คอลเลกชันโดยใช้การระบุแบบ A1 หรือดัชนีแถว/คอลัมน์ที่เริ่มจากศูนย์.

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 และ Worksheet

Properties Workbook class เป็นอ็อบเจ็กต์รากสำหรับการดำเนินการสเปรดชีตทั้งหมด มันจัดการการโหลดไฟล์ การบันทึก และการเข้าถึงแผ่นงานและคุณสมบัติของเอกสาร.

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 encryption

Properties

เพิ่มแผนภูมิลงในแผ่นงานโดยใช้ add_* เมธอดบน ws.charts. แต่ละเมธอดรับอาร์กิวเมนต์เชิงตำแหน่งสี่ตัว: top_row, left_col, bottom_row, right_col. เข้าถึงแผนภูมิโดยใช้ดัชนีเพื่อกำหนดชื่อเรื่องและชุดข้อมูล.

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_map

Properties

เพิ่มรูปทรงการวาดและกล่องข้อความลงในแผ่นงานโดยใช้ 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"

ค่าของเซลล์และสไตล์

อ่านและเขียนค่าของเซลล์โดยใช้ .value คุณสมบัติ. แก้ไขรูปแบบโดยการเข้าถึง cell.style โดยตรง.

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

หมายเหตุ: เมื่อกำหนด font.color, ใช้สตริงฐานสิบหกโดยไม่มี # คำนำหน้า (เช่น,., "FF0000" สำหรับสีแดง).

การตรวจสอบข้อมูล

เพิ่มรายการดรอปดาวน์หรือกฎการตรวจสอบอื่น ๆ ให้กับช่วงเซลล์โดยใช้ 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")

Properties

บันทึกหรือเปิดเวิร์กบุ๊กที่มีการป้องกันด้วยรหัสผ่าน:

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 สาธารณะ

Properties Cells คลาสให้การเข้าถึงเซลล์แต่ละเซลล์โดยใช้รูปแบบการระบุแบบ A1 (เช่น,., "A1") หรือดัชนีทูเพิลแถว/คอลัมน์ที่เริ่มจาก 1. คลาส Cell คลาสแสดงถึงเซลล์เดียวและเปิดเผย value, formula, และ style เป็นคุณสมบัติแบบอ่าน/เขียน การรวมและแยกเซลล์ได้รับการสนับสนุนผ่าน merge() และ unmerge() เมธอดบน 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")
PropertiesPropertiesProperties
Workbookเวิร์กบุ๊กอ็อบเจ็กต์เวิร์กบุ๊กราก
Worksheetแผ่นงานแผ่นงานเดียวที่มีเซลล์, แผนภูมิ, รูปร่าง
Cellsเซลล์คอลเลกชันเซลล์ที่มีการเข้าถึงแบบ A1 และแบบ 1‑based (แถว, คอลัมน์)
Cellเซลล์เซลล์เดียว: ค่า, สูตร, สไตล์
Styleสไตล์การจัดรูปแบบเซลล์: ฟอนต์, การเติม, เส้นขอบ, การจัดแนว
Chartแผนภูมิแผนภูมิฝังตัว
DataValidationการตรวจสอบข้อมูลกฎการตรวจสอบช่วงเซลล์
CSVHandlerตัวจัดการ csvการนำเข้า/ส่งออก CSV
MarkdownHandlerตัวจัดการ markdownการส่งออก Markdown
JsonHandlerตัวจัดการ jsonการส่งออก JSON
Shapeรูปร่างวาดรูปทรงหรือกล่องข้อความ
Tableตารางตารางโครงสร้างของ Excel
SparklineGroupสปาร์คลายน์แผนภูมิสปาร์คลายน์
HorizontalPageBreakCollectionการตัดหน้าการตัดหน้าด้วยตนเอง
AgileEncryptionParametersการเข้ารหัสพารามิเตอร์การเข้ารหัส AES
SaveFormatสมุดงานenum รูปแบบผลลัพธ์

รูปแบบทั่วไป

# 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

ดูเพิ่มเติม

 ภาษาไทย