Saltar al pie de página
USANDO IRONXL

Cómo generar un archivo de Excel en Razor Pages

Razor Pages offer a modern approach to building web pages. In Razor Pages, the source code that renders the web page is written in C# rather than being generated by a server-side page.

To efficiently work with Excel files, the IronXL library is recommended over others like the POI Java project NPOI package (notably used with PowerPoint files) and Office Interop. IronXL is a feature-rich, easy-to-use library that doesn't require Microsoft Office and supports multiple .NET versions.

This article demonstrates using the IronXL C# library to generate and export Excel spreadsheets with dummy data and row headers in Razor Pages.

IronXL: C# Excel Library

IronXL is a C# Excel library that offers methods and functions for operating on large data sets using parallel processing to increase computing power. It's user-friendly as it doesn't require understanding the inner workings and supports both XLS and XLSX files.

IronXL is ideal for importing, exporting, creating Excel formulas, and office documents without needing Microsoft Office to be installed.

Learn how to import and export Excel files in Razor Pages using IronXL.

Generate Excel File in Razor Pages

To create Excel sheets in Razor Pages, start by opening Visual Studio, creating an ASP.NET Core Web Application, and installing IronXL.

Prerequisites

Setting up to create Excel files in Razor Pages requires:

  1. Visual Studio (Latest Version)
  2. .NET Framework 6 or 7
  3. .NET Core Web Application in Visual Studio

Install IronXL Library

Install IronXL using the NuGet Package Manager Console. Enter this command to install the library in a .NET Core Web Application:

Install-Package IronXL.Excel

Code for Generating Excel file

Here's how to write the code. Open "Index.cs" in the Pages folder and add the following method:

public FileResult OnPostExport()
{
    // Create a new WorkBook with XLSX format
    WorkBook workBook = new WorkBook(IronXL.ExcelFileFormat.XLSX);
    // Create a new WorkSheet named "data"
    WorkSheet workSheet = workBook.CreateWorkSheet("data");

    // Add headers to the new worksheet
    workSheet["A1"].Value = "Product EN";
    workSheet["B1"].Value = "SKU";
    workSheet["C1"].Value = "Customer";

    // Make header text bold
    workSheet["A1:C1"].Style.Font.Bold = true;

    // Add dummy data to the worksheet
    workSheet["A2"].Value = "Iron Rods";
    workSheet["A3"].Value = "Mobile Phones";
    workSheet["A4"].Value = "Chargers";

    workSheet["B2"].Value = "105";
    workSheet["B3"].Value = "285";
    workSheet["B4"].Value = "301";

    workSheet["C2"].Value = "Adam";
    workSheet["C3"].Value = "Ellen";
    workSheet["C4"].Value = "Tom";

    // Convert the WorkBook to a byte array Stream for download
    return File(workBook.ToStream().ToArray(), "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet", "Grid.xlsx");
}
public FileResult OnPostExport()
{
    // Create a new WorkBook with XLSX format
    WorkBook workBook = new WorkBook(IronXL.ExcelFileFormat.XLSX);
    // Create a new WorkSheet named "data"
    WorkSheet workSheet = workBook.CreateWorkSheet("data");

    // Add headers to the new worksheet
    workSheet["A1"].Value = "Product EN";
    workSheet["B1"].Value = "SKU";
    workSheet["C1"].Value = "Customer";

    // Make header text bold
    workSheet["A1:C1"].Style.Font.Bold = true;

    // Add dummy data to the worksheet
    workSheet["A2"].Value = "Iron Rods";
    workSheet["A3"].Value = "Mobile Phones";
    workSheet["A4"].Value = "Chargers";

    workSheet["B2"].Value = "105";
    workSheet["B3"].Value = "285";
    workSheet["B4"].Value = "301";

    workSheet["C2"].Value = "Adam";
    workSheet["C3"].Value = "Ellen";
    workSheet["C4"].Value = "Tom";

    // Convert the WorkBook to a byte array Stream for download
    return File(workBook.ToStream().ToArray(), "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet", "Grid.xlsx");
}
Public Function OnPostExport() As FileResult
	' Create a new WorkBook with XLSX format
	Dim workBook As New WorkBook(IronXL.ExcelFileFormat.XLSX)
	' Create a new WorkSheet named "data"
	Dim workSheet As WorkSheet = workBook.CreateWorkSheet("data")

	' Add headers to the new worksheet
	workSheet("A1").Value = "Product EN"
	workSheet("B1").Value = "SKU"
	workSheet("C1").Value = "Customer"

	' Make header text bold
	workSheet("A1:C1").Style.Font.Bold = True

	' Add dummy data to the worksheet
	workSheet("A2").Value = "Iron Rods"
	workSheet("A3").Value = "Mobile Phones"
	workSheet("A4").Value = "Chargers"

	workSheet("B2").Value = "105"
	workSheet("B3").Value = "285"
	workSheet("B4").Value = "301"

	workSheet("C2").Value = "Adam"
	workSheet("C3").Value = "Ellen"
	workSheet("C4").Value = "Tom"

	' Convert the WorkBook to a byte array Stream for download
	Return File(workBook.ToStream().ToArray(), "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet", "Grid.xlsx")
End Function
$vbLabelText   $csharpLabel

In this code, a new Excel WorkBook is created and contains one WorkSheet. The sheet is populated with dummy data, and the generated file is responded to the server with:

  • The WorkBook is converted to a Stream to download as a file.
  • The MIME type is set.
  • A name for the file download is specified.

Create a button to download the Excel file

Replace the existing code in "Index.cshtml" with the following:

@page
@model IndexModel
@{
    ViewData["Title"] = "Home page";
}

