Cómo importar Excel a GridView en ASP.NET C#

¿Cómo se instala IronXL para la integración de GridView en Excel?

Antes de escribir cualquier código, debe añadir IronXL a su proyecto ASP.NET. La forma más rápida es a través de NuGet, ya sea desde la consola del Administrador de paquetes de Visual Studio o desde la CLI de .NET.

Install-Package IronXL
dotnet add package IronXL

Install-Package IronXL
dotnet add package IronXL

Una vez instalado, NuGet añade todas las referencias necesarias a tu proyecto. No hay que instalar controladores externos, ni registrar proveedores OLEDB, ni existe dependencia de Microsoft Office en el servidor. La biblioteca se distribuye como un único ensamblado gestionado y funciona en Windows, Linux, macOS y entornos de alojamiento en la nube, incluido Azure App Service.

Tras la instalación, añada los siguientes espacios de nombres a cualquier archivo de código subyacente que lea o escriba datos de Excel:

using IronXL;
using System.Data;
using System.IO;

using IronXL;
using System.Data;
using System.IO;

Imports IronXL
Imports System.Data
Imports System.IO

IronXL es compatible tanto con el formato .xls (Excel 97-2003) como con el .xlsx (Excel 2007+), por lo que no es necesario un tratamiento diferente para cada tipo de archivo. La misma llamada WorkBook.Load gestiona cualquiera de los dos formatos inspeccionando automáticamente la firma del archivo.

¿Cuál es la forma más rápida de cargar datos de Excel en un GridView?

El método más rápido combina WorkBook.Load, sheet.ToDataTable y GridView.DataBind en unas cuatro líneas de código efectivo. En los escenarios básicos no es necesario crear columnas manualmente ni iterar por las filas.

using IronXL;
using System.Data;

WorkBook workBook = WorkBook.Load("data.xlsx");
WorkSheet sheet = workBook.DefaultWorkSheet;

// true = treat first row as column headers
DataTable dataTable = sheet.ToDataTable(true);

GridView1.DataSource = dataTable;
GridView1.DataBind();

using IronXL;
using System.Data;

WorkBook workBook = WorkBook.Load("data.xlsx");
WorkSheet sheet = workBook.DefaultWorkSheet;

// true = treat first row as column headers
DataTable dataTable = sheet.ToDataTable(true);

GridView1.DataSource = dataTable;
GridView1.DataBind();

Imports IronXL
Imports System.Data

Dim workBook As WorkBook = WorkBook.Load("data.xlsx")
Dim sheet As WorkSheet = workBook.DefaultWorkSheet

' True = treat first row as column headers
Dim dataTable As DataTable = sheet.ToDataTable(True)

GridView1.DataSource = dataTable
GridView1.DataBind()

La llamada ToDataTable(true) indica a IronXL que convierta la primera fila de la hoja de cálculo en nombres de columna en el resultado DataTable. Cuando vinculas esa tabla a un GridView con AutoGenerateColumns="true", ASP.NET crea automáticamente una columna por cada encabezado de Excel.

¿Cómo se crea una página de formularios web ASP.NET para importar Excel?

Una página de importación mínima necesita tres controles: un campo de carga de archivos, un botón de envío y el GridView. Añade el siguiente código ASPX dentro de tu elemento <form runat="server">:

<asp:FileUpload ID="FileUpload1" runat="server" />
<asp:Button ID="btnUpload" runat="server" Text="Upload Excel File"
    OnClick="btnUpload_Click" />
<asp:GridView ID="GridView1" runat="server" AutoGenerateColumns="true"
    CssClass="table table-bordered" />

<asp:FileUpload ID="FileUpload1" runat="server" />
<asp:Button ID="btnUpload" runat="server" Text="Upload Excel File"
    OnClick="btnUpload_Click" />
<asp:GridView ID="GridView1" runat="server" AutoGenerateColumns="true"
    CssClass="table table-bordered" />

