ASP .NET C# で Excel ファイルをダウンロード: XLSX、CSV などにデータをエクスポート

コントローラーから Excel ファイルを作成してダウンロードする方法

ASP.NET Coreシナリオで Excel ファイルをダウンロードする場合のコア パターンには、ワークブックを作成し、それをストリームに書き込み、ストリームをファイル応答として返すという 3 つのステップが含まれます。 次のコードは、XLSX ファイルを最初から構築し、ブラウザーにプッシュする完全な MVC コントローラー アクションを示しています。

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

データベースデータをダウンロード可能なスプレッドシートにエクスポートする方法

実際のシナリオのほとんどは、ハードコードされた値ではなく、データベース テーブルからデータをエクスポートすることを伴います。 パターンは変わりません。データのクエリを実行し、ワークシートにデータを入力し、ファイルを返します。以下は、データベースからレコードを取得して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);
    }
}

XLSX ではなく CSV ファイルとしてデータをダウンロードするにはどうすればよいでしょうか?

軽量なCSVファイルの方が適している場合もあります。特に、Excelファイルの豊富な機能を必要としない他のシステム、データベース、ツールにデータを入力する場合などです。IronXLを使えば、フォーマットの切り替えが簡単になります。

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

アップロードを別の形式で再エクスポートするにはどうすればいいですか?

一般的な Web アプリケーションのシナリオには、ユーザーからアップロードされたファイルを受け入れて別の形式でエクスポートすること (たとえば、XLS アップロードを XLSX に変換したり、元々レガシー形式で保存されたワークブックから CSV ファイルを作成したりすること) が含まれます。

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

どのファイル形式をエクスポートできますか?

IronXL は、複数のスプレッドシートおよびデータ交換形式へのデータのエクスポートをサポートしています。 以下の表は、利用可能な出力オプションとその最適な使用方法をまとめたものです。

|形式| ファイル拡張子 | ストリーム方式 | 最適なユースケース | |---|---|---|---| | XLSX | .xlsx | ToXlsxStream() | 書式設定と数式を備えた最新の Excel スプレッドシート | | XLS | .xls | ToXlsStream() | レガシーシステムとの互換性 | | CSV | .csv | ToCsvStream() | データベースのインポート、データパイプライン、軽量エクスポート | | XML | .xml | ToXmlStream() | エンタープライズシステム統合 | | JSON | .json | SaveAsJson() | Web APIの応答とデータ交換 | | HTML | .html | HTMLにエクスポート() | スプレッドシートデータのWebページ表示 |

すべてのストリーム メソッドは、 ASP.NET Core の File() 戻りヘルパーに直接プラグインする MemoryStream を返します。 byte[] がより便利なシナリオでは、たとえば BLOB データベースに保存する場合や電子メール応答ストリームに添付する場合など、バイト配列の代替 (ToByteArray()) も使用できます。 これらの方法はすべて、 IronXL NuGetパッケージをインストールするとすぐに利用できるようになります。 各エクスポート形式の完全なチュートリアルについては、 Excel へのエクスポートのドキュメントを参照してください。

ビジネス アナリスト向けに XLSX 形式のファイルをダウンロードする、データ エンジニア向けに CSV ファイルをエクスポートする、エンタープライズ統合用に XML を生成するなど、どのような目的であっても、 IronXL は.NET Coreおよび.NET Frameworkアプリケーション全体でコードをクリーンに保ち、出力の信頼性を確保します。 次のプロジェクトでスプレッドシートのエクスポートを出荷する準備はできていますか? 無料の試用ライセンスを入手するか、ライセンス オプションを調べて今すぐ始めましょう。 詳細なセットアップ手順については、 IronXLスタートガイドを参照してください。