Cómo crear un archivo de Excel en C#

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

This article was translated from English: Does it need improvement?
Translated
View the article in English

IronXL es una potente biblioteca de Excel C# y .NET que le permite crear, leer y editar hojas de cálculo XLSX mediante programación, sin dependencias de Microsoft Office o Interop. Es compatible con .NET 8, .NET 9, .NET Core, .NET Framework y se ejecuta en Windows, Linux, macOS, Azure y AWS.

Este tutorial lo guiará a través del proceso de creación de un libro de Excel completo en C#: establecer valores de celda, aplicar formato, agregar fórmulas y exportar a XLSX, CSV y más, con ejemplos de código paso a paso.

Inicio rápido: crear un archivo Excel

Usa IronXL para crear rápidamente un nuevo archivo de Excel: solo elige un formato, añade una hoja, establece cualquier valor de celda y guarda. Es la forma más rápida de generar archivos XLSX con llamadas API intuitivas y cero dolores de cabeza por interoperabilidad.

  1. Instala IronXL con el Administrador de Paquetes NuGet

    PM > Install-Package IronXl.Excel
  2. Copie y ejecute este fragmento de código.

    WorkBook book = IronXl.WorkBook.Create(IronXl.ExcelFileFormat.XLSX); book.CreateWorkSheet("Sheet1")["A1"].Value = "Hello World"; book.SaveAs("MyFile.xlsx");
  3. Despliegue para probar en su entorno real

    Comienza a usar IronXL en tu proyecto hoy mismo con una prueba gratuita

    arrow pointer

¿Qué es IronXL y por qué utilizarlo para la creación de archivos Excel?

IronXL es una API de Excel intuitiva para C# y VB que te permite leer, editar y crear archivos de hojas de cálculo de Excel en .NET con un rendimiento excepcional. A diferencia de los enfoques tradicionales, no es necesario instalar Microsoft Office ni usar Excel Interop, lo que hace que la implementación sea más simple y confiable.

IronXL es totalmente compatible con .NET 9, .NET 8, .NET Core, .NET Framework, Xamarin, Mobile, Linux, macOS y ambientes de Azure.

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 $799

¿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 su punto de entrada para todas las operaciones de Excel, mientras que la clase WorkSheet proporciona métodos para manipular hojas individuales: el tutorial completo paso a paso comienza en el Paso 1 a continuación.


How Do I Install the IronXL C# Library?

Instale IronXL a través del Administrador de paquetes NuGet en Visual Studio o utilice la Consola del Administrador de paquetes:

Install-Package IronXl.Excel

Acceda al Administrador de paquetes NuGet a través del menú Proyecto o haciendo clic derecho en su proyecto en el Explorador de soluciones.

Menú del proyecto de Visual Studio que muestra la opción Administrar paquetes NuGet

**Figura 3** – *Acceso al Administrador de paquetes NuGet a través del menú Proyecto*

Menú contextual del Explorador de soluciones que muestra la opción Administrar paquetes NuGet

**Figura 4** – *Menú contextual del botón derecho en el Explorador de soluciones*


Busque IronXl.Excel en la lista de paquetes y haga clic en Instalar.


El Administrador de paquetes NuGet muestra el paquete IronXl.Excel listo para su instalación

**Figura 5** – *Instalación de IronXl.Excel a través del Administrador de paquetes NuGet*

Como alternativa, descargue la DLL IronXL directamente y agréguela como referencia a su proyecto a través del Explorador de soluciones > Referencias > Buscar IronXL.dll.

Página de descarga del sitio web de IronXL que muestra las instrucciones de instalación y el botón de descarga

**Figura 6** – *Descargar la biblioteca IronXL desde el sitio web oficial*

{i:(IronXL no requiere la instalación de Microsoft Office o Excel Interop: se ejecuta en cualquier plataforma compatible con .NET, incluidos Windows, Linux, macOS y entornos de nube.)}


¿Cómo configuro mi proyecto .NET?

IronXL funciona con cualquier tipo de proyecto .NET : aplicaciones de consola, aplicaciones web ASP.NET, API o herramientas de escritorio. El siguiente ejemplo utiliza una aplicación web ASP.NET, pero el proceso es el mismo en todas las plantillas de proyecto.

