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

¿Cómo empiezo a crear libros de Excel en C#?

En este tutorial, aprenderemos a crear un nuevo libro utilizando IronXL en C#. Repasaremos los pasos necesarios, desde configurar tu entorno de desarrollo hasta escribir código que genere un nuevo libro de Excel. Descubrirás cómo crear hojas de cálculo programáticamente sin ninguna instalación de Excel en tu máquina.

Al final de este tutorial, tendrás una comprensión sólida de cómo aprovechar IronXL para crear libros de Excel programáticamente, permitiéndote integrar funcionalidad de Excel en tus aplicaciones en C# con facilidad. ¡Comencemos!

¿Qué es IronXL?

IronXL es una versátil biblioteca de C# que te permite trabajar con documentos de Excel sin necesitar Microsoft Office Excel Interop o cualquier aplicación de Excel. Te permite leer, crear y modificar libros de trabajo fácilmente, dar formato a celdas, agregar fórmulas y trabajar con formatos de archivos de Excel tanto modernos como antiguos.

Puedes validar datos, insertar imágenes, aplicar formato condicional y crear gráficos sin necesidad de Microsoft Office. Los desarrolladores pueden construir soluciones de Excel para tareas como informes financieros, paneles de datos y gestión de inventarios fácilmente usando IronXL. La biblioteca admite convertir entre diferentes formatos de hojas de cálculo incluyendo XLSX, XLS, CSV, TSV, JSON y XML.

Comencemos a crear un archivo de Excel en C#.

¿Cómo creo un nuevo proyecto C# para desarrollo de Excel?

Abra Visual Studio y cree un nuevo proyecto de Aplicación de Consola en C#. Nómbralo como 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 usando una aplicación de consola por simplicidad y para hacerla relevante para todos los tipos de proyectos. La biblioteca incluso funciona en contenedores Docker y Azure Functions.

¿Cómo instalo el paquete NuGet de IronXL?

Para instalar el paquete IronXL en tu proyecto de C#, puedes usar cualquiera de las siguientes formas. Una configuración de clave de licencia adecuada asegura que tus despliegues de producción funcionen sin restricciones.

1. Para instalar IronXL, haz clic derecho en tu proyecto en el Explorador de Soluciones, elige "Administrar paquetes NuGet", busca IronXL y luego procede con la instalación.

2. Alternativamente, puedes instalar IronXL a través de la consola del administrador de paquetes usando el siguiente comando:

Install-Package IronXL.Excel

Este comando descargará, instalará y agregará una referencia de ensamblado a tu proyecto. Espera a que el paquete sea descargado e instalado. Una vez completada la instalación, puedes comenzar a usar IronXL en tu proyecto para trabajar con archivos de Excel programáticamente.

¿Cómo importo los espacios de nombres necesarios?

En la parte superior de tu archivo C#, agrega el siguiente espacio de nombres:

using IronXL;

using IronXL;

¿Cómo creo un nuevo archivo de Excel programáticamente?

Ahora, escribamos el código para crear un archivo de Excel:

internal class Program
{
    static void Main(string[] args)
    {
        // Create a new workbook in the XLSX format
        WorkBook workBook = WorkBook.Create(ExcelFileFormat.XLSX);
        workBook.Metadata.Author = "Mr. Author"; // Set the author (optional)

        // Add a blank worksheet named "Sheet1"
        WorkSheet workSheet = workBook.CreateWorkSheet("Sheet1");

        // Add data to the new worksheet
        workSheet["A1"].Value = "Developer Name";
        workSheet["A2"].Value = "John Grahm";
        workSheet["A3"].Value = "David Smith";
        workSheet["A4"].Value = "Rishi Kelkar";

        // Save the Excel file as "Developers.xlsx"
        workBook.SaveAs("Developers.xlsx");
    }
}

internal class Program
{
    static void Main(string[] args)
    {
        // Create a new workbook in the XLSX format
        WorkBook workBook = WorkBook.Create(ExcelFileFormat.XLSX);
        workBook.Metadata.Author = "Mr. Author"; // Set the author (optional)

        // Add a blank worksheet named "Sheet1"
        WorkSheet workSheet = workBook.CreateWorkSheet("Sheet1");

        // Add data to the new worksheet
        workSheet["A1"].Value = "Developer Name";
        workSheet["A2"].Value = "John Grahm";
        workSheet["A3"].Value = "David Smith";
        workSheet["A4"].Value = "Rishi Kelkar";

        // Save the Excel file as "Developers.xlsx"
        workBook.SaveAs("Developers.xlsx");
    }
}

El código anterior demuestra cómo crear un archivo de Excel programáticamente usando IronXL en C#. Comienza creando un nuevo libro de trabajo de Excel (una nueva instancia de un archivo de Excel) en formato XLSX, establece metadatos del autor usando las propiedades de metadatos del libro, agrega una hoja de cálculo de Excel en blanco llamada "Sheet1" usando el método CreateWorkSheet(), llena los datos en las celdas A1 a A4 y finalmente guarda el libro como "Developers.xlsx".

IronXL ofrece una gama de funcionalidades para trabajar con archivos de Excel, incluyendo creación, manipulación y guardado en varios formatos como XLSX, CSV, TSV, JSON, XML y HTML. También puedes cargar hojas de cálculo existentes para modificarlas o gestionar varias hojas dentro de un solo libro de trabajo.

La salida es como:

¿Cómo aplico formato y estilos a los archivos de Excel?

IronXL te permite formatear celdas, aplicar estilos de fuente, establecer colores de fondo y ajustar alineación. Puedes crear hojas de cálculo de apariencia profesional personalizando la apariencia de las celdas. La biblioteca admite un estilo completo de celdas que incluye bordes, fuentes y opciones de alineación.

