Télécharger un fichier Excel en .NET C# : Exporter des données aux formats XLSX, CSV et plus encore

Comment créer et télécharger un fichier Excel à partir d'un contrôleur ?

Le modèle de base pour tout téléchargement de fichier Excel dans un scénario ASP.NET Core comprend trois étapes : créer le classeur, l'écrire dans un flux et renvoyer le flux sous forme de fichier de réponse. Le code suivant illustre une action complète de contrôleur MVC qui crée un fichier XLSX à partir de zéro et l'envoie au navigateur.

using IronXL;
using Microsoft.AspNetCore.Mvc;
public class ReportController : Controller
{
    // Export employee data as a downloadable Excel file
    public IActionResult DownloadExcel()
    {
        // Create a new workbook and worksheet
        var workbook = WorkBook.Create(ExcelFileFormat.XLSX);
        var worksheet = workbook.CreateWorkSheet("Employees");
        // Add header row with column names
        worksheet["A1"].Value = "Name";
        worksheet["B1"].Value = "Department";
        worksheet["C1"].Value = "Salary";
        // Populate cells with data values
        worksheet["A2"].Value = "Alice Torres";
        worksheet["B2"].Value = "Engineering";
        worksheet["C2"].Value = 95000;
        worksheet["A3"].Value = "James Park";
        worksheet["B3"].Value = "Marketing";
        worksheet["C3"].Value = 78000;
        // Export workbook to a MemoryStream for download
        var stream = workbook.ToStream();
        string filename = "Employees.xlsx";
        var content = "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet";
        // Return file to the browser with content disposition attachment
        return File(stream, content, filename);
    }
}

using IronXL;
using Microsoft.AspNetCore.Mvc;
public class ReportController : Controller
{
    // Export employee data as a downloadable Excel file
    public IActionResult DownloadExcel()
    {
        // Create a new workbook and worksheet
        var workbook = WorkBook.Create(ExcelFileFormat.XLSX);
        var worksheet = workbook.CreateWorkSheet("Employees");
        // Add header row with column names
        worksheet["A1"].Value = "Name";
        worksheet["B1"].Value = "Department";
        worksheet["C1"].Value = "Salary";
        // Populate cells with data values
        worksheet["A2"].Value = "Alice Torres";
        worksheet["B2"].Value = "Engineering";
        worksheet["C2"].Value = 95000;
        worksheet["A3"].Value = "James Park";
        worksheet["B3"].Value = "Marketing";
        worksheet["C3"].Value = 78000;
        // Export workbook to a MemoryStream for download
        var stream = workbook.ToStream();
        string filename = "Employees.xlsx";
        var content = "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet";
        // Return file to the browser with content disposition attachment
        return File(stream, content, filename);
    }
}

Comment exporter les données d'une base de données vers une feuille de calcul téléchargeable ?

Dans la plupart des cas concrets, il s'agit d'exporter des données à partir d'une table de base de données plutôt que d'utiliser des valeurs codées en dur. Le processus reste le même : interroger les données, remplir les feuilles de calcul et renvoyer le fichier. Voici un exemple qui simule l'extraction d'enregistrements d'une base de données et leur écriture dans un document Excel.

using IronXL;
using Microsoft.AspNetCore.Mvc;
public class DataExportController : Controller
{
    // Export database records to an xlsx file for download
    public IActionResult ExportDatabaseReport()
    {
        // Simulate a database query returning order records
        var orders = new[]
        {
            new { OrderId = 1001, Customer = "Acme Corp", Total = 4500.00m },
            new { OrderId = 1002, Customer = "Globex Inc", Total = 12300.50m },
            new { OrderId = 1003, Customer = "Initech LLC", Total = 890.75m },
        };
        var workbook = WorkBook.Create(ExcelFileFormat.XLSX);
        var worksheet = workbook.CreateWorkSheet("Orders");
        // Write headers
        worksheet["A1"].Value = "Order ID";
        worksheet["B1"].Value = "Customer";
        worksheet["C1"].Value = "Total";
        // Write each row of data from the query results
        for (int i = 0; i < orders.Length; i++)
        {
            int row = i + 2;
            worksheet[$"A{row}"].Value = orders[i].OrderId;
            worksheet[$"B{row}"].Value = orders[i].Customer;
            worksheet[$"C{row}"].Value = orders[i].Total;
        }
        var stream = workbook.ToStream();
        string filename = $"OrderReport-{DateTime.Now:yyyyMMdd}.xlsx";
        return File(stream, "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet", filename);
    }
}

using IronXL;
using Microsoft.AspNetCore.Mvc;
public class DataExportController : Controller
{
    // Export database records to an xlsx file for download
    public IActionResult ExportDatabaseReport()
    {
        // Simulate a database query returning order records
        var orders = new[]
        {
            new { OrderId = 1001, Customer = "Acme Corp", Total = 4500.00m },
            new { OrderId = 1002, Customer = "Globex Inc", Total = 12300.50m },
            new { OrderId = 1003, Customer = "Initech LLC", Total = 890.75m },
        };
        var workbook = WorkBook.Create(ExcelFileFormat.XLSX);
        var worksheet = workbook.CreateWorkSheet("Orders");
        // Write headers
        worksheet["A1"].Value = "Order ID";
        worksheet["B1"].Value = "Customer";
        worksheet["C1"].Value = "Total";
        // Write each row of data from the query results
        for (int i = 0; i < orders.Length; i++)
        {
            int row = i + 2;
            worksheet[$"A{row}"].Value = orders[i].OrderId;
            worksheet[$"B{row}"].Value = orders[i].Customer;
            worksheet[$"C{row}"].Value = orders[i].Total;
        }
        var stream = workbook.ToStream();
        string filename = $"OrderReport-{DateTime.Now:yyyyMMdd}.xlsx";
        return File(stream, "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet", filename);
    }
}

