How to Create an Excel File in C# (.NET Tutorial)

Características de IronXL

• Soporte humano directamente de nuestro equipo de desarrollo .NET
• Instalación rápida con Microsoft Visual Studio
• GRATIS para desarrollo. Licencias de $999

¿Cómo puedo crear y guardar rápidamente un archivo de Excel?

Instala IronXL a través de NuGet o descarga el DLL directamente. La clase WorkBook es el punto de entrada para todas las operaciones de Excel, y la clase WorkSheet expone métodos para manipular hojas individuales. El recorrido paso a paso completo comienza en el Paso 1 a continuación.

¿Cómo agrego una hoja de trabajo a mi libro de trabajo?

Agregue hojas de trabajo a través de CreateWorkSheet:

:path=/static-assets/excel/content-code-examples/tutorials/create-excel-file-net-4.cs

workSheet["A1"].Value = "January";
workSheet["B1"].Value = "February";
workSheet["C1"].Value = "March";
workSheet["D1"].Value = "April";
workSheet["E1"].Value = "May";
workSheet["F1"].Value = "June";
workSheet["G1"].Value = "July";
workSheet["H1"].Value = "August";
workSheet["I1"].Value = "September";
workSheet["J1"].Value = "October";
workSheet["K1"].Value = "November";
workSheet["L1"].Value = "December";

workSheet("A1").Value = "January"
workSheet("B1").Value = "February"
workSheet("C1").Value = "March"
workSheet("D1").Value = "April"
workSheet("E1").Value = "May"
workSheet("F1").Value = "June"
workSheet("G1").Value = "July"
workSheet("H1").Value = "August"
workSheet("I1").Value = "September"
workSheet("J1").Value = "October"
workSheet("K1").Value = "November"
workSheet("L1").Value = "December"

Un libro contiene una o más hojas de trabajo. Cada hoja de trabajo se compone de filas y columnas, con celdas en sus intersecciones. Utilice el método CreateWorkSheet para agregar nuevas hojas a su libro de trabajo.

• WorkBook.CreateWorkSheet(String): Agrega una nueva hoja con el nombre de pestaña dado
• WorkSheet: Recupera una hoja existente por nombre
• Los nombres de las hojas deben ser únicos dentro de un libro de trabajo

¿Cómo puedo establecer valores de celda manualmente?

El acceso a celdas utiliza las mismas cadenas de dirección estilo A1 que ves en Excel:

:path=/static-assets/excel/content-code-examples/tutorials/create-excel-file-net-5.cs

Random r = new Random();
for (int i = 2 ; i <= 11 ; i++)
{
    workSheet["A" + i].Value = r.Next(1, 1000);
    workSheet["B" + i].Value = r.Next(1000, 2000);
    workSheet["C" + i].Value = r.Next(2000, 3000);
    workSheet["D" + i].Value = r.Next(3000, 4000);
    workSheet["E" + i].Value = r.Next(4000, 5000);
    workSheet["F" + i].Value = r.Next(5000, 6000);
    workSheet["G" + i].Value = r.Next(6000, 7000);
    workSheet["H" + i].Value = r.Next(7000, 8000);
    workSheet["I" + i].Value = r.Next(8000, 9000);
    workSheet["J" + i].Value = r.Next(9000, 10000);
    workSheet["K" + i].Value = r.Next(10000, 11000);
    workSheet["L" + i].Value = r.Next(11000, 12000);
}

Dim r As New Random()
For i As Integer = 2 To 11
	workSheet("A" & i).Value = r.Next(1, 1000)
	workSheet("B" & i).Value = r.Next(1000, 2000)
	workSheet("C" & i).Value = r.Next(2000, 3000)
	workSheet("D" & i).Value = r.Next(3000, 4000)
	workSheet("E" & i).Value = r.Next(4000, 5000)
	workSheet("F" & i).Value = r.Next(5000, 6000)
	workSheet("G" & i).Value = r.Next(6000, 7000)
	workSheet("H" & i).Value = r.Next(7000, 8000)
	workSheet("I" & i).Value = r.Next(8000, 9000)
	workSheet("J" & i).Value = r.Next(9000, 10000)
	workSheet("K" & i).Value = r.Next(10000, 11000)
	workSheet("L" & i).Value = r.Next(11000, 12000)