<div class="text-center">
    <h1 class="display-4">IronXL Generate Excel File</h1>
    <p class="m-5">IronXL is an Excel Library for C# that allows developers to read and edit Excel data from XLS and XLSX documents without using Microsoft.Office.Interop.Excel</p>
    <form method="post" asp-page-handler="Export">
        <button class="btn btn-success p-3">Generate Excel File!</button>
    </form>
</div>
@page
@model IndexModel
@{
    ViewData["Title"] = "Home page";
}

<div class="text-center">
    <h1 class="display-4">IronXL Generate Excel File</h1>
    <p class="m-5">IronXL is an Excel Library for C# that allows developers to read and edit Excel data from XLS and XLSX documents without using Microsoft.Office.Interop.Excel</p>
    <form method="post" asp-page-handler="Export">
        <button class="btn btn-success p-3">Generate Excel File!</button>
    </form>
</div>
HTML

This HTML creates a form with asp-page-handler set to "Export", enabling the application to export the Excel file to the local machine when the user clicks the "Generate Excel File!" button, triggering a browser download.

Run the Project

Run the project, and you'll see a screen in the browser. Click the green button to download the Excel file.

How to Generate an Excel File on Razor Pages, Figure 1: IronXL Generate Excel Sheets IronXL Generate Excel Sheets

After clicking "Generate Excel File!", the file will download.

How to Generate an Excel File on Razor Pages, Figure 2: IronXL Downloaded File IronXL Downloaded File

Open the Generated Excel File

The generated Excel file's content matches the code's output with perfect formatting. The snapshot of the generated Excel file is displayed below.

How to Generate an Excel File on Razor Pages, Figure 3: IronXL Generated File IronXL Generated File

IronXL better than Competitors

IronXL is a superior tool for working with both XLS and XLSX formats without limitations like NPOI, which is slower due to being Java-based, whereas IronXL is C#. In ASP.NET Core applications generating large/multiple spreadsheets, opt for IronXL over POI.

IronXL allows for creating and editing Excel files without Microsoft Office. Unlike Microsoft Interop, IronXL does not need to call Microsoft Excel's ActiveX for Excel operations or exports. It also allows exporting CSV files to Excel format.

IronXL also provides extensive features for interacting with Excel files, including converting between popular formats, inserting math functions, adding charts, and inserting images.

Conclusion

This article showcases using IronXL for generating an Excel file in Razor Pages without needing Microsoft Excel ActiveX and facilitating file downloads.

Explore more tutorials on creating Excel files.

IronXL is free for non-commercial development. A free trial is available for production testing. View pricing plans for more pricing and licensing details.

Preguntas Frecuentes

¿Cómo puedo generar un archivo Excel en Razor Pages sin usar Interop?

Puedes generar un archivo Excel en Razor Pages sin usar Interop utilizando la biblioteca IronXL. Esta biblioteca te permite crear y manipular archivos Excel directamente en C#, sin necesidad de Microsoft Office, creando un WorkBook y agregando datos a un WorkSheet.

¿Qué pasos están involucrados en la instalación de IronXL para un proyecto de Razor Pages?

Para instalar IronXL para un proyecto de Razor Pages, puedes usar la Consola del Administrador de Paquetes NuGet en Visual Studio. Ejecuta el comando Install-Package IronXL.Excel para agregar la biblioteca a tu proyecto.

¿Puedo usar IronXL para exportar datos desde una aplicación Razor Pages?

Sí, IronXL puede usarse para exportar datos desde una aplicación Razor Pages. Puedes convertir tus datos en formato Excel y luego usar Razor Pages para transmitir esos datos de vuelta al cliente como un archivo descargable.

¿Cuáles son los beneficios de usar IronXL sobre Microsoft Interop para generar archivos Excel?

IronXL ofrece varios beneficios sobre Microsoft Interop, incluyendo un rendimiento más rápido, no requiere instalación de Microsoft Office y la capacidad de manejar grandes conjuntos de datos eficientemente mediante procesamiento en paralelo.

¿Es posible manejar grandes conjuntos de datos Excel en Razor Pages usando IronXL?

Sí, IronXL es capaz de manejar grandes conjuntos de datos Excel eficientemente. Soporta el procesamiento en paralelo, lo cual puede mejorar el rendimiento y la velocidad al trabajar con datos extensos.

¿IronXL soporta diferentes formatos de archivo Excel?

IronXL soporta tanto los formatos de archivo XLS como XLSX, permitiendo una manipulación completa de archivos Excel, incluyendo importación, exportación y formateo de datos.

¿Hay opciones gratuitas para usar IronXL en desarrollo?

IronXL está disponible de forma gratuita para desarrollo no comercial. Se proporciona una prueba gratuita para pruebas de producción, con varios planes de precios disponibles para uso comercial.

¿Cómo puedo activar una descarga de archivo Excel en Razor Pages usando IronXL?

Para activar una descarga de archivo Excel en Razor Pages usando IronXL, crea un WorkBook, llénalo con datos y luego conviértelo en una matriz de bytes. Usa el método File de Razor Pages para transmitir la matriz de bytes como un archivo descargable al usuario.

¿Qué hace de IronXL una opción preferible sobre otras bibliotecas como NPOI?

IronXL es a menudo preferido sobre bibliotecas como NPOI debido a su implementación nativa en C#, que ofrece un rendimiento más rápido, facilidad de uso y no depende de componentes de Java, lo que lo hace ideal para aplicaciones ASP.NET Core.

Jordi Bardia
Ingeniero de Software
Jordi es más competente en Python, C# y C++. Cuando no está aprovechando sus habilidades en Iron Software, está programando juegos. Compartiendo responsabilidades para pruebas de productos, desarrollo de productos e investigación, Jordi agrega un valor inmenso a la mejora continua del producto. La experiencia variada lo mantiene ...
Leer más