Sigue estos pasos para crear un sitio web ASP.NET:

  1. Abre Visual Studio
  2. Haga clic en Archivo > Nuevo proyecto
  3. Selecciona Web bajo Visual C# en la lista de tipos de proyectos
  4. Selecciona Aplicación Web ASP.NET


    Cuadro de diálogo Nuevo proyecto de Visual Studio con la aplicación web ASP.NET seleccionada

    Figura 1Create new ASP.NET project

  5. Haz clic en OK
  6. Selecciona plantilla de formularios Web

    Selección de plantilla de proyecto ASP.NET que muestra la opción Formularios web

    Figura 2Select Web Forms template

  7. Haz clic en OK

Con tu proyecto listo, instala IronXL para comenzar a crear archivos de Excel de manera programática.


How Do I Create an Excel Workbook in C#?

Crear un nuevo libro de Excel con IronXL requiere solo una línea de código:

using IronXL;

// Create workbook with XLSX format (recommended for modern Excel)
WorkBook workbook = WorkBook.Create(ExcelFileFormat.XLSX);

// Alternative: Create legacy XLS format for older Excel versions
WorkBook legacyWorkbook = WorkBook.Create(ExcelFileFormat.XLS);
using IronXL;

// Create workbook with XLSX format (recommended for modern Excel)
WorkBook workbook = WorkBook.Create(ExcelFileFormat.XLSX);

// Alternative: Create legacy XLS format for older Excel versions
WorkBook legacyWorkbook = WorkBook.Create(ExcelFileFormat.XLS);
$vbLabelText   $csharpLabel

El método WorkBook.Create admite los formatos XLS (Excel 97-2003) y XLSX (Excel 2007+). Se recomienda XLSX para un mejor rendimiento y tamaños de archivo más pequeños.

  • XLSX : recomendado para todas las versiones modernas de Excel (2007+): archivos más pequeños, mejor rendimiento
  • XLS : formato heredado para compatibilidad con Excel 97–2003

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

Añadir hojas de trabajo es sencillo:

// Create a worksheet with custom name for budget tracking
WorkSheet budgetSheet = workbook.CreateWorkSheet("2020 Budget");

// Add multiple worksheets for different purposes
WorkSheet salesSheet = workbook.CreateWorkSheet("Sales Data");
WorkSheet inventorySheet = workbook.CreateWorkSheet("Inventory");

// Access existing worksheet by name
WorkSheet existingSheet = workbook.GetWorkSheet("2020 Budget");
// Create a worksheet with custom name for budget tracking
WorkSheet budgetSheet = workbook.CreateWorkSheet("2020 Budget");

// Add multiple worksheets for different purposes
WorkSheet salesSheet = workbook.CreateWorkSheet("Sales Data");
WorkSheet inventorySheet = workbook.CreateWorkSheet("Inventory");

// Access existing worksheet by name
WorkSheet existingSheet = workbook.GetWorkSheet("2020 Budget");
$vbLabelText   $csharpLabel

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.

  • CreateWorkSheet("name") : Agrega una nueva hoja con el nombre de pestaña indicado
  • GetWorkSheet("name") : Recupera una hoja existente por nombre
  • Los nombres de las hojas deben ser únicos dentro de un libro de trabajo

¿Cómo establezco valores de celda en Excel?

¿Cómo puedo establecer valores de celda manualmente?

Establecer valores de celda individuales utiliza una sintaxis intuitiva similar a Excel:

// Set month names in first row for annual budget spreadsheet
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";

// Set different data types - IronXL handles conversion automatically
workSheet["A2"].Value = 1500.50m;  // Decimal for currency
workSheet["A3"].Value = DateTime.Now;  // Date values
workSheet["A4"].Value = true;  // Boolean values
// Set month names in first row for annual budget spreadsheet
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";

// Set different data types - IronXL handles conversion automatically
workSheet["A2"].Value = 1500.50m;  // Decimal for currency
workSheet["A3"].Value = DateTime.Now;  // Date values
workSheet["A4"].Value = true;  // Boolean values
$vbLabelText   $csharpLabel

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

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

La configuración dinámica de valores es perfecta para aplicaciones basadas en datos:

// 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
$vbLabelText   $csharpLabel

La interpolación de cadenas ($"A{i}") facilita la referenciación dinámica de celdas. El indexador Range 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:

using System.Data;
using System.Data.SqlClient;
using IronXL;

