עבודה עם תאים
סקירה כללית
כל גיליון עבודה חושף cells אוסף שממפה מחרוזות כתובת בסגנון Excel (כגון "A1", "B3") Cell אובייקטים. אתה ניגש לתא ישירות באמצעות אינדקס:
from aspose.cells_foss import Workbook, Cell
workbook = Workbook()
ws = workbook.worksheets[0]
##Access a cell by address
cell = ws.cells["A1"]ערכים, נוסחאות ומידע עיצובי מתגוררים כולם על ה Cell אובייקט. אתה יכול או לשנות תא במקום על‑ידי כתיבה לתוך .value או .formula property, או להחליף את התא לחלוטין על‑ידי הקצאת חדשה Cell מופע לכתובת.
קריאה וכתיבת ערכים
הקצה ל cell.value לכתוב מחרוזת, מספר שלם או מספר עשרוני. קרא את אותו property בחזרה כדי לאחזר כל מה שנשמר.
from aspose.cells_foss import Workbook
workbook = Workbook()
ws = workbook.worksheets[0]
##Write a string
ws.cells["A1"].value = "Hello, world"
##Write an integer
ws.cells["A2"].value = 42
##Write a float
ws.cells["A3"].value = 3.14159
##Read values back
print(ws.cells["A1"].value) # Hello, world
print(ws.cells["A2"].value) # 42
print(ws.cells["A3"].value) # 3.14159
workbook.save("values_demo.xlsx")ה .value המאפיין מקבל כל סקלר Python. הספרייה מאחסנת את סוג Python כפי שהוא; אין המרה מרומזת שמתרחשת בזמן כתיבה.
שימוש בבונה Cell
ה Cell הקונסטרקטור מאפשר לך ליצור תא עם ערך (ואופציונלית נוסחה) בביטוי יחיד. הקצה את האובייקט המתקבל Cell האובייקט אל תת‑הסקריפט של הכתובת כדי למקם אותו בגיליון.
from aspose.cells_foss import Workbook, Cell
workbook = Workbook()
ws = workbook.worksheets[0]
##Integer cell
ws.cells["A1"] = Cell(42)
##String cell
ws.cells["A2"] = Cell("Revenue")
##Float cell
ws.cells["A3"] = Cell(3.14)
##Explicitly empty cell (no value, no formula)
ws.cells["A4"] = Cell(None)
workbook.save("cell_constructor_demo.xlsx")הארגומנט המיקומי הראשון של Cell הוא הערך. כאשר אתה מעביר None ה התא נשמר ללא ערך, מה שיכול להיות שימושי כאשר אתה מתכוון להגדיר נוסחה בנפרד או רוצה תא ריק במפורש במקום תא חסר.
תאים עם נוסחה
תא עם נוסחה מאחסן מחרוזת ביטוי תואמת Excel לצד (או במקום) ערך סטטי. ישנן שתי דרכים ליצור אחד.
דרך הבונה Cell — העבר None כערך ואת מחרוזת הנוסחה כארגומנט השני:
from aspose.cells_foss import Workbook, Cell
workbook = Workbook()
ws = workbook.worksheets[0]
ws.cells["A1"] = Cell(10)
ws.cells["A2"] = Cell(20)
ws.cells["A3"] = Cell(30)
##Formula via constructor: value=None, formula="=SUM(A1:A3)"
ws.cells["A4"] = Cell(None, "=SUM(A1:A3)")
workbook.save("formula_constructor.xlsx")באמצעות .formula מאפיין — קבע את המאפיין בתא קיים:
from aspose.cells_foss import Workbook, Cell
workbook = Workbook()
ws = workbook.worksheets[0]
for i, v in enumerate([5, 10, 15, 20, 25], start=1):
ws.cells[f"A{i}"].value = v
ws.cells["B1"].formula = "=AVERAGE(A1:A5)"
workbook.save("formula_property.xlsx")הפניה מהירה לנוסחאות נפוצות
| מטרה | מחרוזת נוסחה |
|---|---|
| סכם טווח | =SUM(A1:A10) |
| ממוצע של טווח | =AVERAGE(A1:A10) |
| ערך מרבי | =MAX(A1:A10) |
| ערך מינימלי | =MIN(A1:A10) |
| ספירת ערכים לא ריקים | =COUNT(A1:A10) |
| ערך מותנה | =IF(A1>0,"Positive","Non-positive") |
| איתור ערך | =VLOOKUP(D1,A1:B10,2,FALSE) |
| צירוף מחרוזות | =CONCATENATE(A1," ",B1) |
מחרוזות נוסחה חייבות להתחיל ב =. הספרייה מאחסנת אותן במדויק; Excel (או קורא תואם) מעריך את הביטוי כאשר הקובץ נפתח.
איטרציה על נתונים
השתמש בלולאת Python סטנדרטית כדי למלא עמודה או שורה מרשימה:
from aspose.cells_foss import Workbook
workbook = Workbook()
ws = workbook.worksheets[0]
monthly_sales = [12_500, 14_200, 9_800, 17_600, 21_100, 18_400]
##Write a header
ws.cells["A1"].value = "Monthly Sales"
##Write data starting at row 2 (index 1 → address A2)
for i, val in enumerate(monthly_sales, start=2):
ws.cells[f"A{i}"].value = val
##Write a SUM formula below the data
last_row = 1 + len(monthly_sales) # row index of last data cell
ws.cells[f"A{last_row + 1}"].formula = f"=SUM(A2:A{last_row})"
workbook.save("monthly_sales.xlsx")ה enumerate(iterable, start=N) התבנית ממפה בצורה חלקה למספרי השורות של Excel מכיוון שהשורות ב‑Excel הן מבוססות על 1. מתחילים ב start=2 שומרת על שורה 1 עבור כותרת.
סוגי ערכים מעורבים
הדוגמה המלאה שלהלן בונה מערך נתונים קטן עם שורת כותרת טקסטואלית, שלוש שורות נתונים המכילות שלמים, מספרים עשרוניים ומחרוזות, ושורת נוסחה שמסכמת את העמודות המספריות.
from aspose.cells_foss import Workbook, Cell
workbook = Workbook()
ws = workbook.worksheets[0]
##--- Header row ---
ws.cells["A1"].value = "Product"
ws.cells["B1"].value = "Units Sold"
ws.cells["C1"].value = "Unit Price"
ws.cells["D1"].value = "Revenue"
##--- Data rows ---
##Row 2
ws.cells["A2"] = Cell("Widget A")
ws.cells["B2"] = Cell(120)
ws.cells["C2"] = Cell(9.99)
ws.cells["D2"] = Cell(None, "=B2*C2")
##Row 3
ws.cells["A3"] = Cell("Widget B")
ws.cells["B3"] = Cell(85)
ws.cells["C3"] = Cell(14.50)
ws.cells["D3"] = Cell(None, "=B3*C3")
##Row 4
ws.cells["A4"] = Cell("Widget C")
ws.cells["B4"] = Cell(200)
ws.cells["C4"] = Cell(4.75)
ws.cells["D4"] = Cell(None, "=B4*C4")
##--- Summary row ---
ws.cells["A5"].value = "TOTAL"
ws.cells["B5"] = Cell(None, "=SUM(B2:B4)")
ws.cells["D5"] = Cell(None, "=SUM(D2:D4)")
workbook.save("mixed_types_dataset.xlsx")
print("Saved mixed_types_dataset.xlsx")לאחר פתיחת הקובץ ב‑Excel (או בכל יישום גיליון אלקטרוני תואם), ה D העמודה וה B5 / D5 התאים יציגו את התוצאות המוערכות של ביטויי הנוסחה.
טיפים
None ערך מול מחרוזת ריקה
Cell(None) ו ws.cells["A1"].value = None צור תא ללא ערך מאוחסן ערך — בלתי ניתן להבחנה מתא שמעולם לא נכתב ברוב הגליונות קוראים. Cell("") או ws.cells["A1"].value = "" צור תא שמציין במפורש מכיל מחרוזת ריקה, שלפיה קוראים מסוימים ונוסחאות מתייחסים באופן שונה (למשל, =COUNT מתעלם מתאי מחרוזת ריקה באותו האופן שבו הוא מתעלם מתאים ריקים תאים, אך =COUNTA סופר אותם).
מחרוזת נוסחה מול ערך סטטי
קריאה .value מתא נוסחה מחזירה None (או את הערך המוטמן האחרון אם אחד הוגדר לפני שהנוסחה הוקצתה). קריאה .formula מחזיר את מחרוזת הביטוי. אם אתה צריך להבדיל בין תא נוסחה ל תא ערך רגיל בזמן ריצה, בדוק האם ws.cells["A1"].formula אינו ריק:
cell = ws.cells["A1"]
if cell.formula:
print(f"Formula: {cell.formula}")
else:
print(f"Value: {cell.value}")ראה גם
- תיעוד API: תיעוד מלא של מחלקות ושיטות עבור
aspose.cells_foss - מאגר ידע: מדריכים מעשיים ממוקדי משימה
- סקירת מוצר: סיכום תכונות ויכולות
- התחלה / התקנה: pip install והגדרה
- בלוג: הצגת Aspose.Cells FOSS: סקירת ספרייה והתחלה מהירה