<asp:FileUpload ID="FileUpload1" runat="server" />
<asp:Button ID="btnUpload" runat="server" Text="Upload Excel File" OnClick="btnUpload_Click" />
<asp:GridView ID="GridView1" runat="server" AutoGenerateColumns="true" CssClass="table table-bordered" />

El atributo CssClass integra la cuadrícula en tu hoja de estilos de Bootstrap, si estás utilizando una, lo que te proporciona filas y bordes con estilo sin necesidad de configuración adicional.

En el código subyacente, gestiona el evento de clic del botón. El siguiente patrón guarda el archivo cargado en una ruta temporal del servidor, lo carga con IronXL y vincula el resultado DataTable a la cuadrícula:

using IronXL;
using System.Data;
using System.IO;

void btnUpload_Click(object sender, EventArgs e)
{
    if (!FileUpload1.HasFile) return;

    string uploadDir = Server.MapPath("~/Uploads/");
    Directory.CreateDirectory(uploadDir); // ensure directory exists

    string filePath = Path.Combine(uploadDir, Path.GetFileName(FileUpload1.FileName));
    FileUpload1.SaveAs(filePath);

    WorkBook workBook = WorkBook.Load(filePath);
    WorkSheet sheet = workBook.DefaultWorkSheet;
    DataTable dt = sheet.ToDataTable(true);

    GridView1.DataSource = dt;
    GridView1.DataBind();

    // Store for later export operations
    Session["CurrentData"] = dt;
}

using IronXL;
using System.Data;
using System.IO;

void btnUpload_Click(object sender, EventArgs e)
{
    if (!FileUpload1.HasFile) return;

    string uploadDir = Server.MapPath("~/Uploads/");
    Directory.CreateDirectory(uploadDir); // ensure directory exists

    string filePath = Path.Combine(uploadDir, Path.GetFileName(FileUpload1.FileName));
    FileUpload1.SaveAs(filePath);

    WorkBook workBook = WorkBook.Load(filePath);
    WorkSheet sheet = workBook.DefaultWorkSheet;
    DataTable dt = sheet.ToDataTable(true);

    GridView1.DataSource = dt;
    GridView1.DataBind();

    // Store for later export operations
    Session["CurrentData"] = dt;
}

Imports IronXL
Imports System.Data
Imports System.IO

Sub btnUpload_Click(sender As Object, e As EventArgs)
    If Not FileUpload1.HasFile Then Return

    Dim uploadDir As String = Server.MapPath("~/Uploads/")
    Directory.CreateDirectory(uploadDir) ' ensure directory exists

    Dim filePath As String = Path.Combine(uploadDir, Path.GetFileName(FileUpload1.FileName))
    FileUpload1.SaveAs(filePath)

    Dim workBook As WorkBook = WorkBook.Load(filePath)
    Dim sheet As WorkSheet = workBook.DefaultWorkSheet
    Dim dt As DataTable = sheet.ToDataTable(True)

    GridView1.DataSource = dt
    GridView1.DataBind()

    ' Store for later export operations
    Session("CurrentData") = dt
End Sub

Esta implementación sigue el estilo de sentencias de nivel superior para la lógica dentro del controlador de eventos, al tiempo que conserva la firma de evento requerida de Web Forms. Tenga en cuenta que Directory.CreateDirectory se invoca de forma defensiva: si la carpeta Uploads ya existe, la llamada no produce ningún efecto.

Una vez que el usuario selecciona un archivo .xlsx y hace clic en el botón de carga, la cuadrícula se rellena con el contenido de la hoja de cálculo. Los nombres de las columnas provienen de la primera fila del archivo de Excel, y todas las filas siguientes se convierten en filas de datos en la cuadrícula.

string ext = Path.GetExtension(FileUpload1.FileName).ToLowerInvariant();
string[] allowed = { ".xls", ".xlsx" };

