چگونه فایلها را با 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 در پایتون، اطمینان حاصل کنید که پایتون 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 از بارگذاری فایلها در فرمتهای زیر پشتیبانی میکند.
| Format | Extension | Notes |
|---|---|---|
| اکسل 2007–2019 | .xlsx | فرمت استاندارد Office Open XML؛ از Workbook("file.xlsx") استفاده کنید |
| اکسل 97–2003 | .xls | پشتیبانی نمیشود. فایلهای XLS/BIFF پشتیبانی نمیشوند. |
| CSV | .csv | مقادیر جدا شده با کاما؛ از load_csv_workbook("file.csv") استفاده کنید |