چگونه فایل‌ها را با 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 در پایتون، اطمینان حاصل کنید که پایتون 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 از بارگذاری فایل‌ها در فرمت‌های زیر پشتیبانی می‌کند.

FormatExtensionNotes
اکسل 2007–2019.xlsxفرمت استاندارد Office Open XML؛ از Workbook("file.xlsx") استفاده کنید
اکسل 97–2003.xlsپشتیبانی نمی‌شود. فایل‌های XLS/BIFF پشتیبانی نمی‌شوند.
CSV.csvمقادیر جدا شده با کاما؛ از load_csv_workbook("file.csv") استفاده کنید

موارد مرتبط

 فارسی