if (!allowed.Contains(ext))
{
    lblError.Text = "Only .xls and .xlsx files are accepted.";
    return;
}

string ext = Path.GetExtension(FileUpload1.FileName).ToLowerInvariant();
string[] allowed = { ".xls", ".xlsx" };

if (!allowed.Contains(ext))
{
    lblError.Text = "Only .xls and .xlsx files are accepted.";
    return;
}

Imports System.IO

Dim ext As String = Path.GetExtension(FileUpload1.FileName).ToLowerInvariant()
Dim allowed As String() = {".xls", ".xlsx"}

If Not allowed.Contains(ext) Then
    lblError.Text = "Only .xls and .xlsx files are accepted."
    Return
End If

¿Cómo se accede a hojas de cálculo y rangos de celdas específicos?

Cuando un libro de Excel contiene varias hojas, es necesario seleccionar una específica por su nombre en lugar de utilizar DefaultWorkSheet. IronXL proporciona un método GetWorkSheet que acepta el nombre de la pestaña de la hoja como una cadena.

using IronXL;
using System.Data;

WorkBook workBook = WorkBook.Load("sales-report.xlsx");

// Access a named sheet
WorkSheet salesSheet = workBook.GetWorkSheet("Q4 Sales");

// Read a specific cell range
var topTen = salesSheet["A1:E11"];

// Convert the entire workbook to a DataSet (one DataTable per sheet)
DataSet allSheets = workBook.ToDataSet();

// Bind the first sheet's DataTable to the grid
GridView1.DataSource = allSheets.Tables[0];
GridView1.DataBind();

using IronXL;
using System.Data;

WorkBook workBook = WorkBook.Load("sales-report.xlsx");

// Access a named sheet
WorkSheet salesSheet = workBook.GetWorkSheet("Q4 Sales");

// Read a specific cell range
var topTen = salesSheet["A1:E11"];

// Convert the entire workbook to a DataSet (one DataTable per sheet)
DataSet allSheets = workBook.ToDataSet();

// Bind the first sheet's DataTable to the grid
GridView1.DataSource = allSheets.Tables[0];
GridView1.DataBind();

Imports IronXL
Imports System.Data

Dim workBook As WorkBook = WorkBook.Load("sales-report.xlsx")

' Access a named sheet
Dim salesSheet As WorkSheet = workBook.GetWorkSheet("Q4 Sales")

' Read a specific cell range
Dim topTen = salesSheet("A1:E11")

' Convert the entire workbook to a DataSet (one DataTable per sheet)
Dim allSheets As DataSet = workBook.ToDataSet()

' Bind the first sheet's DataTable to the grid
GridView1.DataSource = allSheets.Tables(0)
GridView1.DataBind()

El método ToDataSet resulta útil cuando su aplicación necesita mostrar datos de varias hojas o permitir al usuario elegir qué hoja desea ver. Cada DataTable en el DataSet devuelto corresponde a una hoja de cálculo de Excel, y el nombre de la tabla coincide con el nombre de la pestaña de la hoja.

DataTable dt = sheet.ToDataTable(true);
DataView dv = new DataView(dt)
{
    RowFilter = "Status = 'Active'"
};

GridView1.DataSource = dv;
GridView1.DataBind();

DataTable dt = sheet.ToDataTable(true);
DataView dv = new DataView(dt)
{
    RowFilter = "Status = 'Active'"
};

GridView1.DataSource = dv;
GridView1.DataBind();

Dim dt As DataTable = sheet.ToDataTable(True)
Dim dv As New DataView(dt) With {
    .RowFilter = "Status = 'Active'"
}

GridView1.DataSource = dv
GridView1.DataBind()

¿Cómo se comparan los métodos de importación para el enlace de Excel GridView?

Los diferentes enfoques para el enlace de Excel a GridView presentan distintas ventajas e inconvenientes. La tabla siguiente resume los métodos más comunes para que puedas elegir el más adecuado para tu caso.

