الأسئلة المتكررة

الأسئلة المتكررة

الأسئلة المتكررة

كيف أقوم بتثبيت 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. للتثبيت والاستخدام الأساسي، انظر إلى README ودليل الأمثلة.

 العربية