كيفية تحميل الملفات باستخدام Aspose.Cells FOSS

كيفية تحميل الملفات باستخدام Aspose.Cells FOSS

مشكلة

حمّل ملفات جداول البيانات (XLSX, CSV) إلى Aspose.Cells FOSS للتلاعب البرمجي. تقبل الفئة Workbook مسار ملف وتعيد دفتر عمل في الذاكرة جاهز للقراءة أو التحرير.

from aspose.cells_foss import Workbook

# Load an XLSX file
workbook = Workbook("input.xlsx")
worksheet = workbook.worksheets[0]

المتطلبات المسبقة

لتحميل الملفات باستخدام Aspose.Cells FOSS في Python، تأكد من تثبيت Python 3.7 أو أحدث. قم بتثبيت المكتبة باستخدام pip بالأمر pip install aspose-cells-foss>=26.3.1. بعد التثبيت، استورد المكتبة باستخدام from aspose.cells_foss import Workbook.

  • Python 3.7 أو أحدث
  • مدير حزم pip
  • aspose-cells-foss>=26.3.1 مثبت عبر pip
  • فهم أساسي لمعالجة ملفات Python

جارٍ تحميل الملف

Aspose.Cells FOSS يقوم بتحميل بيانات الجداول من مسارات الملفات باستخدام الفئة Workbook. مرّر سلسلة مسار ملف محلي مباشرة إلى المُنشئ. تحميل التدفق (على سبيل المثال io.BytesIO) غير مدعوم — مرّر سلسلة مسار ملف فقط. لتحميل ملفات CSV، استخدم الدالة المريحة load_csv_workbook().

from aspose.cells_foss import Workbook

# Load from file path (XLSX only)
workbook = Workbook("data.xlsx")

عند تحميل ملفات CSV، استخدم الدالة load_csv_workbook() التي تنشئ وتعيد Workbook جديدًا مملوءًا ببيانات CSV.

مثال على الكود

يوضح هذا المثال تحميل ملف XLSX وملف CSV، ثم قراءة قيمة خلية من كل منهما.

from aspose.cells_foss import Workbook, load_csv_workbook

# Load an XLSX workbook from a file path
workbook = Workbook("input.xlsx")
worksheet = workbook.worksheets[0]

# Read a cell value using the .value property
val = worksheet.cells["A1"].value
print(f"A1 value: {val}")

# Load a CSV file using load_csv_workbook
csv_workbook = load_csv_workbook("data.csv")
csv_worksheet = csv_workbook.worksheets[0]

# Read from the CSV-sourced workbook
csv_val = csv_worksheet.cells["A1"].value
print(f"CSV A1 value: {csv_val}")

الصيغ المدعومة

يدعم Aspose.Cells FOSS تحميل الملفات بالتنسيقات التالية.

الصيغةالامتدادالملاحظات
Excel 2008–2019.xlsxتنسيق Office Open XML القياسي؛ استخدم Workbook("file.xlsx")
Excel 97–2003.xlsغير مدعوم. ملفات XLS/BIFF غير مدعومة.
CSV.csvقيم مفصولة بفواصل؛ استخدم load_csv_workbook("file.csv")

انظر أيضًا

 العربية