// Database connection setup for retrieving sales data
string connectionString = @"Data Source=ServerName;Initial Catalog=SalesDB;Integrated Security=true";
string query = "SELECT ProductName, Quantity, UnitPrice, TotalSales FROM MonthlySales";

// Create DataSet to hold query results
DataSet salesData = new DataSet();

using (SqlConnection connection = new SqlConnection(connectionString))
using (SqlDataAdapter adapter = new SqlDataAdapter(query, connection))
{
    // Fill DataSet with sales information
    adapter.Fill(salesData);
}

// Write headers for database columns
workSheet["A1"].Value = "Product Name";
workSheet["B1"].Value = "Quantity";
workSheet["C1"].Value = "Unit Price";
workSheet["D1"].Value = "Total Sales";

// Apply header formatting
workSheet["A1:D1"].Style.Font.Bold = true;
workSheet["A1:D1"].Style.SetBackgroundColor("#4472C4");
workSheet["A1:D1"].Style.Font.FontColor = "#FFFFFF";

// Populate Excel with database records
DataTable salesTable = salesData.Tables[0];
for (int row = 0; row < salesTable.Rows.Count; row++)
{
    int excelRow = row + 2; // Start from row 2 (after headers)

    workSheet[$"A{excelRow}"].Value = salesTable.Rows[row]["ProductName"].ToString();
    workSheet[$"B{excelRow}"].Value = Convert.ToInt32(salesTable.Rows[row]["Quantity"]);
    workSheet[$"C{excelRow}"].Value = Convert.ToDecimal(salesTable.Rows[row]["UnitPrice"]);
    workSheet[$"D{excelRow}"].Value = Convert.ToDecimal(salesTable.Rows[row]["TotalSales"]);

    // Format currency columns
    workSheet[$"C{excelRow}"].FormatString = "$#,##0.00";
    workSheet[$"D{excelRow}"].FormatString = "$#,##0.00";
}

// Add summary row with formulas
int summaryRow = salesTable.Rows.Count + 2;
workSheet[$"A{summaryRow}"].Value = "TOTAL";
workSheet[$"B{summaryRow}"].Formula = $"=SUM(B2:B{summaryRow-1})";
workSheet[$"D{summaryRow}"].Formula = $"=SUM(D2:D{summaryRow-1})";
using System.Data;
using System.Data.SqlClient;
using IronXL;

// Database connection setup for retrieving sales data
string connectionString = @"Data Source=ServerName;Initial Catalog=SalesDB;Integrated Security=true";
string query = "SELECT ProductName, Quantity, UnitPrice, TotalSales FROM MonthlySales";

// Create DataSet to hold query results
DataSet salesData = new DataSet();

using (SqlConnection connection = new SqlConnection(connectionString))
using (SqlDataAdapter adapter = new SqlDataAdapter(query, connection))
{
    // Fill DataSet with sales information
    adapter.Fill(salesData);
}

// Write headers for database columns
workSheet["A1"].Value = "Product Name";
workSheet["B1"].Value = "Quantity";
workSheet["C1"].Value = "Unit Price";
workSheet["D1"].Value = "Total Sales";

// Apply header formatting
workSheet["A1:D1"].Style.Font.Bold = true;
workSheet["A1:D1"].Style.SetBackgroundColor("#4472C4");
workSheet["A1:D1"].Style.Font.FontColor = "#FFFFFF";

// Populate Excel with database records
DataTable salesTable = salesData.Tables[0];
for (int row = 0; row < salesTable.Rows.Count; row++)
{
    int excelRow = row + 2; // Start from row 2 (after headers)

    workSheet[$"A{excelRow}"].Value = salesTable.Rows[row]["ProductName"].ToString();
    workSheet[$"B{excelRow}"].Value = Convert.ToInt32(salesTable.Rows[row]["Quantity"]);
    workSheet[$"C{excelRow}"].Value = Convert.ToDecimal(salesTable.Rows[row]["UnitPrice"]);
    workSheet[$"D{excelRow}"].Value = Convert.ToDecimal(salesTable.Rows[row]["TotalSales"]);

    // Format currency columns
    workSheet[$"C{excelRow}"].FormatString = "$#,##0.00";
    workSheet[$"D{excelRow}"].FormatString = "$#,##0.00";
}

