Excel-Dateien in .NET C# herunterladen: Daten nach XLSX, CSV und mehr exportieren

Wie erstellt und lädt man eine Excel-Datei von einem Controller herunter?

Das grundlegende Vorgehen beim Herunterladen einer Excel-Datei in einem ASP.NET Core Szenario umfasst drei Schritte: Erstellen der Arbeitsmappe, Schreiben in einen Stream und Zurückgeben des Streams als Dateiantwort. Der folgende Code zeigt eine vollständige MVC-Controller-Aktion, die eine XLSX-Datei von Grund auf neu erstellt und an den Browser sendet.

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);
    }
}

Wie exportiere ich Datenbankdaten in eine herunterladbare Tabellenkalkulation?

In den meisten realen Anwendungsfällen geht es darum, Daten aus einer Datenbanktabelle zu exportieren, anstatt fest codierte Werte zu verwenden. Das Vorgehen bleibt gleich: Daten abfragen, Tabellenblätter füllen und die Datei zurückgeben. Hier ist ein Beispiel, das das Abrufen von Datensätzen aus einer Datenbank und deren Schreiben in ein Excel-Dokument simuliert.

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);
    }
}

Wie lade ich Daten als CSV-Dateien anstatt als XLSX-Dateien herunter?

Manchmal ist eine schlanke CSV-Datei die bessere Wahl, insbesondere wenn Daten in andere Systeme, Datenbanken oder Tools eingespeist werden, die nicht den umfangreichen Funktionsumfang einer Excel-Datei benötigen. IronXL macht den Wechsel zwischen verschiedenen Formaten kinderleicht.

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);
    }
}

Wie exportiere ich einen Upload in einem anderen Format?

Ein typisches Szenario für Webanwendungen besteht darin, von Benutzern hochgeladene Dateien entgegenzunehmen und sie in einem anderen Formatzu exportieren, beispielsweise eine XLS-Datei in XLSX zu konvertieren oder CSV-Dateien aus einer Arbeitsmappe zu erstellen, die ursprünglich in einem älteren Formatgespeichert wurde.

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);
}

Welche Dateiformate können exportiert werden?

IronXL unterstützt den Export von Daten in verschiedene Tabellenkalkulations- und Datenaustauschformate. Die folgende Tabelle fasst die verfügbaren Ausgabeoptionen und ihre besten Anwendungsbereiche zusammen.

| Format| Dateierweiterung | Stream-Methode | Bester Anwendungsfall | | ---| ---| ---| ---| | XLSX | .xlsx | ToXlsxStream() | Moderne Excel-Tabellen mit Formatierung und Formeln | | XLS | .xls | ToXlsStream() | Kompatibilität mit älteren Systemen | | CSV | .csv | ToCsvStream() | Datenbankimporte, Datenpipelines, schlanker Export | | XML | .xml | ToXmlStream() | Integration von Unternehmenssystemen | | JSON | .json | SaveAsJson() | Web-API-Antworten und Datenaustausch | | HTML | .html | ExportToHtml() | Webseitendarstellung von Tabellendaten |

Jede Stream-Methode gibt einen MemoryStream zurück, der direkt in den File()-Rückgabehelfer von ASP.NET Core eingebunden wird. Die Alternative mit einem Byte-Array (ToByteArray()) steht ebenfalls zur Verfügung, beispielsweise beim Speichern in einer Blob-Datenbank oder beim Anhängen an einen E-Mail-Antwortstrom. Alle diese Methoden stehen unmittelbar nach der Installation des IronXL NuGet Pakets zur Verfügung. Eine vollständige Beschreibung der einzelnen Exportformate finden Sie in der Dokumentation zum Export nach Excel .

Egal ob es darum geht, Dateien im XLSX-Format für Business-Analysten herunterzuladen, CSV-Dateien für Dateningenieure zu exportieren oder XML für die Unternehmensintegration zu generieren – IronXL sorgt für sauberen Code und zuverlässige Ergebnisse in .NET Core und .NET Framework Anwendungen. Sind Sie bereit, in Ihrem nächsten Projekt Tabellenkalkulationsexporte zu versenden? Sichern Sie sich eine kostenlose Testlizenz oder informieren Sie sich über die verschiedenen Lizenzoptionen, um noch heute loszulegen. Eine Schritt-für-Schritt-Anleitung zur Einrichtung finden Sie im IronXL Leitfaden für Einsteiger .