Aspose.Cells FOSS API Reference
Examples
Aspose.Cells FOSS is an open-source Python library for creating, reading, and modifying spreadsheet files without requiring Microsoft Excel. It supports XLSX and CSV formats for input, and adds Markdown export via save_as_markdown(). La bibliothèque est structurée autour d’un Workbook objet racine qui gère les feuilles de calcul, les styles, les graphiques et les entrées/sorties.
Le point d’entrée principal est Workbook. Chaque Workbook contient un ou plusieurs Worksheet objets accessibles via wb.worksheets[index]. Les cellules individuelles sont accessibles via le Cells collection en utilisant la notation A1 ou des indices de ligne/colonne basés sur zéro.
from aspose.cells_foss import Workbook
wb = Workbook()
ws = wb.worksheets[0]
ws.cells["A1"].value = "Revenue"
ws.cells["B2"].value = 42
wb.save("output.xlsx")Workbook et Worksheet
Examples Workbook classe est l’objet racine pour toutes les opérations de feuille de calcul. Elle gère le chargement et l’enregistrement des fichiers, ainsi que l’accès aux feuilles de calcul et aux propriétés du document.
from aspose.cells_foss import Workbook
wb = Workbook() # new workbook
wb = Workbook("input.xlsx") # open existing file
wb = Workbook("protected.xlsx", password="secret") # open encrypted file
ws = wb.worksheets[0] # first worksheet (0-based)
ws = wb.add_worksheet("Sheet2") # add a named worksheet
ws.cells["A1"].put_value("Hello") # write by A1 reference
ws.cells["A1"].value # read value (property, no parentheses)
ws.cells["A2"].formula = "=SUM(B1:B5)"
wb.save("output.xlsx") # save as XLSX
wb.save("output.csv") # auto-detects format from extension
wb.save_as_markdown("output.md") # export as Markdown table
wb.save("output.xlsx", password="secret") # save with AES encryptionExamples
Ajoutez des graphiques à une feuille de calcul en utilisant le add_* méthodes sur ws.charts. Chaque méthode prend quatre arguments positionnels : top_row, left_col, bottom_row, right_col. Accédez au graphique par indice pour définir son titre et ses séries de données.
from aspose.cells_foss import Workbook
wb = Workbook()
ws = wb.worksheets[0]
chart_idx = ws.charts.add_line(upper_left_row=0, upper_left_col=4,
lower_right_row=20, lower_right_col=12)
chart = ws.charts[chart_idx]
chart.title = "Monthly Sales"
chart.n_series.add("B2:B7", category_data="A2:A7", name="Sales")
# Other add methods: add_bar, add_pie, add_area, add_scatter,
# add_waterfall, add_combo, add_stock, add_surface, add_radar,
# add_treemap, add_sunburst, add_histogram, add_funnel,
# add_box_whisker, add_mapExamples
Ajoutez des formes de dessin et des zones de texte à une feuille de calcul en utilisant ws.shapes.
from aspose.cells_foss import Workbook
from aspose.cells_foss import MsoDrawingType, TextAlignmentType, TextAnchorType
wb = Workbook()
ws = wb.worksheets[0]
shape = ws.shapes.add(MsoDrawingType.ROUNDED_RECTANGLE, 1, 1, 5, 5)
shape.text = "Hello"
shape.fill.fore_color = "90EE90"
shape.font.bold = True
shape.text_horizontal_alignment = TextAlignmentType.CENTER
shape.text_vertical_alignment = TextAnchorType.MIDDLE
textbox = ws.shapes.add_text_box(7, 1, 11, 8)
textbox.text = "Notes"Valeurs des cellules et styles
Lisez et écrivez les valeurs des cellules en utilisant le .value propriété. Modifiez le formatage en accédant à cell.style directement.
from aspose.cells_foss import Workbook
workbook = Workbook()
worksheet = workbook.worksheets[0]
# Write values
worksheet.cells["A1"].value = "Hello"
worksheet.cells["B1"].value = "World"
worksheet.cells["A2"].value = 42
worksheet.cells["B2"].value = 3.14
# Read a value
value = worksheet.cells["A1"].value
print(f"Cell A1 contains: {value}")
# Apply a style via the cell's style property
cell = worksheet.cells["A1"]
cell.style.font.bold = True
cell.style.font.size = 14
cell.style.font.color = "FF0000" # RRGGBB hex, no # prefix
cell.style.set_horizontal_alignment("center")
cell.style.set_number_format("#,##0.00")
cell.style.set_border("bottom", line_style="thin")
workbook.save("output.xlsx")Remarque : lors de la définition de font.color, utilisez une chaîne hexadécimale sans le # préfixe (par ex., "FF0000" pour le rouge).
Validation des données
Ajoutez une liste déroulante ou d’autres règles de validation à une plage de cellules en utilisant ws.data_validations.
from aspose.cells_foss import Workbook, DataValidationType
workbook = Workbook()
worksheet = workbook.worksheets[0]
validation = worksheet.data_validations.add("A1:A10")
validation.type = DataValidationType.LIST
validation.formula1 = '"Option1,Option2,Option3"'
workbook.save("validation.xlsx")Examples
Enregistrez ou ouvrez des classeurs protégés par mot de passe :
from aspose.cells_foss import Workbook
workbook = Workbook()
worksheet = workbook.worksheets[0]
worksheet.cells["A1"].value = "Confidential Data"
# Save with password protection
workbook.save("protected.xlsx", password="mypassword")
# Open a password-protected file
workbook2 = Workbook("protected.xlsx", password="mypassword")API publique
Examples Cells la classe fournit un accès aux cellules individuelles en utilisant la notation de style A1 (p. ex., "A1") ou des indices de tuple ligne/colonne à base 1. La Cell classe représente une cellule unique et expose value, formula, et style comme propriétés en lecture/écriture. La fusion et la séparation des cellules sont prises en charge via merge() et unmerge() méthodes sur Cells.
from aspose.cells_foss import Workbook
workbook = Workbook()
worksheet = workbook.worksheets[0]
worksheet.cells["A1"].value = "Hello"
worksheet.cells["B1"].value = "World" # A1 notation preferred
workbook.save("output.xlsx")| Examples | Examples | Examples |
|---|---|---|
Workbook | l’objet workbook | Objet racine du workbook |
Worksheet | feuille de calcul | Feuille de calcul unique avec cellules, graphiques, formes |
Cells | cellules | Collection de cellules avec A1 et accès basé sur 1 (ligne, colonne) |
Cell | cellule | Cellule unique : valeur, formule, style |
Style | style | Mise en forme de la cellule : police, remplissage, bordures, alignement |
Chart | graphique | Graphique intégré |
DataValidation | validation de données | Règle de validation de plage de cellules |
CSVHandler | csv-handler | Import/export CSV |
MarkdownHandler | markdown-handler | Export Markdown |
JsonHandler | json-handler | Export JSON |
Shape | forme | Dessiner une forme ou une zone de texte |
Table | tableau | Tableau structuré Excel |
SparklineGroup | sparkline | Graphiques Sparkline |
HorizontalPageBreakCollection | page-break | Sauts de page manuels |
AgileEncryptionParameters | chiffrement | Paramètres de chiffrement AES |
SaveFormat | classeur | Enum des formats de sortie |
Modèles courants
# Styling a cell
cell = ws.cells["A1"]
cell.style.font.bold = True
cell.style.font.size = 14
cell.style.font.color = "FF0000" # red (RRGGBB, no #)
cell.style.set_horizontal_alignment("center")
cell.style.set_number_format("#,##0.00")
cell.style.set_border("bottom", line_style="thin")# Add a dropdown validation
from aspose.cells_foss import DataValidationType
dv = ws.data_validations.add("B1:B10")
dv.type = DataValidationType.LIST
dv.formula1 = '"Red,Green,Blue"'
dv.show_dropdown = True