Leer archivos Excel en ASP.NET MVC usando C# con IronXL
IronXL permite a los desarrolladores de ASP.NET MVC leer archivos Excel directamente en C# sin dependencias de Microsoft Office, convirtiendo los datos de Excel a System.Data.DataTable para facilitar la visualización en vistas web con solo unas pocas líneas de código.
Este ejemplo muestra cómo comenzar en segundos: cargar un libro de Excel, seleccionar su primera hoja de trabajo y convertirla en un System.Data.DataTable usando IronXL, sin Interop ni complicaciones.
-
1Instalar IronXL con NuGet Package Manager
-
2Copie y ejecute este fragmento de código.
var dataTable = IronXL.WorkBook.Load("CustomerData.xlsx").DefaultWorkSheet.ToDataTable(true);Dim dataTable = WorkBook.Load("CustomerData.xlsx").DefaultWorkSheet.ToDataTable(True)Dim dataTable = WorkBook.Load("CustomerData.xlsx").DefaultWorkSheet.ToDataTable(True) -
3Despliegue para probar en su entorno real
Empiece a usar IronXL en su proyecto hoy con una prueba gratuita
Flujo de trabajo mínimo (5 pasos)
- Instalar biblioteca C# para leer archivos Excel en ASP.NET
- Cargar y acceder a la hoja objetivo en el archivo Excel
- Acceda al método
ToDataTabley devuélvalo aView - Mostrar datos de Excel en una página web mediante un bucle
- Recorre todos los datos y construye una tabla HTML
¿Cómo crear un proyecto ASP.NET para leer en Excel?
¿Por qué Visual Studio 2022 funciona mejor para esto?
Con Visual Studio 2022, cree un nuevo proyecto ASP.NET. Visual Studio 2022 proporciona excelente soporte para los frameworks .NET 6+, mejora IntelliSense para los métodos IronXL, y mejor rendimiento al trabajar con archivos Excel grandes. La integración de NuGet en el IDE hace que la instalación de IronXL sea particularmente sencilla.
¿Qué plantilla de proyecto debo elegir?
Para leer archivos Excel en ASP.NET, elija la plantilla "ASP.NET Core Web App (Model-View-Controller)". Esta plantilla ofrece una estructura MVC limpia que separa el procesamiento de datos (lectura de Excel) de la lógica de presentación. El patrón MVC funciona perfectamente con la conversión IronXL de DataTable, lo que permite cargar hojas de cálculo en controladores y mostrarlas en vistas.
¿Qué versión de .NET se recomienda?
IronXL funciona con .NET Framework 4.6.2+ y .NET Core 3.1+. Para los nuevos proyectos ASP.NET MVC, utilice .NET 6.0 o superior para obtener un rendimiento y una seguridad óptimos. Estas versiones ofrecen una mejor gestión de la memoria al procesar grandes archivos de Excel y un mejor soporte async/await para convertir tipos de archivos de hojas de cálculo.
¿Cómo instalo la biblioteca IronXL?
¿Cuáles son los requisitos de instalación?
¿Qué método de instalación es más rápido?
Después de crear el nuevo proyecto, instale la biblioteca IronXL. Siga estos pasos para instalar IronXL. Abre la Consola del Administrador de Paquetes NuGet y ejecuta el siguiente comando:
¿Cómo puedo verificar la instalación?
Para verificar que IronXL está correctamente instalado, revise las dependencias de su proyecto en el Explorador de Soluciones. Debería ver "IronXL" en la lista de "Dependencias > Paquetes". Además, intente agregar using IronXL; en la parte superior de su archivo de controlador; IntelliSense debería reconocer el espacio de nombres inmediatamente. Para resolver problemas de instalación, visite la guía de licenciamiento.
¿Cómo leo un archivo Excel en mi controlador?
¿Qué código va en la acción del controlador?
Abra el controlador predeterminado en su proyecto ASP.NET (por ejemplo, HomeController.cs) y reemplace el método Index con el siguiente código:
using IronXL;
using System.Data;
public ActionResult Index()
{
// Load the Excel workbook from a specified path.
WorkBook workBook = WorkBook.Load(@"C:\Files\Customer Data.xlsx");
// Access the first worksheet from the workbook.
WorkSheet workSheet = workBook.WorkSheets.First();
// Convert the worksheet data to a DataTable object.
// The 'true' parameter uses the first row as column headers
var dataTable = workSheet.ToDataTable(true);
// Send the DataTable to the view for rendering.
return View(dataTable);
}using IronXL;
using System.Data;
public ActionResult Index()
{
// Load the Excel workbook from a specified path.
WorkBook workBook = WorkBook.Load(@"C:\Files\Customer Data.xlsx");
// Access the first worksheet from the workbook.
WorkSheet workSheet = workBook.WorkSheets.First();
// Convert the worksheet data to a DataTable object.
// The 'true' parameter uses the first row as column headers
var dataTable = workSheet.ToDataTable(true);
// Send the DataTable to the view for rendering.
return View(dataTable);
}Imports IronXL
Imports System.Data
Public Function Index() As ActionResult
' Load the Excel workbook from a specified path.
Dim workBook As WorkBook = WorkBook.Load("C:\Files\Customer Data.xlsx")
' Access the first worksheet from the workbook.
Dim workSheet As WorkSheet = workBook.WorkSheets.First()
' Convert the worksheet data to a DataTable object.
' The 'true' parameter uses the first row as column headers
Dim dataTable = workSheet.ToDataTable(True)
' Send the DataTable to the view for rendering.
Return View(dataTable)
End FunctionImports IronXL
Imports System.Data
Public Function Index() As ActionResult
' Load the Excel workbook from a specified path.
Dim workBook As WorkBook = WorkBook.Load("C:\Files\Customer Data.xlsx")
' Access the first worksheet from the workbook.
Dim workSheet As WorkSheet = workBook.WorkSheets.First()
' Convert the worksheet data to a DataTable object.
' The 'true' parameter uses the first row as column headers
Dim dataTable = workSheet.ToDataTable(True)
' Send the DataTable to the view for rendering.
Return View(dataTable)
End Function¿Por qué usar DataTable en lugar de otros formatos?
En el método de acción Index, cargue el archivo Excel usando el método IronXL de Load. La ruta del archivo Excel (incluyendo el nombre del archivo) se proporciona como un parámetro a la llamada del método. A continuación, seleccione la primera hoja de Excel como hoja de trabajo y cargue los datos contenidos en ella en un objeto DataTable. Finalmente, envíe el DataTable al frontend.
DataTable es ideal para ASP.NET MVC porque se integra con vistas Razor y proporciona soporte incorporado para iterar a través de filas y columnas. A diferencia de los objetos personalizados, DataTable no requiere mapeo de modelos y maneja automáticamente tipos de datos mixtos. También puede exportar DataSet y DataTable de nuevo a Excel cuando sea necesario.
¿Qué pasa con la gestión de errores de los archivos que faltan?
El manejo de errores confiable asegura que su aplicación no se bloquee cuando los archivos Excel faltan o están corruptos. Aquí tienes una versión mejorada con un tratamiento adecuado de las excepciones:
public ActionResult Index()
{
try
{
string filePath = @"C:\Files\Customer Data.xlsx";
// Check if file exists before attempting to load
if (!System.IO.File.Exists(filePath))
{
ViewBag.Error = "Excel file not found at specified location.";
return View(new DataTable());
}
// Load workbook with error handling
WorkBook workBook = WorkBook.Load(filePath);
// Verify worksheet exists
if (workBook.WorkSheets.Count == 0)
{
ViewBag.Error = "No worksheets found in the Excel file.";
return View(new DataTable());
}
WorkSheet workSheet = workBook.WorkSheets.First();
var dataTable = workSheet.ToDataTable(true);
return View(dataTable);
}
catch (Exception ex)
{
// Log the exception (consider using a logging framework)
ViewBag.Error = $"Error reading Excel file: {ex.Message}";
return View(new DataTable());
}
}public ActionResult Index()
{
try
{
string filePath = @"C:\Files\Customer Data.xlsx";
// Check if file exists before attempting to load
if (!System.IO.File.Exists(filePath))
{
ViewBag.Error = "Excel file not found at specified location.";
return View(new DataTable());
}
// Load workbook with error handling
WorkBook workBook = WorkBook.Load(filePath);
// Verify worksheet exists
if (workBook.WorkSheets.Count == 0)
{
ViewBag.Error = "No worksheets found in the Excel file.";
return View(new DataTable());
}
WorkSheet workSheet = workBook.WorkSheets.First();
var dataTable = workSheet.ToDataTable(true);
return View(dataTable);
}
catch (Exception ex)
{
// Log the exception (consider using a logging framework)
ViewBag.Error = $"Error reading Excel file: {ex.Message}";
return View(new DataTable());
}
}Public Function Index() As ActionResult
Try
Dim filePath As String = "C:\Files\Customer Data.xlsx"
' Check if file exists before attempting to load
If Not System.IO.File.Exists(filePath) Then
ViewBag.Error = "Excel file not found at specified location."
Return View(New DataTable())
End If
' Load workbook with error handling
Dim workBook As WorkBook = WorkBook.Load(filePath)
' Verify worksheet exists
If workBook.WorkSheets.Count = 0 Then
ViewBag.Error = "No worksheets found in the Excel file."
Return View(New DataTable())
End If
Dim workSheet As WorkSheet = workBook.WorkSheets.First()
Dim dataTable = workSheet.ToDataTable(True)
Return View(dataTable)
Catch ex As Exception
' Log the exception (consider using a logging framework)
ViewBag.Error = $"Error reading Excel file: {ex.Message}"
Return View(New DataTable())
End Try
End FunctionPublic Function Index() As ActionResult
Try
Dim filePath As String = "C:\Files\Customer Data.xlsx"
' Check if file exists before attempting to load
If Not System.IO.File.Exists(filePath) Then
ViewBag.Error = "Excel file not found at specified location."
Return View(New DataTable())
End If
' Load workbook with error handling
Dim workBook As WorkBook = WorkBook.Load(filePath)
' Verify worksheet exists
If workBook.WorkSheets.Count = 0 Then
ViewBag.Error = "No worksheets found in the Excel file."
Return View(New DataTable())
End If
Dim workSheet As WorkSheet = workBook.WorkSheets.First()
Dim dataTable = workSheet.ToDataTable(True)
Return View(dataTable)
Catch ex As Exception
' Log the exception (consider using a logging framework)
ViewBag.Error = $"Error reading Excel file: {ex.Message}"
Return View(New DataTable())
End Try
End Function¿Cómo puedo seleccionar diferentes hojas de cálculo?
IronXL proporciona múltiples maneras de seleccionar y trabajar con hojas de trabajo específicas. Puede acceder a las hojas de cálculo por índice, nombre o iterar por todas las hojas disponibles:
// Method 1: Select by worksheet name
WorkSheet namedSheet = workBook.GetWorkSheet("Sales Data");
// Method 2: Select by index (zero-based)
WorkSheet secondSheet = workBook.WorkSheets[1];
// Method 3: Select the default/active worksheet
WorkSheet defaultSheet = workBook.DefaultWorkSheet;
// Method 4: Iterate through all worksheets
foreach (WorkSheet sheet in workBook.WorkSheets)
{
string sheetName = sheet.Name;
// Process each worksheet
}// Method 1: Select by worksheet name
WorkSheet namedSheet = workBook.GetWorkSheet("Sales Data");
// Method 2: Select by index (zero-based)
WorkSheet secondSheet = workBook.WorkSheets[1];
// Method 3: Select the default/active worksheet
WorkSheet defaultSheet = workBook.DefaultWorkSheet;
// Method 4: Iterate through all worksheets
foreach (WorkSheet sheet in workBook.WorkSheets)
{
string sheetName = sheet.Name;
// Process each worksheet
}' Method 1: Select by worksheet name
Dim namedSheet As WorkSheet = workBook.GetWorkSheet("Sales Data")
' Method 2: Select by index (zero-based)
Dim secondSheet As WorkSheet = workBook.WorkSheets(1)
' Method 3: Select the default/active worksheet
Dim defaultSheet As WorkSheet = workBook.DefaultWorkSheet
' Method 4: Iterate through all worksheets
For Each sheet As WorkSheet In workBook.WorkSheets
Dim sheetName As String = sheet.Name
' Process each worksheet
Next' Method 1: Select by worksheet name
Dim namedSheet As WorkSheet = workBook.GetWorkSheet("Sales Data")
' Method 2: Select by index (zero-based)
Dim secondSheet As WorkSheet = workBook.WorkSheets(1)
' Method 3: Select the default/active worksheet
Dim defaultSheet As WorkSheet = workBook.DefaultWorkSheet
' Method 4: Iterate through all worksheets
For Each sheet As WorkSheet In workBook.WorkSheets
Dim sheetName As String = sheet.Name
' Process each worksheet
Next¿Cómo mostrar datos de Excel en una página web?
¿Qué código de vista se necesita?
El siguiente ejemplo muestra cómo mostrar el DataTable devuelto en el ejemplo anterior en un navegador web.
A continuación se muestra el archivo Excel de trabajo utilizado en este ejemplo:

