C# で GridView を書式付きで Excel にエクスポートする方法

.NETプロジェクトにライブラリをインストールするにはどうすればよいでしょうか?

エクスポート コードを書く前に、 NuGetからIronXLをインストールします。 パッケージマネージャーコンソールを開いて次を実行します：

Install-Package IronXL
dotnet add package IronXL

Install-Package IronXL
dotnet add package IronXL

IronXL は、.NET 8、 .NET 9、 .NET 10 に加え、 .NET Framework 4.6.2 以降をサポートしています。 インストール後、Excel 操作を実行するすべてのファイルに次の using ディレクティブを追加します。

using IronXL;
using IronXl.Styles;

using IronXL;
using IronXl.Styles;

追加のランタイムや Office 相互運用性は必要ありません。 このライブラリは、Microsoft Excel、LibreOffice Calc、Google Sheets できれいに開くネイティブ XLSX バイナリ ファイルを書き込みます。

セルの書式設定を含む Windows フォーム DataGridView を Excel にエクスポートするにはどうすればよいですか?

Windows フォーム アプリケーションでは、Web ベースの GridView ではなく、DataGridView コントロールが使用されます。 どちらの場合もエクスポート パターンは同じです。行とセルから値を抽出し、IronXL ワークブックを作成し、スタイルを適用して、結果を保存またはストリーミングします。

最も信頼性の高い方法は、コントロールの DataSource プロパティを DataTable にキャストして、フィルター処理またはページングされる可能性のあるビジュアル行の反復処理を回避することです。

using IronXL;
using IronXl.Styles;
using System;
using System.Data;
using System.IO;
using System.Windows.Forms;

DataTable dt = (DataTable)dataGridView1.DataSource;

WorkBook workBook = WorkBook.Create(ExcelFileFormat.XLSX);
WorkSheet sheet = workBook.DefaultWorkSheet;

// Header row -- bold, blue background, white text
for (int col = 0; col < dt.Columns.Count; col++)
{
    sheet.SetCellValue(0, col, dt.Columns[col].ColumnName);
    var cell = sheet.GetCellAt(0, col);
    cell.Style.Font.Bold = true;
    cell.Style.SetBackgroundColor("#4472C4");
    cell.Style.Font.Color = "#FFFFFF";
    cell.Style.BottomBorder.Type = BorderType.Thin;
}

// Data rows -- alternating row color
for (int row = 0; row < dt.Rows.Count; row++)
{
    for (int col = 0; col < dt.Columns.Count; col++)
    {
        string value = dt.Rows[row][col]?.ToString() ?? string.Empty;
        sheet.SetCellValue(row + 1, col, value);

        var cell = sheet.GetCellAt(row + 1, col);
        cell.Style.SetBackgroundColor(row % 2 == 0 ? "#D6DCE5" : "#FFFFFF");
        cell.Style.BottomBorder.Type = BorderType.Thin;
    }
}

// Save via dialog
using var saveDialog = new SaveFileDialog
{
    Filter = "Excel Files|*.xlsx",
    FileName = "GridViewExport.xlsx"
};

if (saveDialog.ShowDialog() == DialogResult.OK)
{
    workBook.SaveAs(saveDialog.FileName);
    MessageBox.Show("Export successful.", "Export",
        MessageBoxButtons.OK, MessageBoxIcon.Information);
}

using IronXL;
using IronXl.Styles;
using System;
using System.Data;
using System.IO;
using System.Windows.Forms;

DataTable dt = (DataTable)dataGridView1.DataSource;

WorkBook workBook = WorkBook.Create(ExcelFileFormat.XLSX);
WorkSheet sheet = workBook.DefaultWorkSheet;

// Header row -- bold, blue background, white text
for (int col = 0; col < dt.Columns.Count; col++)
{
    sheet.SetCellValue(0, col, dt.Columns[col].ColumnName);
    var cell = sheet.GetCellAt(0, col);
    cell.Style.Font.Bold = true;
    cell.Style.SetBackgroundColor("#4472C4");
    cell.Style.Font.Color = "#FFFFFF";
    cell.Style.BottomBorder.Type = BorderType.Thin;
}

