JsonHandler

JsonHandler — Aspose.Cells FOSS for Python API Reference

aspose-cells-foss می‌تواند داده‌های برگه کاری را به JSON از طریق JsonHandler کلاس. خروجی هر ردیف را به‌عنوان یک شیء JSON که با سرعنوان ستون کلید شده است، در یک آرایه جمع‌آوری می‌کند.

ColladaSaveOptions: aspose.cells_foss

from aspose.cells_foss import JsonHandler, JsonSaveOptions
from aspose.cells_foss import save_workbook_as_json

JsonSaveOptions

گزینه‌هایی که نحوه سریال‌سازی شیت به JSON را کنترل می‌کنند.

ColladaSaveOptions

JsonSaveOptions()

ColladaSaveOptions

JsonSaveOptions هیچ ویژگی قابل تنظیمی ندارد. یک نمونه را به JsonHandler.save_json() برای استفاده از رفتار پیش‌فرض سریال‌سازی.


JsonHandler

JsonHandler فقط شامل متدهای استاتیک است و هرگز نمونه‌سازی نمی‌شود.

JsonHandler.save_json

JsonHandler.save_json(workbook, file_path: str, options: JsonSaveOptions | None = None) -> None

اولین برگه کاری را به یک فایل JSON در file_path. اگر options است None,، پیش‌فرض JsonSaveOptions استفاده می‌شوند.

JsonHandler.save_json_to_dict

JsonHandler.save_json_to_dict(workbook, options: JsonSaveOptions | None = None) -> dict

کاربرگ را به یک Python سریال‌سازی می‌کند dict (یا list) و بدون نوشتن هیچ فایلی آن را برمی‌گرداند. برای پردازش پس از برنامه‌نویسی مفید است.


DataValidationType یک IntEnum است که نوع محدودیتی که باید اعمال شود را شناسایی می‌کند.

save_workbook_as_json

save_workbook_as_json(workbook, file_path: str, options: JsonSaveOptions | None = None) -> None

پوشش راحت برای JsonHandler.save_json(workbook, file_path, options).


ColladaSaveOptions

مثال زیر یک جدول فروش می‌نویسد و آن را با قالب‌بندی تاریخ ISO به یک فایل JSON صادر می‌کند.

from aspose.cells_foss import Workbook, JsonHandler, JsonSaveOptions
import datetime

wb = Workbook()
ws = wb.worksheets[0]
ws.name = "Sales"

# Header row
ws.cells["A1"].put_value("Date")
ws.cells["B1"].put_value("Product")
ws.cells["C1"].put_value("Amount")

# Data rows
ws.cells["A2"].put_value(datetime.date(2025, 1, 15))
ws.cells["B2"].put_value("Widget A")
ws.cells["C2"].put_value(1250.00)

ws.cells["A3"].put_value(datetime.date(2025, 1, 22))
ws.cells["B3"].put_value("Widget B")
ws.cells["C3"].put_value(840.50)

opts = JsonSaveOptions()

# Save to file
JsonHandler.save_json(wb, "sales.json", options=opts)

# Or retrieve as a Python dict
data = JsonHandler.save_json_to_dict(wb, options=opts)
print(data)

خروجی مثال (sales.json):

{
  "Sales": [
    {"Date": "2025-01-15", "Product": "Widget A", "Amount": 1250.0},
    {"Date": "2025-01-22", "Product": "Widget B", "Amount": 840.5}
  ]
}

همچنین ببینید

 فارسی