Next i

La propiedad Value acepta varios tipos de datos, incluidos cadenas de texto, números, fechas y booleanos. IronXL formatea automáticamente las celdas según el tipo de dato.

¿Cómo puedo establecer valores de celda dinámicamente?

Cuando la cuenta de filas se conoce en tiempo de ejecución, la interpolación de cadenas hace que el cuerpo del bucle sea fácil de leer:

// Initialize random number generator for sample data
Random r = new Random();

// Populate cells with random budget data for each month
for (int i = 2; i <= 11; i++)
{
    // Set different budget categories with increasing ranges
    workSheet[$"A{i}"].Value = r.Next(1, 1000);     // Office Supplies
    workSheet[$"B{i}"].Value = r.Next(1000, 2000);  // Utilities
    workSheet[$"C{i}"].Value = r.Next(2000, 3000);  // Rent
    workSheet[$"D{i}"].Value = r.Next(3000, 4000);  // Salaries
    workSheet[$"E{i}"].Value = r.Next(4000, 5000);  // Marketing
    workSheet[$"F{i}"].Value = r.Next(5000, 6000);  // IT Services
    workSheet[$"G{i}"].Value = r.Next(6000, 7000);  // Travel
    workSheet[$"H{i}"].Value = r.Next(7000, 8000);  // Training
    workSheet[$"I{i}"].Value = r.Next(8000, 9000);  // Insurance
    workSheet[$"J{i}"].Value = r.Next(9000, 10000); // Equipment
    workSheet[$"K{i}"].Value = r.Next(10000, 11000); // Research
    workSheet[$"L{i}"].Value = r.Next(11000, 12000); // Misc
}

// Alternative: Set range of cells with same value
workSheet["A13:L13"].Value = 0; // Initialize totals row

// Initialize random number generator for sample data
Random r = new Random();

// Populate cells with random budget data for each month
for (int i = 2; i <= 11; i++)
{
    // Set different budget categories with increasing ranges
    workSheet[$"A{i}"].Value = r.Next(1, 1000);     // Office Supplies
    workSheet[$"B{i}"].Value = r.Next(1000, 2000);  // Utilities
    workSheet[$"C{i}"].Value = r.Next(2000, 3000);  // Rent
    workSheet[$"D{i}"].Value = r.Next(3000, 4000);  // Salaries
    workSheet[$"E{i}"].Value = r.Next(4000, 5000);  // Marketing
    workSheet[$"F{i}"].Value = r.Next(5000, 6000);  // IT Services
    workSheet[$"G{i}"].Value = r.Next(6000, 7000);  // Travel
    workSheet[$"H{i}"].Value = r.Next(7000, 8000);  // Training
    workSheet[$"I{i}"].Value = r.Next(8000, 9000);  // Insurance
    workSheet[$"J{i}"].Value = r.Next(9000, 10000); // Equipment
    workSheet[$"K{i}"].Value = r.Next(10000, 11000); // Research
    workSheet[$"L{i}"].Value = r.Next(11000, 12000); // Misc
}

// Alternative: Set range of cells with same value
workSheet["A13:L13"].Value = 0; // Initialize totals row

' Initialize random number generator for sample data
Dim r As New Random()

' Populate cells with random budget data for each month
For i As Integer = 2 To 11
	' Set different budget categories with increasing ranges
	workSheet($"A{i}").Value = r.Next(1, 1000) ' Office Supplies
	workSheet($"B{i}").Value = r.Next(1000, 2000) ' Utilities
	workSheet($"C{i}").Value = r.Next(2000, 3000) ' Rent
	workSheet($"D{i}").Value = r.Next(3000, 4000) ' Salaries
	workSheet($"E{i}").Value = r.Next(4000, 5000) ' Marketing
	workSheet($"F{i}").Value = r.Next(5000, 6000) ' IT Services
	workSheet($"G{i}").Value = r.Next(6000, 7000) ' Travel
	workSheet($"H{i}").Value = r.Next(7000, 8000) ' Training
	workSheet($"I{i}").Value = r.Next(8000, 9000) ' Insurance
	workSheet($"J{i}").Value = r.Next(9000, 10000) ' Equipment
	workSheet($"K{i}").Value = r.Next(10000, 11000) ' Research
	workSheet($"L{i}").Value = r.Next(11000, 12000) ' Misc
