Introducción a IronXL for Python

Translated

View the article in English

IronXL for Python es una potente librería desarrollada por Iron Software, que ofrece a los ingenieros de software la capacidad de crear, leer y editar Excel(XLS, XLSX y CSV) en proyectos Python 3.

IronXL for Python no requiere que Excel esté instalado en su servidor o Interop. IronXL for Python proporciona una API más rápida e intuitiva que Microsoft.Office.Interop.Excel.

IronXL for Python se basa en el éxito y la popularidad de IronXL for .NET.

Instalar IronXL for Python

Requisitos previos

Para utilizar IronXL for Python, asegúrese de que el ordenador tiene instalado el siguiente software de requisitos previos:

.NET 6.0 SDK: IronXL for Python se basa en la biblioteca IronXL .NET, concretamente en .NET 6.0, como tecnología subyacente. Por lo tanto, es necesario.NET 6.0 SDK instalado en su máquina para poder utilizar IronXL for Python.
Python: Descargue e instale la última versión de Python 3.x desde el sitio web oficial de Python: https://www.python.org/downloads/
Durante el proceso de instalación, asegúrese de seleccionar la opción de añadir Python al PATH del sistema, lo que lo hará accesible desde la línea de comandos.
Pip: Pip suele venir incluido con la instalación de Python a partir de Python 3.4 y posteriores. Sin embargo, dependiendo de su instalación de Python, puede que tenga que comprobar si pip ya está instalado o instalarlo por separado.
Biblioteca IronXL: La biblioteca IronXL se puede agregar a través de pip. Utilice el siguiente comando para instalar IronXL usando pip:

 pip install IronXL

Consejos

Para instalar una versión específica de IronXL, utilice la siguiente sintaxis: "==2023.x.x". Por ejemplo, puedes ejecutar el comando "pip install IronXL==2023.x.x".

Atención

En algunos sistemas, Python 2.x puede seguir siendo la versión por defecto. En tales casos, puede que necesite utilizar explícitamente el comando pip3 en lugar de pip para asegurarse de que está utilizando Pip para Python 3.

Lectura de un documento Excel

Leer datos de un archivo Excel con IronXL for Python requiere unas pocas líneas de código.

:path=/static-assets/excel-python/content-code-examples/get-started/get-started-1.py

from ironxl import *

# Load existing spreadsheet
workbook = WorkBook.Load("sample.xlsx")
worksheet = workbook.WorkSheets[0]

# Select cells easily in Excel notation and return the calculated value, date, text, or formula
cell_value = worksheet["A2"].IntValue

# Read from ranges of cells elegantly
for cell in worksheet["A2:B10"]:
    print(f"Cell {cell.AddressString} has value '{cell.Text}'")

PYTHON

Creación de nuevos documentos Excel

Para crear documentos Excel en Python; IronXL for Python ofrece una interfaz sencilla y rápida.

:path=/static-assets/excel-python/content-code-examples/get-started/get-started-2.py

from ironxl import *

# Create a new Excel WorkBook document.
workbook = WorkBook.Create(ExcelFileFormat.XLSX)
workbook.Metadata.Author = "IronXL"

# Add a blank WorkSheet
worksheet = workbook.CreateWorkSheet("main_sheet")

# Add data and styles to the new worksheet
worksheet["A1"].Value = "Hello World"
worksheet["A2"].Style.BottomBorder.SetColor("#ff6600")
worksheet["A2"].Style.BottomBorder.Type = BorderType.Double  # Assuming BorderType is accessible directly

# Save the Excel file
workbook.SaveAs("NewExcelFile.xlsx")

PYTHON

Exportación como CSV, XLS, XLSX, JSON o XML

También podemos guardar o exportar como muchos formatos de archivo de hojas de cálculo estructuradas comunes.

:path=/static-assets/excel-python/content-code-examples/get-started/get-started-3.py

# Assuming workSheet is an existing instance of WorkSheet
workSheet.SaveAs("NewExcelFile.xls")
workSheet.SaveAs("NewExcelFile.xlsx")
workSheet.SaveAsCsv("NewExcelFile.csv")
workSheet.SaveAsJson("NewExcelFile.json")
workSheet.SaveAsXml("NewExcelFile.xml")

PYTHON

Estilización de celdas y rangos

Las celdas y rangos de Excel pueden estilizarse utilizando el objeto Estilo.

:path=/static-assets/excel-python/content-code-examples/get-started/get-started-4.py

# Set cell's value and styles
workSheet["A1"].Value = "Hello World"
workSheet["A2"].Style.BottomBorder.SetColor("#ff6600")
workSheet["A2"].Style.BottomBorder.Type = BorderType.Double

PYTHON

Rangos de clasificación

Usando un IronXL for Python podemos ordenar un rango de Celdas de Excel usando Range.

:path=/static-assets/excel-python/content-code-examples/get-started/get-started-5.py

from ironxl import *

# Load existing spreadsheet
workbook = WorkBook.Load("sample.xls")
worksheet = workbook.WorkSheets[0]

# This is how we get a range from an Excel worksheet
selected_range = worksheet["A2:A8"]

# Sort the range in the sheet
selected_range.SortAscending()

# Save changes with the sorted range
workbook.Save()

PYTHON

Edición de fórmulas

Editar una fórmula de Excel es tan fácil como asignar un valor con un signo igual = al principio. La fórmula se calculará en directo.

:path=/static-assets/excel-python/content-code-examples/get-started/get-started-6.py

# Set a formula
workSheet["A1"].Formula = "=SUM(A2:A10)"
# Get the calculated value
sum_ = workSheet["A1"].DecimalValue

PYTHON

¿Por qué elegir IronXL for Python?

IronXL for Python ofrece una API sencilla para que los desarrolladores lean y escriban documentos de Excel.

IronXL for Python no requiere la instalación de Microsoft Excel en su servidor o Excel Interop para acceder a los documentos de Excel. Esto hace que trabajar con archivos Excel en Python, sea una tarea muy rápida y sencilla.