// Data rows -- alternating row color
for (int row = 0; row < dt.Rows.Count; row++)
{
    for (int col = 0; col < dt.Columns.Count; col++)
    {
        string value = dt.Rows[row][col]?.ToString() ?? string.Empty;
        sheet.SetCellValue(row + 1, col, value);

        var cell = sheet.GetCellAt(row + 1, col);
        cell.Style.SetBackgroundColor(row % 2 == 0 ? "#D6DCE5" : "#FFFFFF");
        cell.Style.BottomBorder.Type = BorderType.Thin;
    }
}

// Save via dialog
using var saveDialog = new SaveFileDialog
{
    Filter = "Excel Files|*.xlsx",
    FileName = "GridViewExport.xlsx"
};

if (saveDialog.ShowDialog() == DialogResult.OK)
{
    workBook.SaveAs(saveDialog.FileName);
    MessageBox.Show("Export successful.", "Export",
        MessageBoxButtons.OK, MessageBoxIcon.Information);
}

WorkBook.Create は、XLSX 形式で新しいメモリ内ワークブックを初期化します。 DefaultWorkSheet は最初のシートを返します。保存する前に、Name プロパティを使用して名前を変更できます。 SetCellValue は文字列、整数、倍精度浮動小数点数、および DateTime 値を受け入れます -- IronXL は正しいセル タイプを自動的に選択します。