IronXL es compatible tanto con el formato XLS heredado como con el moderno XLSX, no requiere la instalación de controladores del lado del servidor y ofrece la menor complejidad de código de entre las opciones enumeradas. Para los equipos que ya utilizan otros productos de Iron Software, como IronPDF o IronOCR, una única licencia de Iron Software cubre toda la suite.

¿Cómo se exportan los datos de GridView de vuelta a Excel?

Completar el ciclo completo —de Excel a una tabla y de vuelta a Excel— es igual de sencillo con IronXL. Este patrón es útil para los botones "descargar como Excel" que permiten a los usuarios exportar lo que se muestra actualmente en la cuadrícula.

void btnExport_Click(object sender, EventArgs e)
{
    DataTable dt = Session["CurrentData"] as DataTable;
    if (dt == null) return;

    WorkBook workBook = WorkBook.Create(ExcelFileFormat.XLSX);
    WorkSheet ws = workBook.CreateWorkSheet("Export");

    // Write header row
    for (int col = 0; col < dt.Columns.Count; col++)
        ws.SetCellValue(0, col, dt.Columns[col].ColumnName);

    // Write data rows
    for (int row = 0; row < dt.Rows.Count; row++)
        for (int col = 0; col < dt.Columns.Count; col++)
            ws.SetCellValue(row + 1, col, dt.Rows[row][col]?.ToString() ?? string.Empty);

    string exportDir = Server.MapPath("~/Exports/");
    Directory.CreateDirectory(exportDir);
    string exportPath = Path.Combine(exportDir, "export.xlsx");
    workBook.SaveAs(exportPath);

    Response.Clear();
    Response.ContentType = "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet";
    Response.AddHeader("Content-Disposition", "attachment; filename=export.xlsx");
    Response.TransmitFile(exportPath);
    Response.End();
}

void btnExport_Click(object sender, EventArgs e)
{
    DataTable dt = Session["CurrentData"] as DataTable;
    if (dt == null) return;

    WorkBook workBook = WorkBook.Create(ExcelFileFormat.XLSX);
    WorkSheet ws = workBook.CreateWorkSheet("Export");

    // Write header row
    for (int col = 0; col < dt.Columns.Count; col++)
        ws.SetCellValue(0, col, dt.Columns[col].ColumnName);

    // Write data rows
    for (int row = 0; row < dt.Rows.Count; row++)
        for (int col = 0; col < dt.Columns.Count; col++)
            ws.SetCellValue(row + 1, col, dt.Rows[row][col]?.ToString() ?? string.Empty);

    string exportDir = Server.MapPath("~/Exports/");
    Directory.CreateDirectory(exportDir);
    string exportPath = Path.Combine(exportDir, "export.xlsx");
    workBook.SaveAs(exportPath);

    Response.Clear();
    Response.ContentType = "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet";
    Response.AddHeader("Content-Disposition", "attachment; filename=export.xlsx");
    Response.TransmitFile(exportPath);
    Response.End();
}

Imports System
Imports System.Data
Imports System.IO

Sub btnExport_Click(sender As Object, e As EventArgs)
    Dim dt As DataTable = TryCast(Session("CurrentData"), DataTable)
    If dt Is Nothing Then Return

    Dim workBook As WorkBook = WorkBook.Create(ExcelFileFormat.XLSX)
    Dim ws As WorkSheet = workBook.CreateWorkSheet("Export")

    ' Write header row
    For col As Integer = 0 To dt.Columns.Count - 1
        ws.SetCellValue(0, col, dt.Columns(col).ColumnName)
    Next

    ' Write data rows
    For row As Integer = 0 To dt.Rows.Count - 1
        For col As Integer = 0 To dt.Columns.Count - 1
            ws.SetCellValue(row + 1, col, If(dt.Rows(row)(col)?.ToString(), String.Empty))
        Next
    Next

    Dim exportDir As String = Server.MapPath("~/Exports/")
    Directory.CreateDirectory(exportDir)
    Dim exportPath As String = Path.Combine(exportDir, "export.xlsx")
    workBook.SaveAs(exportPath)

    Response.Clear()
    Response.ContentType = "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet"
    Response.AddHeader("Content-Disposition", "attachment; filename=export.xlsx")
    Response.TransmitFile(exportPath)
    Response.End()
