Este artículo explorará la biblioteca IronXL para demostrar cómo abrir un archivo de Microsoft Excel y escribir datos en él en una aplicación de consola C#.

IronXL - Una biblioteca de Excel

IronXL es una biblioteca de Excel for .NET que facilita la creación, lectura y edición de archivos Excel en aplicaciones C#. Ofrece un rendimiento excepcional y una salida precisa. La biblioteca admite todos los formatos de archivos de libro de trabajo de Excel, incluidos XLS, XLSX, XLSM, CSV y TSV. Además, permite guardar o exportar datos en formatos como JSON, HTML, Binary, Byte Array, DataSet o DataTable.

Con IronXL, los desarrolladores pueden trabajar con hojas de cálculo y rangos de celdas sin problemas. Ofrece la capacidad de editar fórmulas y recalcularlas fácilmente dentro de una hoja. Ordenar datos basado en rango, columna o fila es sencillo. La biblioteca proporciona funciones para modificar diseños, como congelar paneles, ajustar automáticamente filas/columnas, y agregar/eliminar filas/columnas.

IronXL también permite la protección de archivos Excel con contraseñas de usuario y permisos para editar. Otra característica notable es la capacidad de agregar, eliminar y extraer imágenes de hojas de cálculo de Excel. La biblioteca ofrece una amplia gama de funciones de Excel, admitiendo varios formatos de datos de celda. Estas características hacen de IronXL una de las APIs más amigables para trabajar con Excel.

Una de las ventajas significativas de IronXL es que no requiere que Microsoft Excel esté instalado en la máquina, eliminando la necesidad de Interop de Office o cualquier otra dependencia. Es compatible con múltiples plataformas y admite .NET 7, 6 y 5. También es compatible con .NET Core 2 y 3, así como con .NET Framework 4.5 y versiones posteriores para trabajar con hojas de cálculo de Excel.

Crear una aplicación de consola

Se recomienda la última versión de Visual Studio IDE para crear la aplicación. Visual Studio es el IDE oficial para el desarrollo en C#, y se asume que ya lo ha instalado. Si no ha instalado Visual Studio, puede descargarlo desde el sitio web oficial de Microsoft Visual Studio.

Siga estos pasos para crear un nuevo proyecto llamado "DemoApp".

1. Abra Visual Studio y haga clic en Crear un nuevo proyecto

Nuevo Proyecto

2. Seleccione Aplicación de consola y haga clic en Siguiente

Tipo de nuevo proyecto

3. Ingrese el nombre del Proyecto

Nombre del nuevo proyecto

4. Selecciona la versión de .NET. Elige la versión estable .NET 6.0.

Información adicional del nuevo proyecto

Instalar la biblioteca IronXL

Una vez creado el proyecto, se necesita instalar la biblioteca IronXL en el proyecto para usarla. Sigue estos pasos para instalarla.

1. Abra Administrar paquetes NuGet para soluciones ya sea desde el Explorador de soluciones o Herramientas.

Administrador de Paquetes NuGet

2. Busque la Biblioteca IronXL y seleccione el proyecto actual. Haz clic en instalar.

Buscar e instalar el paquete IronXL en la interfaz de usuario del administrador de paquetes NuGet

Agregue el siguiente espacio de nombres en la parte superior del archivo Program.cs

using IronXL;

using IronXL;

Imports IronXL

Imports IronXL

Open an Existing Excel File in C#

IronXL proporciona la facilidad de abrir un archivo Excel existente o puede crear un nuevo archivo Excel. Este ejemplo abrirá un archivo existente usando C# IronXL.

// Supported spreadsheet formats for reading XLSX, XLS, XLSM, XLTX, CSV and TSV
WorkBook workBook = WorkBook.Load("sample.xlsx");

// Supported spreadsheet formats for reading XLSX, XLS, XLSM, XLTX, CSV and TSV
WorkBook workBook = WorkBook.Load("sample.xlsx");

' Supported spreadsheet formats for reading XLSX, XLS, XLSM, XLTX, CSV and TSV
Dim workBook As WorkBook = WorkBook.Load("sample.xlsx")

' Supported spreadsheet formats for reading XLSX, XLS, XLSM, XLTX, CSV and TSV
Dim workBook As WorkBook = WorkBook.Load("sample.xlsx")

Ahora, seleccionemos su primera hoja de cálculo. Puede seleccionar una hoja de cálculo por número de índice o por nombre. La propiedad DefaultWorkSheet puede ayudar a obtener la primera hoja.

// Select worksheet at index 0
WorkSheet workSheet = workBook.WorkSheets[0];

// Select worksheet by name 
WorkSheet ws = workBook.GetWorkSheet("Sheet1"); 

// Get any existing worksheet
WorkSheet firstSheet = workBook.DefaultWorkSheet;