Next i

' Alternative: Set range of cells with same value
workSheet("A13:L13").Value = 0 ' Initialize totals row

La interpolación de cadenas ($"...") facilita la referencia dinámica de celdas. El indexador Item admite tanto celdas individuales como rangos.

¿Cómo puedo completar un Excel desde una base de datos?

Cargar datos desde bases de datos a Excel es un requisito común:

:path=/static-assets/excel/content-code-examples/tutorials/create-excel-file-net-7.cs

workSheet["A1:L1"].Style.SetBackgroundColor("#d3d3d3");

workSheet("A1:L1").Style.SetBackgroundColor("#d3d3d3")

Este ejemplo demuestra la lectura de datos de Excel desde bases de datos, aplicando formato y usando fórmulas para cálculos. La propiedad NumberFormat permite formatear números de forma personalizada al igual que en Excel.

¿Cómo puedo configurar colores de fondo en Excel?

Fondos, colores de fila alternados y sobrescrituras de colores de fuentes, todo pasa a través del objeto Style en una celda o rango:

// Set header row background to light gray using hex color
workSheet["A1:L1"].Style.SetBackgroundColor("#d3d3d3");

// Apply different colors for data categorization
workSheet["A2:A11"].Style.SetBackgroundColor("#E7F3FF"); // Light blue for January
workSheet["B2:B11"].Style.SetBackgroundColor("#FFF2CC"); // Light yellow for February

// Highlight important cells with bold colors
workSheet["L12"].Style.SetBackgroundColor("#FF0000"); // Red for totals
workSheet["L12"].Style.Font.FontColor = "#FFFFFF"; // White text

// Create alternating row colors for better readability
for (int row = 2; row <= 11; row++)
{
    if (row % 2 == 0)
    {
        workSheet[$"A{row}:L{row}"].Style.SetBackgroundColor("#F2F2F2");
    }
}

// Set header row background to light gray using hex color
workSheet["A1:L1"].Style.SetBackgroundColor("#d3d3d3");

// Apply different colors for data categorization
workSheet["A2:A11"].Style.SetBackgroundColor("#E7F3FF"); // Light blue for January
workSheet["B2:B11"].Style.SetBackgroundColor("#FFF2CC"); // Light yellow for February

// Highlight important cells with bold colors
workSheet["L12"].Style.SetBackgroundColor("#FF0000"); // Red for totals
workSheet["L12"].Style.Font.FontColor = "#FFFFFF"; // White text

// Create alternating row colors for better readability
for (int row = 2; row <= 11; row++)
{
    if (row % 2 == 0)
    {
        workSheet[$"A{row}:L{row}"].Style.SetBackgroundColor("#F2F2F2");
    }
}

' Set header row background to light gray using hex color
workSheet("A1:L1").Style.SetBackgroundColor("#d3d3d3")

' Apply different colors for data categorization
workSheet("A2:A11").Style.SetBackgroundColor("#E7F3FF") ' Light blue for January
workSheet("B2:B11").Style.SetBackgroundColor("#FFF2CC") ' Light yellow for February

' Highlight important cells with bold colors
workSheet("L12").Style.SetBackgroundColor("#FF0000") ' Red for totals
workSheet("L12").Style.Font.FontColor = "#FFFFFF" ' White text

' Create alternating row colors for better readability
For row As Integer = 2 To 11
	If row Mod 2 = 0 Then
		workSheet($"A{row}:L{row}").Style.SetBackgroundColor("#F2F2F2")
	End If
Next row

El método SetBackgroundColor acepta códigos de color hexadecimales. Combine colores de fondo con Font.FontColor para mantener el contraste legible en rellenos más oscuros.

¿Cómo creo bordes en Excel?

Los bordes ayudan a definir regiones de datos y mejorar la estructura:

:path=/static-assets/excel/content-code-examples/tutorials/create-excel-file-net-9.cs

// Use IronXL built-in aggregations
decimal sum = workSheet["A2:A11"].Sum();
decimal avg = workSheet["B2:B11"].Avg();
decimal max = workSheet["C2:C11"].Max();
decimal min = workSheet["D2:D11"].Min();

// Assign value to cells
workSheet["A12"].Value = sum;
workSheet["B12"].Value = avg;
workSheet["C12"].Value = max;
workSheet["D12"].Value = min;