// Add summary row with formulas
int summaryRow = salesTable.Rows.Count + 2;
workSheet[$"A{summaryRow}"].Value = "TOTAL";
workSheet[$"B{summaryRow}"].Formula = $"=SUM(B2:B{summaryRow-1})";
workSheet[$"D{summaryRow}"].Formula = $"=SUM(D2:D{summaryRow-1})";
$vbLabelText   $csharpLabel

Este ejemplo demuestra la lectura de datos de Excel desde bases de datos, aplicando formato y usando fórmulas para cálculos. La propiedad FormatString permite el formato de números personalizado como en Excel.


¿Cómo aplico formato a las celdas de Excel?

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

El estilo de celdas mejora la legibilidad y el atractivo visual:

// 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");
    }
}
$vbLabelText   $csharpLabel

El método Style.SetBackgroundColor acepta códigos de color hexadecimales. Combina colores de fondo con colores de fuente para hojas de cálculo de apariencia profesional.

¿Cómo creo bordes en Excel?

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

using IronXL;
using IronXl.Styles;

// Create header border - thick bottom line to separate from data
workSheet["A1:L1"].Style.TopBorder.SetColor("#000000");
workSheet["A1:L1"].Style.TopBorder.Type = BorderType.Thick;
workSheet["A1:L1"].Style.BottomBorder.SetColor("#000000");
workSheet["A1:L1"].Style.BottomBorder.Type = BorderType.Thick;

// Add right border to last column
workSheet["L2:L11"].Style.RightBorder.SetColor("#000000");
workSheet["L2:L11"].Style.RightBorder.Type = BorderType.Medium;

// Create bottom border for data area
workSheet["A11:L11"].Style.BottomBorder.SetColor("#000000");
workSheet["A11:L11"].Style.BottomBorder.Type = BorderType.Medium;

// Apply complete border around summary section
var summaryRange = workSheet["A12:L12"];
summaryRange.Style.TopBorder.Type = BorderType.Double;
summaryRange.Style.BottomBorder.Type = BorderType.Double;
summaryRange.Style.LeftBorder.Type = BorderType.Thin;
summaryRange.Style.RightBorder.Type = BorderType.Thin;
summaryRange.Style.SetBorderColor("#0070C0"); // Blue borders
using IronXL;
using IronXl.Styles;

// Create header border - thick bottom line to separate from data
workSheet["A1:L1"].Style.TopBorder.SetColor("#000000");
workSheet["A1:L1"].Style.TopBorder.Type = BorderType.Thick;
workSheet["A1:L1"].Style.BottomBorder.SetColor("#000000");
workSheet["A1:L1"].Style.BottomBorder.Type = BorderType.Thick;

// Add right border to last column
workSheet["L2:L11"].Style.RightBorder.SetColor("#000000");
workSheet["L2:L11"].Style.RightBorder.Type = BorderType.Medium;

// Create bottom border for data area
workSheet["A11:L11"].Style.BottomBorder.SetColor("#000000");
workSheet["A11:L11"].Style.BottomBorder.Type = BorderType.Medium;

// Apply complete border around summary section
var summaryRange = workSheet["A12:L12"];
summaryRange.Style.TopBorder.Type = BorderType.Double;
summaryRange.Style.BottomBorder.Type = BorderType.Double;
summaryRange.Style.LeftBorder.Type = BorderType.Thin;
summaryRange.Style.RightBorder.Type = BorderType.Thin;
summaryRange.Style.SetBorderColor("#0070C0"); // Blue borders
$vbLabelText   $csharpLabel

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


How Do I Use Excel Formulas in C#?

IronXL proporciona soporte de fórmulas potentes con cálculo automático:

// Use built-in aggregation functions for ranges
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 calculated values to cells
workSheet["A12"].Value = sum;
workSheet["B12"].Value = avg;
workSheet["C12"].Value = max;
workSheet["D12"].Value = min;

// Or use Excel formulas directly
workSheet["A12"].Formula = "=SUM(A2:A11)";
workSheet["B12"].Formula = "=AVERAGE(B2:B11)";
workSheet["C12"].Formula = "=MAX(C2:C11)";
workSheet["D12"].Formula = "=MIN(D2:D11)";

// Complex formulas with multiple functions
workSheet["E12"].Formula = "=IF(SUM(E2:E11)>50000,\"Over Budget\",\"On Track\")";
workSheet["F12"].Formula = "=SUMIF(F2:F11,\">5000\")";