// Select worksheet at index 0
WorkSheet workSheet = workBook.WorkSheets[0];

// Select worksheet by name 
WorkSheet ws = workBook.GetWorkSheet("Sheet1"); 

// Get any existing worksheet
WorkSheet firstSheet = workBook.DefaultWorkSheet;

' Select worksheet at index 0
Dim workSheet As WorkSheet = workBook.WorkSheets(0)

' Select worksheet by name 
Dim ws As WorkSheet = workBook.GetWorkSheet("Sheet1")

' Get any existing worksheet
Dim firstSheet As WorkSheet = workBook.DefaultWorkSheet

' Select worksheet at index 0
Dim workSheet As WorkSheet = workBook.WorkSheets(0)

' Select worksheet by name 
Dim ws As WorkSheet = workBook.GetWorkSheet("Sheet1")

' Get any existing worksheet
Dim firstSheet As WorkSheet = workBook.DefaultWorkSheet

El código anterior obtiene la primera hoja del libro de trabajo de Excel. Para crear un nuevo archivo Excel con datos, consulte esta página de ejemplo de código.

Ahora, escribamos datos en el archivo Excel usando la biblioteca de objetos IronXL.

Write Data to Excel File in C#

Escribir datos en un archivo Excel utilizando IronXL es muy fácil. Hay múltiples formas de lograrlo, pero el método más simple es usar la referencia de celda de Excel.

// Access A1 cell and write the value
workSheet["A1"].Value = "Value using cell reference";

// Access A1 cell and write the value
workSheet["A1"].Value = "Value using cell reference";

' Access A1 cell and write the value
workSheet("A1").Value = "Value using cell reference"

' Access A1 cell and write the value
workSheet("A1").Value = "Value using cell reference"

También es posible escribir datos en un rango de celdas. El siguiente código escribe datos desde la celda B1 a B5.

// Write the same value to cells from B1 to B5
workSheet["B1:B5"].Value = "Range value";

// Write the same value to cells from B1 to B5
workSheet["B1:B5"].Value = "Range value";

' Write the same value to cells from B1 to B5
workSheet("B1:B5").Value = "Range value"

' Write the same value to cells from B1 to B5
workSheet("B1:B5").Value = "Range value"

También podemos completar el rango con un bucle for, haciéndolo dinámico. El código es el siguiente:

// Specify range in which we want to write the values
for (int i = 1; i <= 5; i++)
{
    // Write the Dynamic value in column C
    workSheet["C" + i].Value = "Value: " + i;

    // Write the Dynamic value in column D
    workSheet["D" + i].Value = "Value: " + i;
}

// Specify range in which we want to write the values
for (int i = 1; i <= 5; i++)
{
    // Write the Dynamic value in column C
    workSheet["C" + i].Value = "Value: " + i;

    // Write the Dynamic value in column D
    workSheet["D" + i].Value = "Value: " + i;
}

' Specify range in which we want to write the values
For i As Integer = 1 To 5
	' Write the Dynamic value in column C
	workSheet("C" & i).Value = "Value: " & i

	' Write the Dynamic value in column D
	workSheet("D" & i).Value = "Value: " & i
Next i

' Specify range in which we want to write the values
For i As Integer = 1 To 5
	' Write the Dynamic value in column C
	workSheet("C" & i).Value = "Value: " & i

	' Write the Dynamic value in column D
	workSheet("D" & i).Value = "Value: " & i
Next i

Otra forma de escribir datos en un archivo de Excel es utilizando el método Replace.

// Replace the value in cell D5
workSheet["D5"].Replace("Value: 5", "Replaced Value");

// Replace the value in cell D5
workSheet["D5"].Replace("Value: 5", "Replaced Value");

' Replace the value in cell D5
workSheet("D5").Replace("Value: 5", "Replaced Value")

' Replace the value in cell D5
workSheet("D5").Replace("Value: 5", "Replaced Value")

Save an Excel File in C#

Esta sección explica cómo guardar el archivo Excel con el contenido recién escrito en él.

// Save the updated Excel workbook to a file
workBook.SaveAs("sample.xlsx");

// Save the updated Excel workbook to a file
workBook.SaveAs("sample.xlsx");

' Save the updated Excel workbook to a file
workBook.SaveAs("sample.xlsx")

' Save the updated Excel workbook to a file
workBook.SaveAs("sample.xlsx")

El código completo es el siguiente:

using System;
using IronXL;