' Use IronXL built-in aggregations
Dim sum As Decimal = workSheet("A2:A11").Sum()
Dim avg As Decimal = workSheet("B2:B11").Avg()
Dim max As Decimal = workSheet("C2:C11").Max()
Dim min As Decimal = workSheet("D2:D11").Min()

' Assign value to cells
workSheet("A12").Value = sum
workSheet("B12").Value = avg
workSheet("C12").Value = max
workSheet("D12").Value = min

IronXL admite varios tipos de borde incluidos delgado, medio, grueso, doble, punteado y discontinuo. Cada lado del borde puede ser estilizado de forma independiente.

¿Cómo puedo configurar las propiedades de la hoja de trabajo?

Protege hojas de trabajo y controla las opciones de visualización:

:path=/static-assets/excel/content-code-examples/tutorials/create-excel-file-net-11.cs

workSheet.SetPrintArea("A1:L12");
workSheet.PrintSetup.PrintOrientation = IronXL.Printing.PrintOrientation.Landscape;
workSheet.PrintSetup.PaperSize = IronXL.Printing.PaperSize.A4;

workSheet.SetPrintArea("A1:L12")
workSheet.PrintSetup.PrintOrientation = IronXL.Printing.PrintOrientation.Landscape
workSheet.PrintSetup.PaperSize = IronXL.Printing.PaperSize.A4

La protección de hojas previene modificaciones accidentales mientras que congelar paneles mantiene filas o columnas importantes visibles durante el desplazamiento.

Figura 7 - La fila de encabezado congelada permanece visible mientras se desplaza

Figura 8 - La protección con contraseña evita ediciones no autorizadas

¿Cómo configuro los ajustes de página e impresión?

Las opciones de diseño de impresión (orientación, tamaño de papel, márgenes, escalado, encabezados, pies de página) se exponen a través de WorkSheet.PrintSetup:

:path=/static-assets/excel/content-code-examples/tutorials/create-excel-file-net-12.cs

workBook.SaveAs("Budget.xlsx");

workBook.SaveAs("Budget.xlsx")

La clase IPrintSetup proporciona opciones de configuración de impresión completas que coinciden con la configuración de impresión de Excel.

Figura 9 - Vista previa de impresión con orientación horizontal y márgenes personalizados

¿Cuánto tiempo lleva realmente la generación?

Ejecuté un benchmark de generación en una caja con Windows 11 (.NET 9.0.7) para obtener números concretos para un libro de trabajo del tamaño que terminan la mayoría de las exportaciones de producción. El arnés construye un XLSX de 10,000 filas y tres columnas en memoria y lo escribe en disco en una sola llamada SaveAs, tanto en frío como en caliente. El proyecto completo está en el proyecto de ejemplo CreateExcelBenchmark a continuación. Tres lanzamientos de proceso por separado aterrizaron aproximadamente aquí:

El número en frío está dominado por la carga de ensamblajes de IronXL y el calentamiento de JIT. Una vez que el proceso está caliente, la generación cae a un rango de alrededor de 300 ms con alguna variación de ejecución a ejecución por actividad de fondo. Para libros de trabajo sustancialmente más grandes (cientos de miles de filas, múltiples hojas, estilo pesado), escribo todo el libro de trabajo en memoria y llamo a SaveAs exactamente una vez al final. La causa más común de los tickets "¿por qué mi exportación es tan lenta?" que vemos es llamar a SaveAs repetidamente dentro de un bucle mientras el libro de trabajo está creciendo: cada guardado serializa todo el estado actual, por lo que el costo sube con cada iteración.

Olvidar FormatString en fechas y moneda

La trampa de formato que más veo: establecer .Value en un DateTime pero olvidar FormatString. La fecha se almacena correctamente, pero Excel la muestra como un número de serie crudo (45292 significa 2024-01-01) hasta que aplique una cadena de formato como "yyyy-MM-dd". La moneda tiene el mismo problema: el número está correcto, pero sin "$#,##0.00" se representa como un decimal simple. Ahora escribo el valor y el formato en líneas adyacentes, por lo que los dos no pueden separarse:

var dateCell = sheet["A2"];
dateCell.Value = DateTime.Today;
dateCell.FormatString = "yyyy-MM-dd";

