سوالات متداول

سوالات متداول

سوالات متداول

چگونه Aspose.Cells FOSS را نصب کنم؟

آن را از PyPI با استفاده از pip نصب کنید:

pip install aspose-cells-foss>=26.3.1

پس از نصب، اطمینان حاصل کنید که کار می‌کند:

from aspose.cells_foss import Workbook
wb = Workbook()
print("Installation successful")

چگونه مقدار یک سلول را بخوانم؟

از ویژگی .value استفاده کنید؛ این یک ویژگی است، نه یک متد. پرانتز اضافه نکنید.

from aspose.cells_foss import Workbook

wb = Workbook("input.xlsx")
ws = wb.worksheets[0]

# Correct: .value is a property (no parentheses)
val = ws.cells["A1"].value
print(val)

# Also correct: access by row, column index (1-based)
val2 = ws.cells[1, 1].value
print(val2)

چگونه یک مقدار یا فرمول سلول را بنویسم؟

به‌صورت مستقیم به .value یا .formula اختصاص دهید. هر دو ویژگی هستند، نه متد.

from aspose.cells_foss import Workbook

wb = Workbook()
ws = wb.worksheets[0]

# Write a value
ws.cells["A1"].value = "Product"
ws.cells["B1"].value = 100

# Write a formula
ws.cells["C1"].formula = "=SUM(A1:B1)"

wb.save("output.xlsx")

به‌جای آن، از cells.get_cell_by_name(address).put_value(value) استفاده کنید وقتی که یک آدرس سلول رشته‌ای دارید:

ws.cells.get_cell_by_name("A1").put_value("Product")
ws.cells.get_cell_by_name("B1").put_value(100)

آیا Aspose.Cells FOSS از خروجی PDF پشتیبانی می‌کند؟

خیر. خروجی PDF در نسخه FOSS موجود نیست. فرمت‌های ذخیره‌سازی پشتیبانی‌شده عبارتند از:

  • XLSX: wb.save("output.xlsx")
  • CSV: wb.save("output.csv")
  • Markdown: wb.save_as_markdown("output.md")

چگونه یک فایل CSV را بارگذاری کنم؟

از تابع راحتی load_csv_workbook() استفاده کنید:

from aspose.cells_foss import load_csv_workbook

wb = load_csv_workbook("data.csv")
ws = wb.worksheets[0]
val = ws.cells["A1"].value

برای کنترل بیشتر، از CSVHandler با CSVLoadOptions استفاده کنید:

from aspose.cells_foss import Workbook, CSVHandler, CSVLoadOptions

opts = CSVLoadOptions()
wb = Workbook()
CSVHandler.load_csv(wb, "data.csv", opts)
ws = wb.worksheets[0]

چگونه یک نمودار اضافه کنم؟

از یکی از روش‌های add_* بر روی ws.charts استفاده کنید. هر روش آرگومان‌های موقعیتی برای جعبه مرزی نمودار می‌گیرد: top_row، left_col، bottom_row، right_col.

from aspose.cells_foss import Workbook

wb = Workbook()
ws = wb.worksheets[0]

# Add data
ws.cells["A1"].value = "Month"
ws.cells["B1"].value = "Sales"
ws.cells["A2"].value = "Jan"
ws.cells["B2"].value = 1200
ws.cells["A3"].value = "Feb"
ws.cells["B3"].value = 1500

# Add a bar chart (top_row, left_col, bottom_row, right_col)
chart = ws.charts.add_bar(5, 0, 20, 8)
chart.title = "Monthly Sales"
chart.n_series.add("B2:B3", is_vertical=True)

wb.save("output.xlsx")

چرا cell.value() یک TypeError ایجاد می‌کند؟

چون .value یک ویژگی است، نه یک متد. فراخوانی cell.value() سعی می‌کند مقدار بازگردانده شده را به عنوان یک تابع صدا بزند، که باعث TypeError می‌شود. همیشه از انتساب یا دسترسی مستقیم به ویژگی استفاده کنید:

# Wrong: raises TypeError
cell.value("Hello")
cell.formula("=SUM(A1:A5)")
val = cell.value()

# Correct
cell.value = "Hello"
cell.formula = "=SUM(A1:A5)"
val = cell.value

کدام فرمت‌های فایل می‌توانند بارگذاری شوند؟

FormatExtensionHow to load
Excel 2007–2019.xlsxWorkbook("file.xlsx")
Excel 97–2003.xlsپشتیبانی نمی‌شود. فقط فرمت XLSX برای خواندن و نوشتن پشتیبانی می‌شود. فایل‌های XLS/BIFF پشتیبانی نمی‌شوند.
CSV.csvload_csv_workbook("file.csv")

موارد مرتبط

Aspose.Cells FOSS تحت مجوز MIT License است. شرایط کامل مجوز را در فایل LICENSE مرور کنید. برای نصب و استفادهٔ پایه، به README و examples directory مراجعه کنید.

 فارسی