// Percentage calculations
workSheet["G12"].Formula = "=G11/SUM(G2:G11)*100";
workSheet["G12"].FormatString = "0.00%";

// Ensure all formulas calculate
workSheet.EvaluateAll();
// Use built-in aggregation functions for ranges
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 calculated values to cells
workSheet["A12"].Value = sum;
workSheet["B12"].Value = avg;
workSheet["C12"].Value = max;
workSheet["D12"].Value = min;

// Or use Excel formulas directly
workSheet["A12"].Formula = "=SUM(A2:A11)";
workSheet["B12"].Formula = "=AVERAGE(B2:B11)";
workSheet["C12"].Formula = "=MAX(C2:C11)";
workSheet["D12"].Formula = "=MIN(D2:D11)";

// Complex formulas with multiple functions
workSheet["E12"].Formula = "=IF(SUM(E2:E11)>50000,\"Over Budget\",\"On Track\")";
workSheet["F12"].Formula = "=SUMIF(F2:F11,\">5000\")";

// Percentage calculations
workSheet["G12"].Formula = "=G11/SUM(G2:G11)*100";
workSheet["G12"].FormatString = "0.00%";

// Ensure all formulas calculate
workSheet.EvaluateAll();
$vbLabelText   $csharpLabel

La clase Range proporciona métodos como Sum(), Avg(), Max() y Min() para cálculos rápidos. Para escenarios más complejos, utilice la propiedad Formula para configurar fórmulas de Excel directamente.

{t:(Prefiera los métodos integrados .Sum(), .Avg(), .Max() y .Min() de IronXL en lugar de cadenas de fórmulas sin formato cuando trabaje con rangos; son de tipo seguro y evitan errores de sintaxis de fórmulas.)}


¿Cómo configuro las propiedades de la hoja de cálculo y de impresión?

Usa IronXL para proteger hojas individuales, congelar filas y columnas, y establecer opciones de formato de impresión.

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

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

// Protect worksheet with password to prevent unauthorized changes
workSheet.ProtectSheet("SecurePassword123");

// Freeze panes to keep headers visible while scrolling
workSheet.CreateFreezePane(0, 1); // Freeze first row
// workSheet.CreateFreezePane(1, 1); // Freeze first row and column

// Set worksheet visibility options
workSheet.ViewState = WorkSheetViewState.Visible; // or Hidden, VeryHidden

// Configure gridlines and headers
workSheet.ShowGridLines = true;
workSheet.ShowRowColHeaders = true;

// Set zoom level for better viewing
workSheet.Zoom = 85; // 85% zoom
// Protect worksheet with password to prevent unauthorized changes
workSheet.ProtectSheet("SecurePassword123");

// Freeze panes to keep headers visible while scrolling
workSheet.CreateFreezePane(0, 1); // Freeze first row
// workSheet.CreateFreezePane(1, 1); // Freeze first row and column

// Set worksheet visibility options
workSheet.ViewState = WorkSheetViewState.Visible; // or Hidden, VeryHidden

// Configure gridlines and headers
workSheet.ShowGridLines = true;
workSheet.ShowRowColHeaders = true;

// Set zoom level for better viewing
workSheet.Zoom = 85; // 85% zoom
$vbLabelText   $csharpLabel

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

Hoja de cálculo de Excel que muestra una fila de encabezado congelada con datos del presupuesto mensual

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

Cuadro de diálogo de protección de Excel que requiere contraseña para modificar la hoja de cálculo protegida

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

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

Configura opciones de impresión profesionales a través de IronXL's:

using IronXl.Printing;

// Define print area to exclude empty cells
workSheet.SetPrintArea("A1:L12");

// Configure page orientation for wide data
workSheet.PrintSetup.PrintOrientation = PrintOrientation.Landscape;

// Set paper size for standard printing
workSheet.PrintSetup.PaperSize = PaperSize.A4;

// Adjust margins for better layout (in inches)
workSheet.PrintSetup.LeftMargin = 0.5;
workSheet.PrintSetup.RightMargin = 0.5;
workSheet.PrintSetup.TopMargin = 0.75;
workSheet.PrintSetup.BottomMargin = 0.75;

// Configure header and footer
workSheet.PrintSetup.HeaderMargin = 0.3;
workSheet.PrintSetup.FooterMargin = 0.3;

