Workbook

Workbook — Aspose.Cells FOSS for Python API Reference

ImageRenderOptions Workbook class는 aspose-cells-foss에서 모든 스프레드시트 작업의 루트 객체입니다. 워크시트를 관리하고 파일 I/O를 처리하며 문서 속성에 대한 접근을 제공합니다.

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)

첫 번째 워크시트를 GitHub 스타일 Markdown 표로 내보냅니다.

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] -> Worksheet0 기반 인덱스의 워크시트를 반환합니다. 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")

참고

 한국어