// Set style of heading for cell A1
workSheet["A1"].Style.BackgroundColor = "#FFFF66"; // Light yellow background
workSheet["A1"].Style.Font.Bold = true; // Bold font

// Set border style for a specific range (A1:A4)
var range = workSheet["A1:A4"];
range.Style.BottomBorder.Type = BorderType.Medium; // Medium bottom border
range.Style.LeftBorder.Type = BorderType.Medium; // Medium left border
range.Style.RightBorder.Type = BorderType.Medium; // Medium right border
range.Style.TopBorder.Type = BorderType.Medium; // Medium top border

// Set style of heading for cell A1
workSheet["A1"].Style.BackgroundColor = "#FFFF66"; // Light yellow background
workSheet["A1"].Style.Font.Bold = true; // Bold font

// Set border style for a specific range (A1:A4)
var range = workSheet["A1:A4"];
range.Style.BottomBorder.Type = BorderType.Medium; // Medium bottom border
range.Style.LeftBorder.Type = BorderType.Medium; // Medium left border
range.Style.RightBorder.Type = BorderType.Medium; // Medium right border
range.Style.TopBorder.Type = BorderType.Medium; // Medium top border

El código anterior demuestra cómo personalizar la apariencia de celdas específicas en una hoja de cálculo de Excel usando IronXL en C#. Primero establece el color de fondo y patrón de la celda A1 a un tono amarillo claro y hace que la fuente sea negrita, dando estilo efectivamente como encabezado.

A continuación, define un rango que abarca 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 de Excel visualmente atractivos y organizados según sus necesidades específicas. También puedes establecer formatos de datos de celda para números, fechas y monedas.

La salida es como:

¿Cómo agrego fórmulas y cálculos?

Puedes agregar fórmulas a las celdas programáticamente. IronXL admite una amplia gama de funciones de Excel y operaciones matemáticas. La biblioteca puede establecer tanto fórmulas como evaluar sus resultados.

// Add a new column to display the length of developer names
workSheet["B1"].Value = "Name Length";
workSheet["B1"].Style.BackgroundColor = "#FFFF66"; // Styled as heading
workSheet["B1"].Style.Font.Bold = true; // Bold font

// Formula to calculate the length of names in column B
workSheet["B2"].Value = "=LEN(A2)";
workSheet["B3"].Value = "=LEN(A3)";
workSheet["B4"].Value = "=LEN(A4)";

// Add a total count of the length of names in cell A5
workSheet["A5"].Value = "Sum of Length";
workSheet["B5"].Formula = "=SUM(B2:B4)";

// Add a new column to display the length of developer names
workSheet["B1"].Value = "Name Length";
workSheet["B1"].Style.BackgroundColor = "#FFFF66"; // Styled as heading
workSheet["B1"].Style.Font.Bold = true; // Bold font

// Formula to calculate the length of names in column B
workSheet["B2"].Value = "=LEN(A2)";
workSheet["B3"].Value = "=LEN(A3)";
workSheet["B4"].Value = "=LEN(A4)";

// Add a total count of the length of names in cell A5
workSheet["A5"].Value = "Sum of Length";
workSheet["B5"].Formula = "=SUM(B2:B4)";

El código anterior ilustra cómo usar fórmulas y funciones en IronXL para calcular la longitud de los nombres de los desarrolladores y computar la suma de estas longitudes dentro de una hoja de cálculo de Excel. A través de esta demostración, los desarrolladores pueden entender 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 programáticamente, ofreciendo flexibilidad y automatización en tareas de procesamiento de datos.

Primero, se agrega un encabezado titulado "Longitud del Nombre" a la celda B1, con estilo para resaltar su importancia. A continuación, se aplican fórmulas a las celdas B2, B3 y B4 para calcular la longitud de cada nombre de desarrollador usando la función LEN, haciendo referencia a la celda correspondiente en la columna A. Esto permite calcular automáticamente las longitudes de los nombres a medida que cambian.

Además, un recuento total de las longitudes de los nombres se calcula en la celda B5 utilizando la función SUM, que suma los valores de las celdas B2 a B4. También puedes usar otras funciones agregadas como AVERAGE, MIN y MAX.

Al incorporar estas fórmulas, la hoja de cálculo se actualiza dinámicamente. Si bien este caso de uso específico puede no ser práctico, sirve como un ejemplo de cómo usar fórmulas de Excel en código.

¿Cuáles son mis próximos pasos con IronXL?

En resumen, este tutorial ha demostrado cómo crear un nuevo libro de Excel en C# usando IronXL, una robusta biblioteca que facilita la manipulación de archivos de Excel en el ecosistema de C#. Con IronXL, los desarrolladores pueden integrar sin problemas la funcionalidad de Excel en sus aplicaciones, desde configurar el entorno de desarrollo hasta generar libros de Excel programáticamente. Junto con su capacidad para realizar tareas como formateo, estilización y aplicación de fórmulas, IronXL ofrece un conjunto de características integral para una gestión y análisis de datos eficientes.

Para referencias sobre cómo usar IronXL, visita la página de documentación. IronXL también ofrece una colección de ejemplos de código que son útiles para comenzar. Explora escenarios avanzados como crear gráficos, trabajar con rangos nombrados o proteger hojas de trabajo.

Los desarrolladores pueden explorar IronXL a través de su prueba gratuita y compra, asegurando una transición sin problemas de la evaluación a la implementación a gran escala. Para más detalles sobre licencias perpetuas, visita la página de licencias. Considera explorar extensiones de licencia para características adicionales.