// Scale to fit on one page
workSheet.PrintSetup.FitToPage = true;
workSheet.PrintSetup.FitToHeight = 1;
workSheet.PrintSetup.FitToWidth = 1;

// Add print headers/footers
workSheet.Header.Center = "Monthly Budget Report";
workSheet.Footer.Left = DateTime.Now.ToShortDateString();
workSheet.Footer.Right = "Page &P of &N"; // Page numbering
using IronXl.Printing;

// Define print area to exclude empty cells
workSheet.SetPrintArea("A1:L12");

// Configure page orientation for wide data
workSheet.PrintSetup.PrintOrientation = PrintOrientation.Landscape;

// Set paper size for standard printing
workSheet.PrintSetup.PaperSize = PaperSize.A4;

// Adjust margins for better layout (in inches)
workSheet.PrintSetup.LeftMargin = 0.5;
workSheet.PrintSetup.RightMargin = 0.5;
workSheet.PrintSetup.TopMargin = 0.75;
workSheet.PrintSetup.BottomMargin = 0.75;

// Configure header and footer
workSheet.PrintSetup.HeaderMargin = 0.3;
workSheet.PrintSetup.FooterMargin = 0.3;

// Scale to fit on one page
workSheet.PrintSetup.FitToPage = true;
workSheet.PrintSetup.FitToHeight = 1;
workSheet.PrintSetup.FitToWidth = 1;

// Add print headers/footers
workSheet.Header.Center = "Monthly Budget Report";
workSheet.Footer.Left = DateTime.Now.ToShortDateString();
workSheet.Footer.Right = "Page &P of &N"; // Page numbering
$vbLabelText   $csharpLabel

La clase PrintSetup proporciona opciones de configuración de impresión integrales que coinciden con la configuración de impresión de Excel.

Vista previa de impresión de Excel que muestra la orientación horizontal y la configuración del tamaño de papel A4

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


¿Cómo guardo mi libro de Excel?

Guarda tu libro en varios formatos:

// Save as XLSX (recommended for modern Excel)
workBook.SaveAs("Budget.xlsx");

// Save as XLS for legacy compatibility
workBook.SaveAs("Budget.xls");

// Save as CSV for data exchange
workBook.SaveAsCsv("Budget.csv");

// Save as JSON for web applications
workBook.SaveAsJson("Budget.json");

// Save to stream for web downloads or cloud storage
using (var stream = new MemoryStream())
{
    workBook.SaveAs(stream);
    byte[] excelData = stream.ToArray();
    // Send to client or save to cloud
}

// Save with specific encoding for international characters
workBook.SaveAsCsv("Budget_UTF8.csv", System.Text.Encoding.UTF8);
// Save as XLSX (recommended for modern Excel)
workBook.SaveAs("Budget.xlsx");

// Save as XLS for legacy compatibility
workBook.SaveAs("Budget.xls");

// Save as CSV for data exchange
workBook.SaveAsCsv("Budget.csv");

// Save as JSON for web applications
workBook.SaveAsJson("Budget.json");

// Save to stream for web downloads or cloud storage
using (var stream = new MemoryStream())
{
    workBook.SaveAs(stream);
    byte[] excelData = stream.ToArray();
    // Send to client or save to cloud
}

// Save with specific encoding for international characters
workBook.SaveAsCsv("Budget_UTF8.csv", System.Text.Encoding.UTF8);
$vbLabelText   $csharpLabel

IronXL admite múltiples formatos de exportación incluidos XLSX, XLS, CSV, TSV y JSON. El método SaveAs determina automáticamente el formato a partir de la extensión del archivo.

  • XLSX / XLS : formato Excel completo con formato, fórmulas y varias hojas
  • CSV : Texto sin formato para intercambio de datos: exporta una hoja por archivo
  • JSON : Salida estructurada para API web y canalizaciones de datos
  • Transmisión : para salida en memoria, útil para descargas web o almacenamiento en la nube

Resumen

Este tutorial demostró cómo crear archivos Excel en C# sin dependencias de Microsoft Office usando IronXL . Aprendiste operaciones esenciales de Excel incluyendo la creación de libros, manipulación de celdas, formato, uso de fórmulas y varias opciones de guardado. La API intuitiva de IronXL hace que la automatización de Excel sea sencilla para los desarrolladores de .NET.