Archivo de Excel
Abra el index.cshtml (vista de índice) y reemplace el código con el siguiente código HTML:
@{
ViewData["Title"] = "Home Page";
}
@using System.Data
@model DataTable
<div class="text-center">
<h1 class="display-4">Welcome to IronXL Read Excel MVC</h1>
</div>
@* Check for errors first *@
@if (ViewBag.Error != null)
{
<div class="alert alert-danger">
@ViewBag.Error
</div>
}
@* Display table only if data exists *@
@if (Model != null && Model.Rows.Count > 0)
{
<table class="table table-dark">
<tbody>
@foreach (DataRow row in Model.Rows)
{
<tr>
@for (int i = 0; i < Model.Columns.Count; i++)
{
<td>@row[i]</td>
}
</tr>
}
</tbody>
</table>
}
else
{
<p>No data to display.</p>
}
¿Por qué usar Bootstrap para el diseño de tablas?
El código anterior utiliza el DataTable devuelto por el método Index como un modelo. Cada fila de la tabla se imprime en la página web utilizando un bucle @for, incluyendo el formato de Bootstrap para la decoración.
Bootstrap ofrece diseños de tablas adaptables que se ajustan automáticamente a distintos tamaños de pantalla, algo crucial para las aplicaciones web modernas. La clase table-dark crea una tabla de tema oscuro atractiva que es fácil de leer. Para un formato de Excel más avanzado como bordes de celda y alineación o patrones y colores de fondo, IronXL proporciona métodos adicionales para acceder a datos estructurados directamente.
¿Cómo es el resultado final?
Al ejecutar el proyecto se obtienen los resultados que se muestran a continuación:

Tabla Bootstrap
¿Cómo puedo añadir encabezados a la tabla?
Para mostrar los encabezados de columna de su archivo Excel, modifique el código de la vista para incluir una sección de encabezado de tabla. Al llamar a ToDataTable(true), IronXL usa automáticamente la primera fila como nombres de columna:
@if (Model != null && Model.Rows.Count > 0)
{
<table class="table table-dark">
<thead>
<tr>
@foreach (DataColumn column in Model.Columns)
{
<th>@column.ColumnName</th>
}
</tr>
</thead>
<tbody>
@foreach (DataRow row in Model.Rows)
{
<tr>
@for (int i = 0; i < Model.Columns.Count; i++)
{
<td>@row[i]</td>
}
</tr>
}
</tbody>
</table>
}@if (Model != null && Model.Rows.Count > 0)
{
<table class="table table-dark">
<thead>
<tr>
@foreach (DataColumn column in Model.Columns)
{
<th>@column.ColumnName</th>
}
</tr>
</thead>
<tbody>
@foreach (DataRow row in Model.Rows)
{
<tr>
@for (int i = 0; i < Model.Columns.Count; i++)
{
<td>@row[i]</td>
}
</tr>
}
</tbody>
</table>
}netnetEsta mejora muestra los encabezados de columna adecuados como "Nombre del Cliente", "Costo de Envío" y "Precio Unitario" de su archivo Excel. Para escenarios más complejos que involucren rangos nombrados o tablas nombradas, IronXL proporciona métodos adicionales para acceder a datos estructurados directamente.
Preguntas frecuentes
¿Qué es IronXL?
IronXL es una biblioteca C# que permite a los desarrolladores de ASP.NET MVC leer, editar y manipular archivos de Excel sin la necesidad de dependencias de Microsoft Office. Proporciona características como convertir hojas de Excel a System.Data.DataTable para facilitar la integración en aplicaciones web.
¿Cómo permite IronXL leer archivos de Excel en ASP.NET MVC?
IronXL permite a los desarrolladores cargar libros de Excel y convertir hojas de cálculo en objetos System.Data.DataTable con solo unas pocas líneas de código, facilitando la visualización de datos de Excel en aplicaciones ASP.NET MVC.
¿Cuáles son los beneficios de usar IronXL con ASP.NET MVC?
IronXL simplifica las operaciones con archivos de Excel al eliminar la necesidad de Microsoft Office Interop, ofreciendo un método sencillo para integrar datos de hojas de cálculo en vistas web y mejorando el rendimiento de la aplicación con una gestión avanzada de memoria.
¿Qué versiones de .NET son compatibles con IronXL?
IronXL es compatible con el .NET Framework 4.6.2 y superior, así como con .NET Core 3.1 y versiones más recientes, incluyendo .NET 6.0. Estas versiones aseguran un rendimiento óptimo y características modernas para manejar archivos de Excel.
¿Cómo se pueden mostrar datos de Excel en una página web usando IronXL?
Los datos de Excel convertidos en un DataTable se pueden mostrar en una página web pasándolos a una vista Razor en ASP.NET MVC. Esto se logra utilizando sintaxis Razor y HTML para recorrer filas y columnas de la tabla y renderizarlas en una tabla con estilo Bootstrap.
¿Por qué elegir el formato DataTable al usar IronXL?
El formato DataTable es ideal para aplicaciones ASP.NET MVC porque se integra con las vistas Razor, permite iterar de manera sencilla sobre filas y columnas de datos sin mapeo de modelo, y acomoda eficientemente tipos de datos mixtos.
¿Qué pasos se requieren para instalar IronXL en un proyecto ASP.NET MVC?
La instalación implica agregar IronXL a través del Administrador de Paquetes NuGet en Visual Studio. Requiere abrir la Consola del Administrador de Paquetes NuGet y ejecutar un comando específico para añadir IronXL a las dependencias del proyecto.
¿Cómo manejar errores al leer archivos de Excel con IronXL?
IronXL admite un manejo de errores confiable, como comprobar la existencia de archivos antes de cargarlos, capturar excepciones durante el proceso de carga del libro de trabajo y gestionar escenarios de hojas de cálculo ausentes. Esto asegura la estabilidad de la aplicación incluso si los archivos de Excel están corruptos o ausentes.
¿Puede IronXL seleccionar hojas de cálculo específicas de un archivo de Excel?
Sí, IronXL permite a los desarrolladores seleccionar hojas de cálculo por nombre, índice o configuración predeterminada, y también proporciona funcionalidad para iterar a través de todas las hojas de cálculo disponibles en un libro de trabajo.
¿Cuáles son algunas opciones de estilo para mostrar datos de Excel usando IronXL en aplicaciones web?
IronXL, cuando se usa con ASP.NET MVC, habilita opciones de estilo como Bootstrap para diseños de tablas responsivas y métodos adicionales de IronXL para establecer bordes de celdas, alineación, patrones y colores dentro de las hojas de cálculo.
Curtis Chau tiene una licenciatura en Ciencias de la Computación (Carleton University) y se especializa en el desarrollo front-end con experiencia en Node.js, TypeScript, JavaScript y React. Apasionado por crear interfaces de usuario intuitivas y estéticamente agradables, disfruta trabajando con frameworks modernos y creando manuales bien estructurados y visualmente atractivos.