End Sub

La llamada Response.TransmitFile transmite el archivo guardado al navegador, lo que activa un cuadro de diálogo de descarga. El encabezado Content-Disposition: attachment garantiza que los navegadores descarguen el archivo en lugar de intentar mostrarlo en línea.

// Bold the header row
ws["A1:Z1"].Style.Font.Bold = true;

// Apply a currency format to column C (index 2), rows 2 onward
ws[$"C2:C{dt.Rows.Count + 1}"].FormatString = IronXL.Styles.BuiltinFormats.Accounting2;

// Auto-fit column widths (IronXL approximates based on content length)
ws.AutoSizeColumn(0);
ws.AutoSizeColumn(1);

// Bold the header row
ws["A1:Z1"].Style.Font.Bold = true;

// Apply a currency format to column C (index 2), rows 2 onward
ws[$"C2:C{dt.Rows.Count + 1}"].FormatString = IronXL.Styles.BuiltinFormats.Accounting2;

// Auto-fit column widths (IronXL approximates based on content length)
ws.AutoSizeColumn(0);
ws.AutoSizeColumn(1);

' Bold the header row
ws("A1:Z1").Style.Font.Bold = True

' Apply a currency format to column C (index 2), rows 2 onward
ws($"C2:C{dt.Rows.Count + 1}").FormatString = IronXL.Styles.BuiltinFormats.Accounting2

' Auto-fit column widths (IronXL approximates based on content length)
ws.AutoSizeColumn(0)
ws.AutoSizeColumn(1)

¿Cuales son tus próximos pasos?

Ahora dispone de un proceso completo y sin controladores para importar archivos de Excel a un GridView de ASP.NET y exportar los datos del GridView de vuelta a Excel utilizando IronXL. Esto es lo que hay que explorar a continuación para seguir construyendo sobre esta base:

• Lea la documentación de IronXL para consultar la referencia completa de la API, que incluye la evaluación de fórmulas, las operaciones con rangos de celdas y la creación de gráficos.
• Explora la biblioteca de ejemplos de código de IronXL para encontrar fragmentos listos para ejecutar que abarcan la importación de CSV, libros protegidos con contraseña, formato condicional y mucho más.
• Prueba el tutorial de Excel a DataTable si deseas una explicación más detallada sobre la asignación de columnas tipadas y el manejo de valores nulos.
• Consulte la página de licencias de IronXL para ver las opciones, desde licencias de desarrollo hasta redistribución OEM.
• Consulte la guía de lectura de Excel for .NET de Iron Software para comprender en detalle la navegación por libros y hojas de cálculo.
• Compare IronXL con otras alternativas utilizando la comparación de bibliotecas de Excel para C#, que ofrece un desglose característica por característica frente a OLEDB, EPPlus y el SDK de Open XML.

Para las aplicaciones .NET Core y ASP.NET Core, la misma API de IronXL funciona tanto en Razor Pages como en controladores MVC. La guía de IronXL para ASP.NET Core explica las diferencias en el manejo de la carga de archivos y los patrones de inyección de dependencias.

Si está integrando IronXL junto con la generación de documentos, la guía de integración de IronPDF muestra cómo exportar datos de GridView a un informe PDF además de a Excel, lo cual resulta útil para aplicaciones que necesitan ambos formatos.

Empieza con la prueba gratuita de IronXL para probar todas las funciones en tu proyecto antes de comprarlo. No se requiere tarjeta de crédito para la Licencia Trial.