Para funciones más avanzadas, explora la fusión de celdas y la creación de gráficos. ¿Listo para usar IronXL en producción? Empieza tu prueba gratuita o ve las opciones de licencias.

¿Qué sigue?

Ahora que puede crear archivos Excel en C#, explore estas características relacionadas de IronXL:


Tutorial de acceso rápido

Logotipo de Visual Studio
### Descargue este tutorial como código fuente de C#

El código fuente C# completo para crear archivos Excel está disponible como un archivo de proyecto de Visual Studio.

Descargar
### Explora este tutorial en GitHub

El código fuente de este proyecto está disponible en C# y VB.NET en GitHub.

Utilice este código para empezar fácilmente a crear archivos de Excel en tan solo unos minutos. El proyecto se guarda como un proyecto de Microsoft Visual Studio, pero es compatible con cualquier IDE .NET.

Crear archivos de Excel en C# en GitHub
Logotipo de GitHub
Icono de documentación de la API
### Lea la referencia de la API de IronXL

Explore la Referencia de API para IronXL, que detalla todas las características, espacios de nombres, clases, métodos y propiedades para una manipulación integral de Excel en .NET.

Ver la referencia de la API

Preguntas Frecuentes

¿Cómo puedo crear archivos de Excel en C# sin usar Interop?

Puedes crear archivos de Excel sin Interop usando IronXL, que proporciona una API sencilla: WorkBook workBook = WorkBook.Create(ExcelFileFormat.XLSX). Este enfoque funciona en cualquier plataforma .NET sin requerir la instalación de Microsoft Office.

¿Qué plataformas son compatibles con la creación de archivos de Excel con C#?

IronXL es compatible con la creación de archivos Excel en .NET 10, .NET 9, .NET 8, .NET Core, .NET Framework 4.6.2+, funcionando en entornos de Windows, macOS, Linux, Docker, Azure y AWS.

¿Cómo instalo una biblioteca C# para la generación de Excel?

Instala IronXL a través del Administrador de Paquetes NuGet en Visual Studio, usa el comando PM> Install-Package IronXl.Excel, o descárgalo directamente desde nuget.org.

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

Crea un libro usando IronXL con WorkBook workbook = WorkBook.Create(ExcelFileFormat.XLSX), luego añade hojas de trabajo usando workbook.CreateWorkSheet("SheetName").

¿Cómo puedo establecer valores de celdas en una hoja de Excel usando C#?

Establece valores de celdas en IronXL usando una sintaxis intuitiva: worksheet["A1"].Value = "Hello World" o establece rangos: worksheet["A1:A10"].Value = 100.

¿Puedo aplicar formato a las celdas de Excel programáticamente?

Sí, IronXL admite un formato integral que incluye colores de fondo (cell.Style.SetBackgroundColor("#FF0000")), bordes, fuentes y formatos de números.

¿Cómo uso fórmulas de Excel en C#?

Aplica fórmulas usando la propiedad Formula de IronXL: worksheet["A1"].Formula = "=SUM(B1:B10)", o usa métodos integrados como range.Sum(), range.Avg().

¿Cómo puedo proteger una hoja de Excel con una contraseña?

Protege hojas en IronXL usando worksheet.ProtectSheet("YourPassword") para prevenir modificaciones no autorizadas.

¿Cómo configuro las configuraciones de impresión para archivos de Excel?

Establece propiedades de impresión usando PrintSetup de IronXL: worksheet.PrintSetup.PrintOrientation = PrintOrientation.Landscape y worksheet.SetPrintArea("A1:Z100").

¿Cómo guardo un libro de Excel en diferentes formatos?

Guarda libros usando el método SaveAs de IronXL: workbook.SaveAs("file.xlsx") para XLSX, o utiliza SaveAsCsv(), SaveAsJson() para otros formatos.

¿Cómo lleno una hoja de Excel con datos de una base de datos?

Utiliza IronXL para llenar hojas de trabajo obteniendo datos de una base de datos y estableciéndolos en celdas mediante métodos como worksheet["A1"].Value = dataFromDatabase.

¿Cómo puedo implementar paneles congelados en una hoja de Excel usando C#?

Congela paneles en hojas de trabajo usando IronXL con worksheet.FreezePanes(1, 1) para bloquear la fila superior y la columna más a la izquierda para una navegación más fácil.

Jacob Mellor, Director de Tecnología @ Team Iron
Director de Tecnología