class Program
{
    static void Main(string[] args)
    {
        // Supported spreadsheet formats for reading XLSX, XLS, XLSM, XLTX, CSV and TSV
        WorkBook workBook = WorkBook.Load("sample.xlsx");

        // Select worksheet at index 0
        WorkSheet workSheet = workBook.WorkSheets[0];

        // Access A1 cell and write the value
        workSheet["A1"].Value = "Value using cell reference";

        // Write the same value to cells from B1 to B5
        workSheet["B1:B5"].Value = "Range value";

        // Specify range in which we want to write the values
        for (int i = 1; i <= 5; i++)
        {
            // Write the Dynamic value in column C
            workSheet["C" + i].Value = "Value: " + i;

            // Write the Dynamic value in column D
            workSheet["D" + i].Value = "Value: " + i;
        }

        // Replace the value in cell D5
        workSheet["D5"].Replace("Value: 5", "Replaced Value");

        // Save the updated Excel workbook to a file
        workBook.SaveAs("sample.xlsx");
        Console.WriteLine("Successfully written to Excel File");
    }
}

using System;
using IronXL;

class Program
{
    static void Main(string[] args)
    {
        // Supported spreadsheet formats for reading XLSX, XLS, XLSM, XLTX, CSV and TSV
        WorkBook workBook = WorkBook.Load("sample.xlsx");

        // Select worksheet at index 0
        WorkSheet workSheet = workBook.WorkSheets[0];

        // Access A1 cell and write the value
        workSheet["A1"].Value = "Value using cell reference";

        // Write the same value to cells from B1 to B5
        workSheet["B1:B5"].Value = "Range value";

        // Specify range in which we want to write the values
        for (int i = 1; i <= 5; i++)
        {
            // Write the Dynamic value in column C
            workSheet["C" + i].Value = "Value: " + i;

            // Write the Dynamic value in column D
            workSheet["D" + i].Value = "Value: " + i;
        }

        // Replace the value in cell D5
        workSheet["D5"].Replace("Value: 5", "Replaced Value");

        // Save the updated Excel workbook to a file
        workBook.SaveAs("sample.xlsx");
        Console.WriteLine("Successfully written to Excel File");
    }
}

Imports System
Imports IronXL

Friend Class Program
	Shared Sub Main(ByVal args() As String)
		' Supported spreadsheet formats for reading XLSX, XLS, XLSM, XLTX, CSV and TSV
		Dim workBook As WorkBook = WorkBook.Load("sample.xlsx")

		' Select worksheet at index 0
		Dim workSheet As WorkSheet = workBook.WorkSheets(0)

		' Access A1 cell and write the value
		workSheet("A1").Value = "Value using cell reference"

		' Write the same value to cells from B1 to B5
		workSheet("B1:B5").Value = "Range value"

		' Specify range in which we want to write the values
		For i As Integer = 1 To 5
			' Write the Dynamic value in column C
			workSheet("C" & i).Value = "Value: " & i

			' Write the Dynamic value in column D
			workSheet("D" & i).Value = "Value: " & i
		Next i

		' Replace the value in cell D5
		workSheet("D5").Replace("Value: 5", "Replaced Value")

		' Save the updated Excel workbook to a file
		workBook.SaveAs("sample.xlsx")
		Console.WriteLine("Successfully written to Excel File")
	End Sub
End Class

Imports System
Imports IronXL

Friend Class Program
	Shared Sub Main(ByVal args() As String)
		' Supported spreadsheet formats for reading XLSX, XLS, XLSM, XLTX, CSV and TSV
		Dim workBook As WorkBook = WorkBook.Load("sample.xlsx")

		' Select worksheet at index 0
		Dim workSheet As WorkSheet = workBook.WorkSheets(0)

		' Access A1 cell and write the value
		workSheet("A1").Value = "Value using cell reference"

		' Write the same value to cells from B1 to B5
		workSheet("B1:B5").Value = "Range value"

		' Specify range in which we want to write the values
		For i As Integer = 1 To 5
			' Write the Dynamic value in column C
			workSheet("C" & i).Value = "Value: " & i

			' Write the Dynamic value in column D
			workSheet("D" & i).Value = "Value: " & i
		Next i

		' Replace the value in cell D5
		workSheet("D5").Replace("Value: 5", "Replaced Value")

		' Save the updated Excel workbook to a file
		workBook.SaveAs("sample.xlsx")
		Console.WriteLine("Successfully written to Excel File")
	End Sub
End Class

Para obtener información más detallada sobre cómo leer datos de archivos Excel en C#, eche un vistazo a este ejemplo.

Producción

La salida del archivo es:

El archivo Excel de salida

Resumen

Este artículo demostró cómo escribir datos en archivos Excel en C# usando IronXL. IronXL proporciona la facilidad de trabajar con archivos Excel existentes sin ningún problema. También le permite crear nuevos archivos Excel y escribir datos en él con una sintaxis sencilla. IronXL también se puede usar para leer archivos Excel sin tener instalada la aplicación Microsoft Excel. Para leer datos de archivos Excel puede ver esta página de ejemplo de código.

IronXL es gratuito para el desarrollo y se puede licenciar para uso comercial. También puede probar la prueba gratuita de IronXL para uso comercial.