Cómo abrir un archivo de Excel en ASP.NET Core

¿Qué es IronXL?

IronXL es una biblioteca de .NET Excel que proporciona funcionalidad para trabajar con documentos de Excel sin requerir dependencias de Microsoft Excel o Office Interop. Admite tanto .NET Framework como .NET Core, proporcionando capacidades para escribir, manipular y leer archivos de Excel con solo unas pocas líneas de código. Para un tutorial detallado sobre cómo leer archivos de Excel, por favor consulte este tutorial de Excel.

La biblioteca IronXL puede leer y escribir documentos de Excel, extraer datos de ellos, manipular los datos e incluso crear nuevos archivos de Excel desde cero. IronXL no solo admite el formato .XLS, sino que también es compatible con .XLSX, que es un formato de archivo basado en XML desarrollado por Microsoft para representar hojas de cálculo.

Prerrequisitos

Antes de sumergirse en el código, asegúrese de tener lo siguiente:

1. Instalado .NET Core 3.1 o superior.
2. Un IDE adecuado para el desarrollo de .NET (se recomienda Microsoft Visual Studio).
3. Comprensión básica de ASP.NET Core y Razor Pages.

Crear un nuevo proyecto .NET Core

1. Abra Microsoft Visual Studio y seleccione "Crear un nuevo proyecto".
2. Elija "ASP.NET Core Web App" de la lista de plantillas de proyectos y haga clic en "Siguiente".
3. Proporcione un nombre para su proyecto, por ejemplo, "Open_ExcelFile.NET_Core", seleccione una ubicación y haga clic en "Siguiente".
4. Elija ".NET Core" como el marco de trabajo de destino y "ASP.NET Core 3.1 o superior" como la versión. En la sección "Plantilla de proyecto", seleccione "Aplicación web" y haga clic en "Crear".

Crear una página de Razor

Ahora, vamos a crear una Página Razor para escribir el código para abrir el archivo de Excel.

1. Haga clic derecho en la carpeta "Pages" en el Explorador de soluciones y seleccione "Agregar" > "Página Razor".
2. Ingrese "ExcelOpener" como el nombre de la página y haga clic en "Agregar".

Crear una nueva Página Razor

Esto creará dos archivos: ExcelOpener.cshtml y ExcelOpener.cshtml.cs.

El archivo ExcelOpener.cshtml contiene el marcado HTML para la página, y el archivo ExcelOpener.cshtml.cs contiene el código C# detrás para la página.

Lectura de archivos de Excel

Vamos a sumergirnos en el código. La clase proporcionada ExcelOpenerModel es un modelo de página Razor. Esta clase tiene una propiedad List<List<string>> Data, que se utilizará para almacenar los datos leídos de un archivo de Excel.

public List<List<string>> Data { get; set; }

public ExcelOpenerModel()
{
    Data = new List<List<string>>();
}

public List<List<string>> Data { get; set; }

public ExcelOpenerModel()
{
    Data = new List<List<string>>();
}

Public Property Data() As List(Of List(Of String))

'INSTANT VB WARNING: The following constructor is declared outside of its associated class:
'ORIGINAL LINE: public ExcelOpenerModel()
Public Sub New()
	Data = New List(Of List(Of String))()
End Sub

En el método OnGet, se utiliza IronXL para cargar un archivo de Excel y leer los datos de la hoja de trabajo predeterminada (la primera hoja en el libro de trabajo). Cada fila se representa como un List<string>, y todas estas listas se añaden luego a la propiedad Data.

public void OnGet()
{
    try
    {
        Data = new List<List<string>>();
        // Load your Excel file
        var workbook = WorkBook.Load(@"C:\Users\Administrator\Documents\Loan.xlsx");

        // Select your Worksheet
        WorkSheet sheet = workbook.DefaultWorkSheet;

        for (int i = 0; i < sheet.RowCount; i++)
        {
            var row = new List<string>();
            for (int j = 0; j < sheet.ColumnCount; j++)
            {
                row.Add(sheet.GetCellAt(i, j).Value.ToString());
            }
            Data.Add(row);
        }
    }
    catch (Exception ex)
    {
        // Handle exceptions here
        Console.WriteLine(ex.Message);
    }
}

public void OnGet()
{
    try
    {
        Data = new List<List<string>>();
        // Load your Excel file
        var workbook = WorkBook.Load(@"C:\Users\Administrator\Documents\Loan.xlsx");

        // Select your Worksheet
        WorkSheet sheet = workbook.DefaultWorkSheet;

        for (int i = 0; i < sheet.RowCount; i++)
        {
            var row = new List<string>();
            for (int j = 0; j < sheet.ColumnCount; j++)
            {
                row.Add(sheet.GetCellAt(i, j).Value.ToString());
            }
            Data.Add(row);
        }
    }
    catch (Exception ex)
    {
        // Handle exceptions here
        Console.WriteLine(ex.Message);
    }
}

Public Sub OnGet()
	Try
		Data = New List(Of List(Of String))()
		' Load your Excel file
		Dim workbook = WorkBook.Load("C:\Users\Administrator\Documents\Loan.xlsx")

		' Select your Worksheet
		Dim sheet As WorkSheet = workbook.DefaultWorkSheet

		For i As Integer = 0 To sheet.RowCount - 1
			Dim row = New List(Of String)()
			For j As Integer = 0 To sheet.ColumnCount - 1
				row.Add(sheet.GetCellAt(i, j).Value.ToString())
			Next j
			Data.Add(row)
		Next i
	Catch ex As Exception
		' Handle exceptions here
		Console.WriteLine(ex.Message)
	End Try
End Sub

Escribir archivos de Excel