交互の行の色のパターン (row % 2 == 0 は #D6DCE5 を選択し、それ以外の場合は #FFFFFF) は、Excel に組み込まれている縞模様の行のテーブル スタイルを反映します。 アプリケーションのデザイン システムに一致する任意の 6 文字の 16 進色を代用できます。

ASP.NET GridView を Excel にエクスポートし、そのファイルをブラウザーにストリーミングするにはどうすればよいですか?

Web アプリケーションには異なる配信メカニズムが必要です。 ファイル システムに書き込む代わりに、ワークブックを MemoryStream にシリアル化し、正しいヘッダーを使用して HTTP 応答に書き込みます。これにより、ブラウザーはそれをファイルのダウンロードとして扱います。

ページ分割された GridView の重要な事前手順: ページングを無効にし (AllowPaging = false)、エクスポート前にデータ ソースを再バインドして、現在のページだけでなくすべてのレコードがキャプチャされるようにします。

using IronXL;
using IronXl.Styles;
using System;
using System.Data;
using System.IO;
using System.Web.UI;

// Disable paging so all rows are captured
GridView1.AllowPaging = false;
GridView1.DataBind();

DataTable dt = (DataTable)GridView1.DataSource;

WorkBook workBook = WorkBook.Create(ExcelFileFormat.XLSX);
WorkSheet sheet = workBook.DefaultWorkSheet;

// Header row
for (int col = 0; col < dt.Columns.Count; col++)
{
    sheet.SetCellValue(0, col, dt.Columns[col].ColumnName);
    var cell = sheet.GetCellAt(0, col);
    cell.Style.Font.Bold = true;
    cell.Style.SetBackgroundColor("#2E75B6");
    cell.Style.Font.Color = "#FFFFFF";
    cell.Style.HorizontalAlignment = HorizontalAlignment.Center;
    cell.Style.BottomBorder.Type = BorderType.Medium;
}

// Data rows
for (int row = 0; row < dt.Rows.Count; row++)
{
    for (int col = 0; col < dt.Columns.Count; col++)
    {
        sheet.SetCellValue(row + 1, col, dt.Rows[row][col]?.ToString() ?? string.Empty);
        var cell = sheet.GetCellAt(row + 1, col);
        cell.Style.SetBackgroundColor(row % 2 == 0 ? "#DEEAF1" : "#FFFFFF");
        cell.Style.BottomBorder.Type = BorderType.Thin;
        cell.Style.LeftBorder.Type = BorderType.Thin;
        cell.Style.RightBorder.Type = BorderType.Thin;
    }
}

// Stream to browser
byte[] fileBytes = workBook.ToByteArray();
Response.Clear();
Response.ContentType = "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet";
Response.AddHeader("content-disposition", "attachment; filename=GridViewExport.xlsx");
Response.BinaryWrite(fileBytes);
Response.End();

using IronXL;
using IronXl.Styles;
using System;
using System.Data;
using System.IO;
using System.Web.UI;

// Disable paging so all rows are captured
GridView1.AllowPaging = false;
GridView1.DataBind();

DataTable dt = (DataTable)GridView1.DataSource;

WorkBook workBook = WorkBook.Create(ExcelFileFormat.XLSX);
WorkSheet sheet = workBook.DefaultWorkSheet;

// Header row
for (int col = 0; col < dt.Columns.Count; col++)
{
    sheet.SetCellValue(0, col, dt.Columns[col].ColumnName);
    var cell = sheet.GetCellAt(0, col);
    cell.Style.Font.Bold = true;
    cell.Style.SetBackgroundColor("#2E75B6");
    cell.Style.Font.Color = "#FFFFFF";
    cell.Style.HorizontalAlignment = HorizontalAlignment.Center;
    cell.Style.BottomBorder.Type = BorderType.Medium;
}

// Data rows
for (int row = 0; row < dt.Rows.Count; row++)
{
    for (int col = 0; col < dt.Columns.Count; col++)
    {
        sheet.SetCellValue(row + 1, col, dt.Rows[row][col]?.ToString() ?? string.Empty);
        var cell = sheet.GetCellAt(row + 1, col);
        cell.Style.SetBackgroundColor(row % 2 == 0 ? "#DEEAF1" : "#FFFFFF");
        cell.Style.BottomBorder.Type = BorderType.Thin;
        cell.Style.LeftBorder.Type = BorderType.Thin;
        cell.Style.RightBorder.Type = BorderType.Thin;
    }
}

// Stream to browser
byte[] fileBytes = workBook.ToByteArray();
Response.Clear();
Response.ContentType = "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet";
Response.AddHeader("content-disposition", "attachment; filename=GridViewExport.xlsx");
Response.BinaryWrite(fileBytes);
Response.End();

Response.AddHeader と content-disposition: attachment を組み合わせると、すべての最新ブラウザでファイルのダウンロード ダイアログが強制表示されます。 MIME タイプ application/vnd.openxmlformats-officedocument.spreadsheetml.sheet は XLSX ファイルの登録タイプであり、ブラウザがバイナリ コンテンツをインラインで表示することを防ぎます。

ASP.NET Coreアプリケーションの場合、コントローラー アクションで Response.BinaryWrite を File(fileBytes, contentType, fileName) に置き換えます。ワークブックの作成ロジックは同じです。

// Assume "DueDate" is column index 3 and "Amount" is column index 4
DateTime today = DateTime.Today;

for (int row = 0; row < dt.Rows.Count; row++)
{
    // Highlight past-due dates
    if (dt.Columns.Contains("DueDate") && dt.Rows[row]["DueDate"] != DBNull.Value)
    {
        DateTime dueDate = Convert.ToDateTime(dt.Rows[row]["DueDate"]);
        var dueDateCell = sheet.GetCellAt(row + 1, 3);
        if (dueDate < today)
        {
            dueDateCell.Style.SetBackgroundColor("#FF0000");
            dueDateCell.Style.Font.Color = "#FFFFFF";
            dueDateCell.Style.Font.Bold = true;
        }
    }

    // Highlight amounts below threshold
    if (dt.Columns.Contains("Amount") && dt.Rows[row]["Amount"] != DBNull.Value)
    {
        decimal amount = Convert.ToDecimal(dt.Rows[row]["Amount"]);
        var amountCell = sheet.GetCellAt(row + 1, 4);
        if (amount < 100m)
        {
            amountCell.Style.SetBackgroundColor("#FFC000");
        }
    }
}

// Assume "DueDate" is column index 3 and "Amount" is column index 4
DateTime today = DateTime.Today;

for (int row = 0; row < dt.Rows.Count; row++)
{
    // Highlight past-due dates
    if (dt.Columns.Contains("DueDate") && dt.Rows[row]["DueDate"] != DBNull.Value)
    {
        DateTime dueDate = Convert.ToDateTime(dt.Rows[row]["DueDate"]);
        var dueDateCell = sheet.GetCellAt(row + 1, 3);
        if (dueDate < today)
        {
            dueDateCell.Style.SetBackgroundColor("#FF0000");
            dueDateCell.Style.Font.Color = "#FFFFFF";
            dueDateCell.Style.Font.Bold = true;
        }
    }

    // Highlight amounts below threshold
    if (dt.Columns.Contains("Amount") && dt.Rows[row]["Amount"] != DBNull.Value)
    {
        decimal amount = Convert.ToDecimal(dt.Rows[row]["Amount"]);
        var amountCell = sheet.GetCellAt(row + 1, 4);
        if (amount < 100m)
        {
            amountCell.Style.SetBackgroundColor("#FFC000");
        }
    }
}

列幅を設定し、ヘッダー行を固定するにはどうすればよいでしょうか?

専門的にフォーマットされた Excel エクスポートには、適切な列幅と固定されたヘッダー行が含まれており、ユーザーが大規模なデータセットをスクロールしても列名が表示されたままになります。

IronXL は、列幅を WorkSheet 列アクセサを通じて公開し、ヘッダーを FreezeRows メソッドを通じて固定します。

// Auto-size columns 0 through the last column index
for (int col = 0; col < dt.Columns.Count; col++)
{
    // Set column width in character units (1 unit ≈ one default character width)
    sheet.SetColumnWidth(col, 20);
}

// Freeze the first row (index 0) so the header stays visible while scrolling
sheet.FreezeRows(1);

// Optionally set row height for the header (in points)
sheet.SetRowHeight(0, 20);

// Auto-size columns 0 through the last column index
for (int col = 0; col < dt.Columns.Count; col++)
{
    // Set column width in character units (1 unit ≈ one default character width)
    sheet.SetColumnWidth(col, 20);
}

// Freeze the first row (index 0) so the header stays visible while scrolling
sheet.FreezeRows(1);

// Optionally set row height for the header (in points)
sheet.SetRowHeight(0, 20);

実稼働環境で使用する場合は、固定値を使用するのではなく、各列の最大文字数に基づいて幅を計算することを検討してください。 DataTable 列の値を反復処理し、文字列の長さを測定し、選択したフォント サイズに適した文字幅係数を掛けます。

よりきめ細かなスタイル設定のアプローチとして、行バンドのロジックとは独立してC# を使用して Excel セルに背景色を適用することもできます。

GridView コントロールなしで DataTable を Excel にエクスポートするにはどうすればよいですか?

多く for .NETアプリケーションは、サービス呼び出しまたはデータベース クエリを通じてデータを入力し、それを UI コントロールにバインドすることなく DataTable に保持します。 GridView をインスタンス化せずに、DataTable を Excel に直接エクスポートできます。

これは、サーバー上で Excel ファイルを生成する必要があるバックグラウンド ジョブ、スケジュールされたレポート、および API エンドポイントにとって最も効率的なパスです。

using IronXL;
using IronXl.Styles;
using System.Data;

public static byte[] DataTableToExcelBytes(DataTable dt, string sheetName = "Report")
{
    WorkBook workBook = WorkBook.Create(ExcelFileFormat.XLSX);
    WorkSheet sheet = workBook.CreateWorkSheet(sheetName);

    // Header
    for (int col = 0; col < dt.Columns.Count; col++)
    {
        sheet.SetCellValue(0, col, dt.Columns[col].ColumnName);
        var cell = sheet.GetCellAt(0, col);
        cell.Style.Font.Bold = true;
        cell.Style.SetBackgroundColor("#4472C4");
        cell.Style.Font.Color = "#FFFFFF";
    }

    // Data
    for (int row = 0; row < dt.Rows.Count; row++)
    {
        for (int col = 0; col < dt.Columns.Count; col++)
        {
            sheet.SetCellValue(row + 1, col, dt.Rows[row][col]?.ToString() ?? string.Empty);
        }
    }

    return workBook.ToByteArray();
}

using IronXL;
using IronXl.Styles;
using System.Data;

public static byte[] DataTableToExcelBytes(DataTable dt, string sheetName = "Report")
{
    WorkBook workBook = WorkBook.Create(ExcelFileFormat.XLSX);
    WorkSheet sheet = workBook.CreateWorkSheet(sheetName);

    // Header
    for (int col = 0; col < dt.Columns.Count; col++)
    {
        sheet.SetCellValue(0, col, dt.Columns[col].ColumnName);
        var cell = sheet.GetCellAt(0, col);
        cell.Style.Font.Bold = true;
        cell.Style.SetBackgroundColor("#4472C4");
        cell.Style.Font.Color = "#FFFFFF";
    }

    // Data
    for (int row = 0; row < dt.Rows.Count; row++)
    {
        for (int col = 0; col < dt.Columns.Count; col++)
        {
            sheet.SetCellValue(row + 1, col, dt.Rows[row][col]?.ToString() ?? string.Empty);
        }
    }

    return workBook.ToByteArray();
}

このメソッドは、ディスクに書き込んだり、API エンドポイントからストリーミングしたり、電子メールに添付したり、メモリにキャッシュしたりできる byte[] を返します。 関連するテクニックについては、 DataTable を Excel にエクスポートするガイドと、 DataTable を Excel にエクスポートする最も速い方法に関するチュートリアルを参照してください。

大規模なデータセットとパフォーマンスをどのように処理しますか?

数万行を Excel にエクスポートする場合は、メモリの割り当てに注意する必要があります。 大規模なグリッド内のすべてのセルに対して新しいセル スタイル オブジェクトを作成することが、最も一般的なパフォーマンスのボトルネックになります。 個々のセルではなく範囲オブジェクトにスタイルを設定することで、可能な場合はスタイル定義を再利用します。

ページ分割された GridView の場合は、エクスポートする前に必ず AllowPaging = false を設定し、再バインドしてください。 ページングによりコントロール内に表示される行数が制限されるため、ページングされたエクスポートではデータセット全体ではなく現在のページのみがキャプチャされます。これが不完全なエクスポートのバグの頻繁な原因となります。

型指定されていない行ではなく、厳密に型指定されたコレクションで機能するパターンについては、C# でオブジェクトのリストを Excel にエクスポートする方法についてのガイドを確認することもできます。

ASP.NET CoreまたはBlazorで GridView をエクスポートするにはどうすればよいですか?

ASP.NET CoreアプリケーションとBlazorアプリケーションには Web フォーム コントロールはありませんが、データエクスポートの基本的な課題は同じです。つまり、オブジェクトのコレクションまたは CODE-959--@@ を取得し、スタイル設定されたワークブックを構築して、ファイルを出力します。ワークブック作成コードは同じです。 配信メカニズムのみが変わります。

Blazorアプリケーションで、 JavaScript相互運用機能を通じてファイルのダウンロードをトリガーします。

// In a Blazor component or service
using IronXL;
using System.Data;
using Microsoft.JSInterop;

public async Task ExportToExcelAsync(DataTable dt, IJSRuntime js)
{
    WorkBook workBook = WorkBook.Create(ExcelFileFormat.XLSX);
    WorkSheet sheet = workBook.DefaultWorkSheet;

    for (int col = 0; col < dt.Columns.Count; col++)
    {
        sheet.SetCellValue(0, col, dt.Columns[col].ColumnName);
        var cell = sheet.GetCellAt(0, col);
        cell.Style.Font.Bold = true;
        cell.Style.SetBackgroundColor("#4472C4");
        cell.Style.Font.Color = "#FFFFFF";
    }

    for (int row = 0; row < dt.Rows.Count; row++)
    {
        for (int col = 0; col < dt.Columns.Count; col++)
        {
            sheet.SetCellValue(row + 1, col, dt.Rows[row][col]?.ToString() ?? string.Empty);
        }
    }

    byte[] fileBytes = workBook.ToByteArray();
    string base64 = Convert.ToBase64String(fileBytes);
    await js.InvokeVoidAsync("downloadFileFromBase64", base64, "GridViewExport.xlsx",
        "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet");
}

// In a Blazor component or service
using IronXL;
using System.Data;
using Microsoft.JSInterop;

public async Task ExportToExcelAsync(DataTable dt, IJSRuntime js)
{
    WorkBook workBook = WorkBook.Create(ExcelFileFormat.XLSX);
    WorkSheet sheet = workBook.DefaultWorkSheet;

    for (int col = 0; col < dt.Columns.Count; col++)
    {
        sheet.SetCellValue(0, col, dt.Columns[col].ColumnName);
        var cell = sheet.GetCellAt(0, col);
        cell.Style.Font.Bold = true;
        cell.Style.SetBackgroundColor("#4472C4");
        cell.Style.Font.Color = "#FFFFFF";
    }

    for (int row = 0; row < dt.Rows.Count; row++)
    {
        for (int col = 0; col < dt.Columns.Count; col++)
        {
            sheet.SetCellValue(row + 1, col, dt.Rows[row][col]?.ToString() ?? string.Empty);
        }
    }

    byte[] fileBytes = workBook.ToByteArray();
    string base64 = Convert.ToBase64String(fileBytes);
    await js.InvokeVoidAsync("downloadFileFromBase64", base64, "GridViewExport.xlsx",
        "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet");
}

Blazorダウンロード パターンの完全なウォークスルーについては、 Blazorから Excel へのエクスポートのチュートリアルをご覧ください。 ASP.NET Coreコントローラー アプローチについては、 ASP.NET Coreエクスポート Excel チュートリアルを参照してください。

ネイティブ Excel ライブラリが HtmlTextWriter よりもクリーンなエクスポートを生成するのはなぜですか?

従来のASP.NETエクスポート手法 (VerifyRenderingInServerForm をオーバーライドし、StringWriter と HtmlTextWriter を作成し、レンダリングされたコントロールを応答に書き込む) では、.xls 拡張子を持つ HTML ドキュメントが生成されます。 Microsoft Excel では、ファイルが実際には Excel バイナリまたは OOXML 形式ではないため、このようなファイルは互換性の警告とともに開かれます。 スタイルは、Excel が部分的に解釈するインライン CSS に制限されます。 条件付き書式は不可能です。 Windows 以外のプラットフォームを使用しているユーザーや LibreOffice を使用しているユーザーには、品質の低い出力が表示されます。

IronXL はOpen XML スプレッドシート形式 (OOXML) を直接書き込みます。 結果は適切な .xlsx ファイル (Excel 自体が作成するものと同一) であり、macOS 上の Excel、LibreOffice、Google Sheets、Numbers で警告なしで開きます。 書式設定は HTML 属性ではなくスプレッドシート スタイルとしてエンコードされるため、ラウンドトリップやクロスプラットフォームの表示でも維持されます。

Open XML SDKに関する Microsoft の公式ドキュメントでは、 IronXL が生成する基礎となる形式について説明しています。 ECMA International によって管理されている OOXML 仕様は、アプリケーション間の互換性を保証する標準を定義します。 Microsoft Docs のASP.NET GridView コントロールのドキュメントでは、上記のエクスポート パターンが読み取るコントロール モデルについて説明しています。

次のステップは何ですか?

これで、Windows フォーム、 ASP.NET Web フォーム、 ASP.NET Core、およびBlazor配信モデルをカバーし、 IronXLを使用して GridView および DataGridView データを適切にフォーマットされた XLSX ファイルにエクスポートするために必要なパターンが手に入りました。

さらに進むには:

• IronXLの無料トライアルを開始して、独自のデータに対して完全なフォーマットとエクスポート機能をテストします。
• ピボット テーブル、グラフ、データ検証などの完全な API リファレンスについては、 IronXLドキュメントを確認してください。
• 上記のエクスポート パターンを計算されたサマリーやグラフと組み合わせて、 C# で Excel レポートを作成する方法を学びます。
• アプリケーションでアップロードされたスプレッドシートも使用する必要がある場合は、補完的なインポート ワークフローについては、"C# で Excel ファイルを読み取る"を参照してください。
• XLSX と並行した CSV ベースのエクスポートについては、 C# からの CSV へのエクスポートのチュートリアルを参照してください。
• 列ヘッダーを最初の行として DataGridView からデータをエクスポートする場合は、専用の列ヘッダー付き DataGridView から Excel へのガイドを参照してください。