Jacob Mellor es Director de Tecnología de Iron Software y un ingeniero visionario pionero en la tecnología C# PDF. Como desarrollador original de la base de código principal de Iron Software, ha dado forma a la arquitectura de productos de la empresa desde su creación, ...

Leer más

A PHP Error was encountered

Severity: Notice

Message: Undefined index: IronXl.Excel

Filename: helpers/counter_helper.php

Line Number: 85

Backtrace:

File: /var/www/ironpdf.com/application/helpers/counter_helper.php
Line: 85
Function: _error_handler

File: /var/www/ironpdf.com/application/views/main/sections/ready_to_started_202509.php
Line: 12
Function: getTotalDonwloadNumber

File: /var/www/ironpdf.com/application/libraries/Render.php
Line: 489
Function: view

File: /var/www/ironpdf.com/application/controllers/Products/Tutorials.php
Line: 29
Function: render_products_view

File: /var/www/ironpdf.com/index.php
Line: 292
Function: require_once

A PHP Error was encountered

Severity: Notice

Message: Undefined index: IronXl.Excel

Filename: helpers/counter_helper.php

Line Number: 85

Backtrace:

File: /var/www/ironpdf.com/application/helpers/counter_helper.php
Line: 85
Function: _error_handler

File: /var/www/ironpdf.com/application/views/main/sections/ready_to_started_202509.php
Line: 19
Function: getTotalDonwloadNumber

File: /var/www/ironpdf.com/application/libraries/Render.php
Line: 489
Function: view

File: /var/www/ironpdf.com/application/controllers/Products/Tutorials.php
Line: 29
Function: render_products_view

File: /var/www/ironpdf.com/index.php
Line: 292
Function: require_once

¿Listo para empezar?
Nuget Descargas 1,890,100 | Versión: 2026.3 recién lanzado

A PHP Error was encountered

Severity: Notice

Message: Undefined index: IronXl.Excel

Filename: helpers/counter_helper.php

Line Number: 85

Backtrace:

File: /var/www/ironpdf.com/application/helpers/counter_helper.php
Line: 85
Function: _error_handler

File: /var/www/ironpdf.com/application/views/main/sections/still_scrolling_202512.php
Line: 17
Function: getTotalDonwloadNumber

File: /var/www/ironpdf.com/application/views/products/sections/three_column_docs_page_structure.php
Line: 71
Function: view

File: /var/www/ironpdf.com/application/libraries/Render.php
Line: 88
Function: view

File: /var/www/ironpdf.com/application/views/products/tutorials/index.php
Line: 2
Function: view

File: /var/www/ironpdf.com/application/libraries/Render.php
Line: 88
Function: view

File: /var/www/ironpdf.com/application/libraries/Render.php
Line: 552
Function: view

File: /var/www/ironpdf.com/application/controllers/Products/Tutorials.php
Line: 29
Function: render_products_view

File: /var/www/ironpdf.com/index.php
Line: 292
Function: require_once

A PHP Error was encountered

Severity: Notice

Message: Undefined index: IronXl.Excel

Filename: helpers/counter_helper.php

Line Number: 85

Backtrace:

File: /var/www/ironpdf.com/application/helpers/counter_helper.php
Line: 85
Function: _error_handler

File: /var/www/ironpdf.com/application/views/main/sections/still_scrolling_202512.php
Line: 24
Function: getTotalDonwloadNumber

File: /var/www/ironpdf.com/application/views/products/sections/three_column_docs_page_structure.php
Line: 71
Function: view

File: /var/www/ironpdf.com/application/libraries/Render.php
Line: 88
Function: view

File: /var/www/ironpdf.com/application/views/products/tutorials/index.php
Line: 2
Function: view

File: /var/www/ironpdf.com/application/libraries/Render.php
Line: 88
Function: view

File: /var/www/ironpdf.com/application/libraries/Render.php
Line: 552
Function: view

File: /var/www/ironpdf.com/application/controllers/Products/Tutorials.php
Line: 29
Function: render_products_view

File: /var/www/ironpdf.com/index.php
Line: 292
Function: require_once

Still Scrolling Icon

¿Aún desplazándote?

¿Quieres una prueba rápida? PM > Install-Package IronXl.Excel
ejecuta una muestra observa cómo tus datos se convierten en una hoja de cálculo.