El método OnPost en la clase ExcelOpenerModel se utiliza para guardar modificaciones en el archivo de Excel. Primero carga el archivo de Excel y recupera la hoja de trabajo predeterminada. Luego escribe los valores de Data en las celdas de la hoja de trabajo y guarda el libro en un nuevo archivo.

public void OnPost()
{
    try
    {
        // Load your Excel file
        var workbook = WorkBook.Load(@"C:\Users\Administrator\Documents\Loan.xlsx");

        // Select your Worksheet
        var sheet = workbook.DefaultWorkSheet;

        for (int i = 0; i < Data.Count; i++)
        {
            for (int j = 0; j < Data[i].Count; j++)
            {
                sheet.SetCellValue(i, j, Data[i][j]);
            }
        }

        // Save the Excel file
        var filename = @"C:\ModifiedData.xlsx";
        workbook.SaveAs(filename);
    }
    catch (Exception ex)
    {
        // Handle exceptions here
        Console.WriteLine(ex.Message);
    }
}

public void OnPost()
{
    try
    {
        // Load your Excel file
        var workbook = WorkBook.Load(@"C:\Users\Administrator\Documents\Loan.xlsx");

        // Select your Worksheet
        var sheet = workbook.DefaultWorkSheet;

        for (int i = 0; i < Data.Count; i++)
        {
            for (int j = 0; j < Data[i].Count; j++)
            {
                sheet.SetCellValue(i, j, Data[i][j]);
            }
        }

        // Save the Excel file
        var filename = @"C:\ModifiedData.xlsx";
        workbook.SaveAs(filename);
    }
    catch (Exception ex)
    {
        // Handle exceptions here
        Console.WriteLine(ex.Message);
    }
}

Public Sub OnPost()
	Try
		' Load your Excel file
		Dim workbook = WorkBook.Load("C:\Users\Administrator\Documents\Loan.xlsx")

		' Select your Worksheet
		Dim sheet = workbook.DefaultWorkSheet

		For i As Integer = 0 To Data.Count - 1
			Dim j As Integer = 0
			Do While j < Data(i).Count
				sheet.SetCellValue(i, j, Data(i)(j))
				j += 1
			Loop
		Next i

		' Save the Excel file
		Dim filename = "C:\ModifiedData.xlsx"
		workbook.SaveAs(filename)
	Catch ex As Exception
		' Handle exceptions here
		Console.WriteLine(ex.Message)
	End Try
End Sub

Formulario HTML para editar datos de Excel

En ExcelOpener.cshtml, se define un formulario para mostrar y editar los datos del archivo de Excel. Cada valor de celda se muestra en un campo de entrada de texto. Después de editar, al hacer clic en el botón "Guardar" se enviará el formulario, activando el método OnPost y guardando los cambios en el archivo de Excel.

@page
@model Open_Excel_File_.NET_Core.Pages.ExcelOpenerModel

<form method="post">
    <table class="table table-bordered table-striped">
        <!-- Bootstrap classes for tables -->
        @for (int i = 0; i < Model.Data.Count; i++)
        {
            <tr>
                @for (int j = 0; j < Model.Data[i].Count; j++)
                {
                    <td>
                        <input type="text" class="form-control" name="Data[@i][@j]" value="@Model.Data[i][j]" /> <!-- Bootstrap class for form controls -->
                    </td>
                }
            </tr>
        }
    </table>

    <input type="submit" class="btn btn-primary" value="Save" /> <!-- Bootstrap classes for buttons -->
</form>

@page
@model Open_Excel_File_.NET_Core.Pages.ExcelOpenerModel

<form method="post">
    <table class="table table-bordered table-striped">
        <!-- Bootstrap classes for tables -->
        @for (int i = 0; i < Model.Data.Count; i++)
        {
            <tr>
                @for (int j = 0; j < Model.Data[i].Count; j++)
                {
                    <td>
                        <input type="text" class="form-control" name="Data[@i][@j]" value="@Model.Data[i][j]" /> <!-- Bootstrap class for form controls -->
                    </td>
                }
            </tr>
        }
    </table>

    <input type="submit" class="btn btn-primary" value="Save" /> <!-- Bootstrap classes for buttons -->
</form>

Navegando a la página

En _Layout.cshtml, se añade un enlace a la página en el menú de navegación. Haciendo clic en este enlace, navegará a la página de apertura de Excel.

<li class="nav-item">
    <a class="nav-link text-dark" asp-area="" asp-page="/ExcelOpener">ExcelOpener</a>
</li>

<li class="nav-item">
    <a class="nav-link text-dark" asp-area="" asp-page="/ExcelOpener">ExcelOpener</a>
</li>

Ejecutar la aplicación y explicar el resultado

Compila la aplicación haciendo clic en el botón "Compilar" en Visual Studio o usando el atajo Ctrl + Shift + B. Ejecute la aplicación presionando F5 o haciendo clic en el botón "Iniciar" en Visual Studio.

Una vez que la aplicación esté en ejecución, navegue a la página "ExcelOpener" haciendo clic en el enlace correspondiente en la barra de navegación. La página mostrará los datos de Excel en formato tabular.

Puede modificar los datos en la tabla y hacer clic en el botón "Guardar" para guardar los cambios de nuevo en el archivo de Excel.

Mostrar datos de Excel en la aplicación web

Este tutorial demostró cómo abrir un archivo de Excel usando IronXL en una aplicación ASP.NET Core. IronXL proporciona una forma simple y conveniente de leer y manipular archivos de Excel. Puede explorar la documentación de IronXL para características y funcionalidades más avanzadas.

IronXL ofrece una prueba gratuita, permitiéndole evaluar sus capacidades. Si lo encuentra útil para sus proyectos, puede comprar una licencia comenzando desde $799.