USO DE IRONXL

Cómo crear un nuevo libro de Excel en C#

Actualizado 29 de abril, 2024
Compartir:

Microsoft Excel es una de las herramientas más universales para la manipulación y el análisis de datos en diversos sectores. En muchos proyectos de software, suele ser necesario utilizar archivos Excel mediante programación. Esto podría implicar tareas como la generación de informes, la gestión de importaciones o exportaciones de datos, o la automatización de procesos específicos.

En el ecosistema del lenguaje de programación C#, IronXL destaca como una robusta biblioteca para la manipulación de archivos Excel. Tanto si es un desarrollador que trabaja en una aplicación web, un software de escritorio o cualquier otro proyecto en C#, IronXL proporciona una interfaz fácil de usar para trabajar con archivos Excel sin problemas.

Cómo crear un nuevo libro de Excel en C#

En este tutorial, aprenderemos el proceso de creación de un nuevo libro de trabajo utilizando IronXL en C#. Recorreremos los pasos necesarios, desde la configuración del entorno de desarrollo hasta la escritura del código que genera un nuevo libro de Excel.

Al final de este tutorial, usted tendrá una sólida comprensión de cómo aprovechar IronXL para crear libros de Excel mediante programación, lo que le permite integrar la funcionalidad de Excel en sus aplicaciones C# con facilidad. Comencemos!

¿Qué es IronXL?

IronXL es una biblioteca C# versátil que le permite trabajar con documentos Excel sin necesidad de Microsoft Office Excel Interop o cualquier aplicación Excel. Le permite leer, crear y modificar libros de trabajo, formatear celdas, añadir fórmulas y trabajar con formatos de archivo de Excel tanto modernos como antiguos.

Puede validar datos, insertar imágenes, aplicar formato condicional y crear gráficos sin necesidad de Microsoft Office. Los desarrolladores pueden crear soluciones de Excel para tareas como informes financieros, paneles de datos y gestión de inventarios con facilidad utilizando IronXL.

Empecemos creando un archivo Excel en C#.

Paso 1: Crear un nuevo proyecto C&num

Abra Visual Studio y cree un nuevo proyecto de aplicación de consola C#. Ponle el nombre que prefieras. También puedes crear otros tipos de Proyectos como ASP.NET MVC, Blazor, MAUI, WEB Forms, Windows Forms, WEB API, etc. Este código funcionará con todos los tipos de proyectos. Estoy creando una aplicación de consola para simplificar y hacerlo relevante para todos los tipos de proyectos.

Paso 2: Instalar el paquete NuGet de IronXL

Para instalar el IronXL en su proyecto C#, puede utilizar cualquiera de las siguientes formas:

  1. Para instalar IronXL, haga clic con el botón derecho en su proyecto en el Explorador de soluciones, seleccione "Administrar paquetes NuGet", busque IronXL y proceda con la instalación.

    Cómo crear un nuevo libro de Excel en C #: Figura 1 - Instale IronXL utilizando el Gestor de Paquetes NuGet para Solución buscando "IronXL" en la barra de búsqueda del Gestor de Paquetes NuGet, luego seleccione el proyecto y haga clic en el botón Instalar.

  1. Alternativamente, puede instalar IronXL a través de la Consola del Gestor de Paquetes utilizando el siguiente comando:
Install-Package IronXL.Excel

Este comando descargará, instalará y añadirá la referencia del ensamblado a nuestro proyecto. Espere a que el paquete se descargue e instale. Una vez finalizada la instalación, puede empezar a utilizar IronXL en su proyecto para trabajar con archivos Excel mediante programación.

Cómo Crear un Nuevo Libro de Excel en C#: Figura 2 - Instale IronXL usando el comando Package Manager Console: Install-Package IronXL.Excel

Paso 3: Importar el espacio de nombres necesario

En la parte superior de su archivo C#, añada el siguiente espacio de nombres:

using IronXL;
using IronXL;
Imports IronXL
VB   C#

Paso 4: Crear un nuevo archivo Excel

Ahora, vamos a escribir el código para crear el archivo Excel:

