چگونه یک صفحه پخش را در Python بارگذاری کنیم
این راهنمای نشان می دهد که چگونه برای بارگذاری فایل های صفحه نمایش XLSX و CSV در Python با استفاده از Workbook,دسترسی به کارگاه ها با get_worksheet(),و ارزش های سلولی را از طریق Worksheet.cells کتابخانه در Python خالص بدون Microsoft Office یا افزونه های بومی اجرا می شود.
راهنمای گام به گام
مرحله اول: نصب بسته بندی
نصب بسته FOSS از PyPI با استفاده از دستور Pip زیر:
pip install aspose-cells-foss>=26.3.1بررسی نصب با واردات Workbook و پیام تأیید را ارسال کنید:
from aspose.cells_foss import Workbook
print("aspose-cells-foss is ready.")مرحله دوم: کلاس های مورد نیاز واردات
واردات به Workbook کلاس از aspose.cells_foss برای دسترسی به API بارگذاری صفحه پخش:
from aspose.cells_foss import Workbookمرحله 3: یک کتاب کار را از یک فایل دانلود کنید.
فایل را به خط مسیر منتقل کنید. Workbook() برای بارگذاری یک صفحه نمایش موجود. سازنده یک گزینه را می پذیرد. password برای فایل های محافظت شده:
wb = Workbook(“report.xlsx”) print(“Loaded:”, wb.file_path)
---
### مرحله چهارم: دسترسی به یک ورودی
استفاده از `get_worksheet()` با یک شاخص کامل (0-based) یا نوار نام ورق. استفاده از آن `worksheets` برای دیدن تعداد صفحات موجود در کتاب:
wb = Workbook("report.xlsx")
# By index
ws = wb.get_worksheet(0)
# By name
ws_named = wb.get_worksheet("Summary")
print(f"Worksheets: {len(wb.worksheets)}")
print(f"First sheet: {ws.name}")<button class=“hextra-code-copy-btn hx-group/copybtn hx-transition-all active:hx-opacity-50 hx-bg-primary-700/5 hx-border hx-border-black/5 hx-text-gray-600 hover:hx-text-gray-900 hx-rounded-md hx-p-1.5 dark:hx-bg-primary-300/10 dark:hx-border-white/10 dark:hx-text-gray-400 dark:hover:hx-text-gray-50” title=“کپی کد”
<div class="copy-icon group-[.copied]/copybtn:hx-hidden hx-pointer-events-none hx-h-4 hx-w-4"></div>
<div class="success-icon hx-hidden group-[.copied]/copybtn:hx-block hx-pointer-events-none hx-h-4 hx-w-4"></div>
مرحله پنجم: ارزش های سلولی را بخوانید
دسترسی به سلول ها از طریق Worksheet.cells مالکیت : استفاده از Cells.cell(row, col) به بازگشت به A Cell با توجه به خط صفر و هماهنگی های ستون.با خواندن داده ها با… در این Cell.value مالکیت : استفاده از Cell.is_empty() برای جلوگیری از سلول های سفید به صورت ایمن:
wb = Workbook(“report.xlsx”) ws = wb.get_worksheet(0) cells = ws.cells
Read individual cells
product = cells.cell(0, 0).value # row 0, col 0 (A1) revenue = cells.cell(0, 1).value # row 0, col 1 (B1)
print(f"Product: {product}") print(f"Revenue: {revenue}")
Safe read with empty check
cell = cells.cell(1, 0) if not cell.is_empty(): print(f"A2: {cell.value}")
---
### مرحله ششم: تمام چوب ها را بشویید.
استفاده از `Cells.iter_rows()` در هر خطی بدون دانستن ابعاد راه می رود. Pass `values_only=True` به جای دریافت ارزش های پایتون، `Cell` اشیاء :
wb = Workbook("report.xlsx")
ws = wb.get_worksheet(0)
for row in ws.cells.iter_rows(0, None, 0, None, values_only=True):
print(row)<button class=“hextra-code-copy-btn hx-group/copybtn hx-transition-all active:hx-opacity-50 hx-bg-primary-700/5 hx-border hx-border-black/5 hx-text-gray-600 hover:hx-text-gray-900 hx-rounded-md hx-p-1.5 dark:hx-bg-primary-300/10 dark:hx-border-white/10 dark:hx-text-gray-400 dark:hover:hx-text-gray-50” title=“کپی کد”
<div class="copy-icon group-[.copied]/copybtn:hx-hidden hx-pointer-events-none hx-h-4 hx-w-4"></div>
<div class="success-icon hx-hidden group-[.copied]/copybtn:hx-block hx-pointer-events-none hx-h-4 hx-w-4"></div>
مشکلات و اصلاحات مشترک
FileNotFoundError هنگامی که بارگذاری می شود بررسی کنید که مسیر درست است و فایل وجود دارد.استفاده از pathlib.Path برای حمل و نقل راه های : Workbook(str(Path("data") / "report.xlsx")).
Cell.value بازگشت None سلول خالی یا خارج از محدوده است.استفاده از Cell.is_empty() قبل از خواندن چک کنید value.هماهنگی های خارج از محدوده اشتباهات را ایجاد نمی کنند – آنها سلول های خالی را باز می گردانند.
فایل های محافظت شده با رمز عبور باعث ایجاد خطا می شوند. رمز عبور را به عنوان دومین استدلال وارد کنید: Workbook("protected.xlsx", "secret").
فقط اولین صفحه بارگذاری می شود هنگام خواندن یک CSV فایل های CSV شامل یک صفحه واحد است.استفاده از Workbook.load_csv(file_path) در یک موجود Workbook مثال اگر نیاز به وارد کردن داده های CSV به یک موقعیت صفحه خاص دارید. به جای خواندن از طریق Workbook() سازنده مستقیم است.
نام صفحه ای که با get_worksheet(name) نام های صفحه ای حساس به مورد هستند. چاپ ws.name برای هر شاخص در wb.worksheets به قبل از تماس با نام دقیق خود را تایید کنید. get_worksheet("Name").
پرسش های متداول
آیا این کار در لینوکس و مک اس انجام می شود؟?
بله . aspose-cells-foss Python خالص است و در ویندوز، macOS، لینوکس و Docker اجرا می شود. محموله ها بدون گسترش های بومی یا وابستگی های سیستم.
چه فرمت های فایل را می توانم بارگذاری کنم؟?
و این Workbook() سازنده از فایل های XLSX پشتیبانی می کند.فایلهای CSV را می توان با عبور یک .csv راه یا با تماس Workbook.load_csv(file_path) در A Workbook مثال .
چگونه آخرین ردیف را با داده ها پیدا کنیم؟?
با این کار با Cells.iter_rows() و زمانی که تمام ارزش ها در یک ردیف متوقف می شوند، None,یا استفاده از Cell.is_empty() در سلول های مرزی برای تشخیص جایی که داده ها به پایان می رسند.
آیا می توانم بدون اطلاع قبلی از فرمت آن کتاب را باز کنم؟?
مسیر فایل را به Workbook(file_path).کتابخانه به صورت فرمت از اگر این فایل یا صفحه ی دیگر از دست رفته باشد، یک گزینه ذخیره / بارگذاری است.
چگونه یک سلول را با آدرس نامه ای مانند “B3” بخوانیم؟?
استفاده از خط بر اساس صفر و کل ستون: B3 خط 2 است، col 1. با ord(col_letter) - ord("A") برای مثال در یک کلمه، به عنوان مثال:, B است ord("B") - ord("A") == 1,به همین دلیل cells.cell(2, 1) نقشه به B3 می باشد.