var moneyCell = sheet["B2"];
moneyCell.Value = 1499.95m;
moneyCell.FormatString = "$#,##0.00";

var dateCell = sheet["A2"];
dateCell.Value = DateTime.Today;
dateCell.FormatString = "yyyy-MM-dd";

var moneyCell = sheet["B2"];
moneyCell.Value = 1499.95m;
moneyCell.FormatString = "$#,##0.00";

Dim dateCell = sheet("A2")
dateCell.Value = DateTime.Today
dateCell.FormatString = "yyyy-MM-dd"

Dim moneyCell = sheet("B2")
moneyCell.Value = 1499.95D
moneyCell.FormatString = "$#,##0.00"

XLS truncará silenciosamente en 65,536 filas

Este se menciona en la sección de elección de formato cerca de la parte superior del artículo, pero se gana su lugar aquí porque el modo de falla es silencioso: ExcelFileFormat.XLS se limita a 65,536 filas por hoja, y las filas más allá de ese límite se eliminan sin excepción ni advertencia. La exportación "tiene éxito" y tus datos desaparecen. Elige XLSX para cualquier cosa con muchos datos, a menos que un sistema posterior literalmente no pueda leerlo.

"Excel dice que el archivo está corrupto"

Si un archivo generado se niega a abrirse o Excel dice que está corrupto, la causa casi siempre es una de dos cosas. O el flujo de archivos no fue desechado correctamente, por lo que los bytes en el disco están truncados; o escribiste en una ruta que todavía estaba bloqueada por una ejecución anterior, y solo parte de los datos pasó. Asegúrese de que SaveAs (o el flujo que lo envuelve) haya terminado completamente antes de que algo más toque el archivo, y prefiera un bloque using alrededor de cualquier MemoryStream o FileStream en el que envuelva un libro de trabajo.

Proyecto de ejemplo para los números de referencia

Si deseas reproducir los números de tiempo de antes, el arnés es una pequeña aplicación de consola .NET 9:

:path=/static-assets/excel/content-code-examples/tutorials/create-excel-file-net-15.cs

// CreateExcelBenchmark/Program.cs (excerpt)
IronXL.License.LicenseKey = Environment.GetEnvironmentVariable("IRONXL_LICENSE_KEY");

var sw = Stopwatch.StartNew();
var workbook = WorkBook.Create(ExcelFileFormat.XLSX);
var sheet = workbook.CreateWorkSheet("Data");
sheet["A1"].Value = "Id";
sheet["B1"].Value = "Name";
sheet["C1"].Value = "Amount";
for (int i = 0; i < 10_000; i++)
{
    int row = i + 2;
    sheet[$"A{row}"].Value = i + 1;
    sheet[$"B{row}"].Value = $"Item {i + 1}";
    sheet[$"C{row}"].Value = (i + 1) * 1.25m;
}
workbook.SaveAs("Generated.xlsx");
sw.Stop();
Console.WriteLine($"cold: {sw.Elapsed.TotalMilliseconds:F1} ms");

Imports System
Imports System.Diagnostics
Imports IronXL

Module Program
    Sub Main()
        License.LicenseKey = Environment.GetEnvironmentVariable("IRONXL_LICENSE_KEY")

        Dim sw As Stopwatch = Stopwatch.StartNew()
        Dim workbook As WorkBook = WorkBook.Create(ExcelFileFormat.XLSX)
        Dim sheet As WorkSheet = workbook.CreateWorkSheet("Data")
        sheet("A1").Value = "Id"
        sheet("B1").Value = "Name"
        sheet("C1").Value = "Amount"
        For i As Integer = 0 To 9999
            Dim row As Integer = i + 2
            sheet($"A{row}").Value = i + 1
            sheet($"B{row}").Value = $"Item {i + 1}"
            sheet($"C{row}").Value = (i + 1) * 1.25D
        Next
        workbook.SaveAs("Generated.xlsx")
        sw.Stop()
        Console.WriteLine($"cold: {sw.Elapsed.TotalMilliseconds:F1} ms")
    End Sub
End Module

Ejecute esto bajo dotnet run -c Release e intercambie sus propios conteos de filas, conteos de columnas o estilizaciones para ver cómo cambian los números con la complejidad del libro de trabajo.