internal class Program
{
    static void Main(string [] args)
    {
    //  Crear un nuevo libro de trabajo XLSX
        WorkBook workBook = WorkBook.Create(ExcelFileFormat.XLSX); 
        workBook.Metadata.Author = "Mr. Author"; //  Establecer el autor (opcional)
        //  Añadir una hoja de cálculo en blanco
        WorkSheet workSheet = workBook.CreateWorkSheet("Sheet1"); 
        //  Añadir datos a la nueva hoja de cálculo
        workSheet ["A1"].Value = "Developer Name";
        workSheet ["A2"].Value = "John Grahm";
        workSheet ["A3"].Value = "David Smith";
        workSheet ["A4"].Value = "Rishi Kelkar";
        //  Guardar el archivo excel como XLS, XLSX, CSV, TSV, JSON, XML, HTML y secuencias
        workBook.SaveAs("Developers.xlsx");
    }
}
internal class Program
{
    static void Main(string [] args)
    {
    //  Crear un nuevo libro de trabajo XLSX
        WorkBook workBook = WorkBook.Create(ExcelFileFormat.XLSX); 
        workBook.Metadata.Author = "Mr. Author"; //  Establecer el autor (opcional)
        //  Añadir una hoja de cálculo en blanco
        WorkSheet workSheet = workBook.CreateWorkSheet("Sheet1"); 
        //  Añadir datos a la nueva hoja de cálculo
        workSheet ["A1"].Value = "Developer Name";
        workSheet ["A2"].Value = "John Grahm";
        workSheet ["A3"].Value = "David Smith";
        workSheet ["A4"].Value = "Rishi Kelkar";
        //  Guardar el archivo excel como XLS, XLSX, CSV, TSV, JSON, XML, HTML y secuencias
        workBook.SaveAs("Developers.xlsx");
    }
}
Friend Class Program
	Shared Sub Main(ByVal args() As String)
	'  Crear un nuevo libro de trabajo XLSX
		Dim workBook As WorkBook = WorkBook.Create(ExcelFileFormat.XLSX)
		workBook.Metadata.Author = "Mr. Author" '  Establecer el autor (opcional)
		'  Añadir una hoja de cálculo en blanco
		Dim workSheet As WorkSheet = workBook.CreateWorkSheet("Sheet1")
		'  Añadir datos a la nueva hoja de cálculo
		workSheet ("A1").Value = "Developer Name"
		workSheet ("A2").Value = "John Grahm"
		workSheet ("A3").Value = "David Smith"
		workSheet ("A4").Value = "Rishi Kelkar"
		'  Guardar el archivo excel como XLS, XLSX, CSV, TSV, JSON, XML, HTML y secuencias
		workBook.SaveAs("Developers.xlsx")
	End Sub
End Class
VB   C#

El código anterior demuestra cómo crear un archivo de Excel mediante programación utilizando IronXL en C#. Comienza creando un nuevo libro de Excel (nueva instancia de archivo Excel) en formato XLSX, establece los metadatos de autor, añade una hoja de cálculo de Excel en blanco con el nombre "Sheet1" mediante la función CreateWorkSheet() rellena las celdas A1 a A4 y, por último, guarda el libro de trabajo como "Desarrolladores.xlsx".

IronXL ofrece una amplia gama de funcionalidades para trabajar con archivos Excel, incluyendo la creación, manipulación y guardado en varios formatos como XLSX, CSV, TSV, JSON, XML y HTML.

La salida es como:

Cómo crear un nuevo libro de Excel en C#: Figura 3 - Salida: Desarrolladores.xlsx

Paso 4: Dar formato y estilo al archivo Excel

IronXL le permite dar formato a las celdas, aplicar estilos de fuente, establecer colores de fondo y ajustar la alineación. Puedes crear hojas de cálculo de aspecto profesional personalizando la apariencia de las celdas.

//  Establecer estilo de encabezado
  workSheet ["A1"].Style.BackgroundColor = "#FFFF66";
  workSheet ["A1"].Style.Font.Bold = true;
  //  Fijar el límite de un rango específico
  var range = workSheet ["A1:A4"];
  range.Style.BottomBorder.Type = BorderType.Medium;
  range.Style.LeftBorder.Type = BorderType.Medium;
  range.Style.RightBorder.Type = BorderType.Medium;
  range.Style.TopBorder.Type = BorderType.Medium;
//  Establecer estilo de encabezado
  workSheet ["A1"].Style.BackgroundColor = "#FFFF66";
  workSheet ["A1"].Style.Font.Bold = true;
  //  Fijar el límite de un rango específico
  var range = workSheet ["A1:A4"];
  range.Style.BottomBorder.Type = BorderType.Medium;
  range.Style.LeftBorder.Type = BorderType.Medium;
  range.Style.RightBorder.Type = BorderType.Medium;
  range.Style.TopBorder.Type = BorderType.Medium;
'  Establecer estilo de encabezado
  workSheet ("A1").Style.BackgroundColor = "#FFFF66"
  workSheet ("A1").Style.Font.Bold = True
  '  Fijar el límite de un rango específico
  Dim range = workSheet ("A1:A4")
  range.Style.BottomBorder.Type = BorderType.Medium
  range.Style.LeftBorder.Type = BorderType.Medium
  range.Style.RightBorder.Type = BorderType.Medium
  range.Style.TopBorder.Type = BorderType.Medium
VB   C#

El código anterior demuestra cómo personalizar la apariencia de celdas específicas en una hoja de cálculo de Excel utilizando IronXL en C#. Primero establece el color de fondo de la celda A1 en un tono amarillo claro y pone la fuente en negrita, dándole estilo de encabezado.

A continuación, define un rango que abarque las celdas A1 a A4 y establece bordes de peso medio a lo largo de los bordes inferior, izquierdo, derecho y superior de este rango, mejorando su distinción visual dentro de la hoja de cálculo. Estas opciones de estilo permiten a los desarrolladores crear documentos Excel visualmente atractivos y organizados, adaptados a sus necesidades específicas.