Comment télécharger des données au format CSV plutôt qu'XLSX ?

Un fichier CSV léger est parfois préférable, notamment pour l'intégration de données dans d'autres systèmes, bases de données ou outils qui n'ont pas besoin de toutes les fonctionnalités d'un fichier Excel. IronXL simplifie considérablement la conversion entre les formats.

using IronXL;
using Microsoft.AspNetCore.Mvc;
public class CsvController : Controller
{
    // Export data as a CSV file download
    public IActionResult ExportCsv()
    {
        var workbook = WorkBook.Create(ExcelFileFormat.XLSX);
        var worksheet = workbook.CreateWorkSheet("Products");
        worksheet["A1"].Value = "SKU";
        worksheet["B1"].Value = "Product";
        worksheet["C1"].Value = "Price";
        worksheet["A2"].Value = "WDG-001";
        worksheet["B2"].Value = "Widget Pro";
        worksheet["C2"].Value = 29.99;
        // Convert to CSV stream instead of XLSX
        var stream = workbook.ToCsvStream();
        string filename = "Products.csv";
        return File(stream, "text/csv", filename);
    }
}

using IronXL;
using Microsoft.AspNetCore.Mvc;
public class CsvController : Controller
{
    // Export data as a CSV file download
    public IActionResult ExportCsv()
    {
        var workbook = WorkBook.Create(ExcelFileFormat.XLSX);
        var worksheet = workbook.CreateWorkSheet("Products");
        worksheet["A1"].Value = "SKU";
        worksheet["B1"].Value = "Product";
        worksheet["C1"].Value = "Price";
        worksheet["A2"].Value = "WDG-001";
        worksheet["B2"].Value = "Widget Pro";
        worksheet["C2"].Value = 29.99;
        // Convert to CSV stream instead of XLSX
        var stream = workbook.ToCsvStream();
        string filename = "Products.csv";
        return File(stream, "text/csv", filename);
    }
}

Comment réexporter un fichier téléchargé dans un format différent ?

Un scénario courant d'application Web consiste à accepter les fichiers téléchargés par les utilisateurs et à les exporter dans un autre format, par exemple en convertissant un fichier XLS en XLSX ou en produisant des fichiers CSV à partir d'un classeur initialement enregistré dans un format ancien.

public IActionResult ConvertUpload(IFormFile upload)
{
    using var memoryStream = new MemoryStream();
    upload.CopyTo(memoryStream);
    memoryStream.Position = 0;
    // Load uploaded Excel file from the stream
    var workbook = WorkBook.Load(memoryStream);
    // Re-export as XLSX regardless of the original file extension or file type
    var stream = workbook.ToXlsxStream();
    string filename = Path.GetFileNameWithoutExtension(upload.FileName) + ".xlsx";
    return File(stream, "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet", filename);
}

public IActionResult ConvertUpload(IFormFile upload)
{
    using var memoryStream = new MemoryStream();
    upload.CopyTo(memoryStream);
    memoryStream.Position = 0;
    // Load uploaded Excel file from the stream
    var workbook = WorkBook.Load(memoryStream);
    // Re-export as XLSX regardless of the original file extension or file type
    var stream = workbook.ToXlsxStream();
    string filename = Path.GetFileNameWithoutExtension(upload.FileName) + ".xlsx";
    return File(stream, "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet", filename);
}

Quels formats de fichiers peuvent être exportés ?

IronXL prend en charge l'exportation de données vers de multiples formats de tableur et d'échange de données. Le tableau ci-dessous récapitule les options de sortie disponibles et leurs meilleures utilisations.

| Format| Extension de fichier | Méthode de flux | Cas d'utilisation optimal | | ---| ---| ---| ---| | XLSX | .xlsx | ToXlsxStream() | Feuilles de calcul Excel modernes avec mise en forme et formules | | XLS | .xls | ToXlsStream() | Compatibilité avec les systèmes existants | | CSV | .csv | ToCsvStream() | Importation de bases de données, pipelines de données, exportation légère | | XML | .xml | ToXmlStream() | Intégration des systèmes d'entreprise | | JSON | .json | EnregistrerAuJson() | Réponses et échanges de données des API Web | | HTML | .html | ExporterEnHTML() | Affichage sur page Web des données de feuille de calcul |

Chaque méthode de flux renvoie un MemoryStream qui se connecte directement à la fonction d'assistance de retour File() d' ASP.NET Core. L'alternative de tableau d'octets (ToByteArray()) est également disponible pour les scénarios où un byte[] est plus pratique, par exemple lors de l'enregistrement dans une base de données blob ou de la jonction à un flux de réponse par e-mail. Toutes ces méthodes sont disponibles immédiatement après l'installation du package NuGet IronXL . Pour une description complète de chaque format d'exportation, consultez la documentation relative à l'exportation vers Excel .

Que l'objectif soit de télécharger des fichiers au format XLSX pour les analystes commerciaux, d'exporter des fichiers CSV pour les ingénieurs de données ou de générer du XML pour l'intégration d'entreprise, IronXL garantit un code propre et une sortie fiable pour les applications .NET Core et .NET Framework . Prêt à exporter des feuilles de calcul pour votre prochain projet ? Obtenez une licence d'essai gratuite ou explorez les options de licence pour commencer dès aujourd'hui. Pour obtenir des instructions d'installation étape par étape, reportez-vous au guide de démarrage IronXL .