La salida es como:

Cómo Crear un Nuevo Libro de Excel en C#: Figura 4 - Generar Excel con formato y estilo usando IronXL.

Paso 5: Fórmula y cálculo

Puede añadir fórmulas a las celdas mediante programación. IronXL es compatible con una amplia gama de funciones de Excel.

//  Añadir una nueva columna para mostrar la longitud del nombre del promotor
  workSheet ["B1"].Value = "Name Length";
  workSheet ["B1"].Style.BackgroundColor = "#FFFF66";
  workSheet ["B1"].Style.Font.Bold = true;
  workSheet ["B2"].Value = "=LEN(A2)";
  workSheet ["B3"].Value = "=LEN(A3)";
  workSheet ["B4"].Value = "=LEN(A4)";
  workSheet ["A5"].Value = "Sum of Length"; //  Recuento total de promotores = SUM(B2: B4)
  workSheet ["B5"].Formula = "=SUM(B2:B4)";
//  Añadir una nueva columna para mostrar la longitud del nombre del promotor
  workSheet ["B1"].Value = "Name Length";
  workSheet ["B1"].Style.BackgroundColor = "#FFFF66";
  workSheet ["B1"].Style.Font.Bold = true;
  workSheet ["B2"].Value = "=LEN(A2)";
  workSheet ["B3"].Value = "=LEN(A3)";
  workSheet ["B4"].Value = "=LEN(A4)";
  workSheet ["A5"].Value = "Sum of Length"; //  Recuento total de promotores = SUM(B2: B4)
  workSheet ["B5"].Formula = "=SUM(B2:B4)";
'  Añadir una nueva columna para mostrar la longitud del nombre del promotor
  workSheet ("B1").Value = "Name Length"
  workSheet ("B1").Style.BackgroundColor = "#FFFF66"
  workSheet ("B1").Style.Font.Bold = True
  workSheet ("B2").Value = "=LEN(A2)"
  workSheet ("B3").Value = "=LEN(A3)"
  workSheet ("B4").Value = "=LEN(A4)"
  workSheet ("A5").Value = "Sum of Length" '  Recuento total de promotores = SUM(B2: B4)
  workSheet ("B5").Formula = "=SUM(B2:B4)"
VB   C#

El código anterior ilustra la utilización de fórmulas y funciones en IronXL para calcular la longitud de los nombres de los desarrolladores y calcular la suma de estas longitudes dentro de una hoja de cálculo de Excel. A través de esta demostración, los desarrolladores pueden comprender cómo integrar fórmulas y funciones en IronXL para realizar cálculos dinámicos y manipulaciones dentro de las hojas de cálculo de Excel mediante programación, ofreciendo flexibilidad y automatización en las tareas de procesamiento de datos.

En primer lugar, se añade un encabezado titulado "Longitud del nombre" a la celda B1, con un estilo para resaltar su importancia. A continuación, se aplican fórmulas a las celdas B2, B3 y B4 para calcular la longitud del nombre de cada promotor mediante la función LEN, haciendo referencia a la celda correspondiente de la columna A. Esto permite calcular automáticamente la longitud de los nombres a medida que cambian los nombres de los desarrolladores.

Además, en la celda B5 se calcula un recuento total de las longitudes de los nombres de los desarrolladores mediante la función SUMA, que suma los valores de las celdas B2 a B4.

Al incorporar estas fórmulas, la hoja de cálculo se actualiza dinámicamente. Este caso de uso puede no ser práctico, pero es sólo un ejemplo de uso de una fórmula de Excel en código.

Cómo Crear un Nuevo Libro de Excel en C#: Figura 5 - Salida de Excel con fórmula y cálculo usando IronXL.

Conclusión

En resumen, este tutorial ha demostrado el proceso de creación de un nuevo libro de Excel en C# utilizando IronXL una robusta biblioteca que facilita la manipulación de archivos Excel dentro del ecosistema C#. Con IronXL, los desarrolladores pueden integrar perfectamente la funcionalidad de Excel en sus aplicaciones, desde la configuración del entorno de desarrollo hasta la generación de libros de Excel mediante programación. Además de su capacidad para realizar tareas como dar formato, aplicar estilos y aplicar fórmulas, IronXL ofrece un completo conjunto de funciones para la gestión y el análisis eficaces de los datos.

Para obtener referencias sobre cómo utilizar IronXL, visite la página documentación página. IronXL también ofrece una colección de ejemplos de código que son útiles para empezar.

Los desarrolladores pueden explorar IronXL a través de su prueba gratuita y compra, garantizando una transición fluida de la evaluación a la aplicación a gran escala. Para más información sobre las licencias perpetuas, visite la página licencia enlace de página.

< ANTERIOR
Cómo analizar un archivo Excel en Python
SIGUIENTE >
Cómo utilizar el estilo de fuente de Excel en C#

¿Listo para empezar? Versión: 2024.7 recién publicada

Descarga gratuita de NuGet Descargas totales: 897,936 Ver licencias >
123