IronXLを使用して C# で DataGridView を Excel にエクスポートする方法

Excel エクスポート用に Windows フォーム プロジェクトを設定するにはどうすればよいですか?

Windows フォームは、 .NETエコシステムの基本的な GUI ライブラリであり、デスクトップ アプリケーションの構築に広く使用されています。 DataGridView コントロールは、最もよく使用されるコンポーネントの 1 つであり、DataTable、データベース クエリ結果、メモリ内リストなどのバインド可能なソースからの表形式のデータを表示、編集、管理します。

グリッド データを Excel にエクスポートすると、関係者にレポートを送信したり、監査用にスナップショットをアーカイブしたり、下流の分析ツールにデータを入力したりするなど、さまざまな日常的なニーズに対応できます。 従来の 2 つのアプローチは、Microsoft オフィス相互運用性 とサードパーティ ライブラリです。 相互運用性では、アプリケーションを実行するすべてのマシンに Excel のコピーがインストールされている必要があり、COM オブジェクトのライフサイクルの問題が発生し、サーバーまたはクラウドの展開でのパフォーマンスが低下します。 IronXL 、ClosedXML、Syncfusion などのライブラリは、Office に依存せずに Open XML ファイル形式に直接書き込むことで、これらの問題を回避します。

このガイドでは、 .NET 10 をターゲットとする C# でのIronXLアプローチについて説明しますが、 IronXL は.NET Framework 4.6.2 とすべての最新 for .NETバージョンをサポートしています。

Install-Package IronXL
dotnet add package IronXL

Install-Package IronXL
dotnet add package IronXL

using IronXL;
using System.Data;

using IronXL;
using System.Data;

DataGridView にサンプル データを入力するにはどうすればよいでしょうか?

このチュートリアルでは、フォームに DataGridView1 という名前の DataGridView と btnExport という名前のボタンが含まれています。 グリッドには、フォームの Load イベントで、DataTable に保存されている従業員レコードが入力されます。

void Form1_Load(object sender, EventArgs e)
{
    var dt = new DataTable();

    // Define columns with the appropriate .NET type
    dt.Columns.Add("EmployeeID", typeof(int));
    dt.Columns.Add("Name", typeof(string));
    dt.Columns.Add("Department", typeof(string));
    dt.Columns.Add("Salary", typeof(decimal));

    // Add sample rows
    dt.Rows.Add(101, "Sarah Johnson", "Engineering", 85000m);
    dt.Rows.Add(102, "Michael Chen", "Marketing", 72000m);
    dt.Rows.Add(103, "Emily Davis", "Finance", 91000m);
    dt.Rows.Add(104, "James Wilson", "Engineering", 78000m);

    DataGridView1.DataSource = dt;
}

void Form1_Load(object sender, EventArgs e)
{
    var dt = new DataTable();

    // Define columns with the appropriate .NET type
    dt.Columns.Add("EmployeeID", typeof(int));
    dt.Columns.Add("Name", typeof(string));
    dt.Columns.Add("Department", typeof(string));
    dt.Columns.Add("Salary", typeof(decimal));

    // Add sample rows
    dt.Rows.Add(101, "Sarah Johnson", "Engineering", 85000m);
    dt.Rows.Add(102, "Michael Chen", "Marketing", 72000m);
    dt.Rows.Add(103, "Emily Davis", "Finance", 91000m);
    dt.Rows.Add(104, "James Wilson", "Engineering", 78000m);

    DataGridView1.DataSource = dt;
}

各列は特定 for .NET型で定義されるため、後で数値の比較と書式設定が正しく機能します。 DataSource プロパティは、DataTable を DataGridView に直接バインドし、フォームが開いたときにグリッドによってすべての行が自動的にレンダリングされます。 本番環境では、このデータは通常、ハードコードされた値ではなく、データベース クエリ、ORM 結果セット、または REST API 応答から取得されます。

列ヘッダー付きの Excel ファイルに DataGridView データをエクスポートするにはどうすればよいですか?

エクスポート ロジックは、ボタンのクリック ハンドラー内にあります。 コードは新しい WorkBook を作成し、デフォルトのワークシートを取得し、列ヘッダーを最初の行に書き込み、次に各データ行をその下に書き込みます。

void btnExport_Click(object sender, EventArgs e)
{
    var workbook = WorkBook.Create();
    var sheet = workbook.DefaultWorkSheet;

    // Write column headers to row index 0
    for (int col = 0; col < DataGridView1.Columns.Count; col++)
    {
        sheet.SetCellValue(0, col, DataGridView1.Columns[col].HeaderText);
    }

    // Write data rows starting at row index 1
    for (int row = 0; row < DataGridView1.Rows.Count; row++)
    {
        for (int col = 0; col < DataGridView1.Columns.Count; col++)
        {
            object? cellValue = DataGridView1.Rows[row].Cells[col].Value;
            if (cellValue is not null)
            {
                sheet.SetCellValue(row + 1, col, cellValue.ToString()!);
            }
        }
    }

    string outputPath = "EmployeeData.xlsx";
    workbook.SaveAs(outputPath);
    MessageBox.Show("Export complete. File saved to: " + outputPath, "Success");
}

void btnExport_Click(object sender, EventArgs e)
{
    var workbook = WorkBook.Create();
    var sheet = workbook.DefaultWorkSheet;

    // Write column headers to row index 0
    for (int col = 0; col < DataGridView1.Columns.Count; col++)
    {
        sheet.SetCellValue(0, col, DataGridView1.Columns[col].HeaderText);
    }

    // Write data rows starting at row index 1
    for (int row = 0; row < DataGridView1.Rows.Count; row++)
    {
        for (int col = 0; col < DataGridView1.Columns.Count; col++)
        {
            object? cellValue = DataGridView1.Rows[row].Cells[col].Value;
            if (cellValue is not null)
            {
                sheet.SetCellValue(row + 1, col, cellValue.ToString()!);
            }
        }
    }

    string outputPath = "EmployeeData.xlsx";
    workbook.SaveAs(outputPath);
    MessageBox.Show("Export complete. File saved to: " + outputPath, "Success");
}

WorkBookオブジェクトは、メモリ内の Excel ファイル全体を表します。 DefaultWorkSheet は、明示的にシートを作成する必要なく、最初のシートを返します。 外側のループは、HeaderText からのヘッダー テキストを 0 行目に書き込みます。 次に、ネストされたループは各データ行を反復処理し、セルの値を文字列に変換する前に null かどうかをチェックします。 row + 1 オフセットはデータをヘッダー行の下にシフトします。 SaveAs は、完成したブックをOpen XML XLSX ファイルとして指定されたパスに書き込みます。

結果のファイルは、Excel、Google Sheets、または XLSX 形式を読み取る任意のアプリケーションで開きます。 列ヘッダーは最初の行に表示され、すべてのデータ行は DataGridView に表示された順序と同じ順序で続きます。

エクスポートされた Excel ファイルにセルの書式設定を適用するにはどうすればよいですか?

単純なデータ ダンプは機能しますが、プレゼンテーションには使用できません。 IronXL のスタイル API を使用すると、保存する前に任意のセル範囲に太字フォント、背景色、テキスト色、数値書式を適用できます。

void ExportWithFormatting()
{
    var workbook = WorkBook.Create();
    var sheet = workbook.DefaultWorkSheet;

    // Write column headers
    for (int col = 0; col < DataGridView1.Columns.Count; col++)
    {
        sheet.SetCellValue(0, col, DataGridView1.Columns[col].HeaderText);
    }

    // Style the header row: bold white text on blue background
    var headerRange = sheet.GetRange("A1:D1");
    headerRange.Style.Font.Bold = true;
    headerRange.Style.SetBackgroundColor("#4472C4");
    headerRange.Style.Font.SetColor("#FFFFFF");

    // Locate the Salary column index
    int salaryColIndex = -1;
    for (int i = 0; i < DataGridView1.Columns.Count; i++)
    {
        if (string.Equals(DataGridView1.Columns[i].HeaderText, "Salary",
            StringComparison.OrdinalIgnoreCase))
        {
            salaryColIndex = i;
            break;
        }
    }

    // Write data rows, preserving numeric types
    for (int row = 0; row < DataGridView1.Rows.Count; row++)
    {
        if (DataGridView1.Rows[row].IsNewRow) continue;

        for (int col = 0; col < DataGridView1.Columns.Count; col++)
        {
            object? cellValue = DataGridView1.Rows[row].Cells[col].Value;
            if (cellValue is null) continue;

            int targetRow = row + 1;

            if (col == salaryColIndex)
            {
                // Write salary as a true numeric decimal
                if (decimal.TryParse(cellValue.ToString(),
                    System.Globalization.NumberStyles.Number,
                    System.Globalization.CultureInfo.InvariantCulture,
                    out decimal decValue))
                {
                    sheet.SetCellValue(targetRow, col, decValue);
                }
                else
                {
                    sheet.SetCellValue(targetRow, col, cellValue.ToString()!);
                }
            }
            else
            {
                sheet.SetCellValue(targetRow, col, cellValue.ToString()!);
            }
        }
    }

    // Apply currency format to the salary column data range
    var salaryRange = sheet.GetRange("D2:D5");
    salaryRange.FormatString = "$#,##0";

    workbook.SaveAs("FormattedEmployeeData.xlsx");
}

void ExportWithFormatting()
{
    var workbook = WorkBook.Create();
    var sheet = workbook.DefaultWorkSheet;

    // Write column headers
    for (int col = 0; col < DataGridView1.Columns.Count; col++)
    {
        sheet.SetCellValue(0, col, DataGridView1.Columns[col].HeaderText);
    }

    // Style the header row: bold white text on blue background
    var headerRange = sheet.GetRange("A1:D1");
    headerRange.Style.Font.Bold = true;
    headerRange.Style.SetBackgroundColor("#4472C4");
    headerRange.Style.Font.SetColor("#FFFFFF");

    // Locate the Salary column index
    int salaryColIndex = -1;
    for (int i = 0; i < DataGridView1.Columns.Count; i++)
    {
        if (string.Equals(DataGridView1.Columns[i].HeaderText, "Salary",
            StringComparison.OrdinalIgnoreCase))
        {
            salaryColIndex = i;
            break;
        }
    }

    // Write data rows, preserving numeric types
    for (int row = 0; row < DataGridView1.Rows.Count; row++)
    {
        if (DataGridView1.Rows[row].IsNewRow) continue;

        for (int col = 0; col < DataGridView1.Columns.Count; col++)
        {
            object? cellValue = DataGridView1.Rows[row].Cells[col].Value;
            if (cellValue is null) continue;

            int targetRow = row + 1;

            if (col == salaryColIndex)
            {
                // Write salary as a true numeric decimal
                if (decimal.TryParse(cellValue.ToString(),
                    System.Globalization.NumberStyles.Number,
                    System.Globalization.CultureInfo.InvariantCulture,
                    out decimal decValue))
                {
                    sheet.SetCellValue(targetRow, col, decValue);
                }
                else
                {
                    sheet.SetCellValue(targetRow, col, cellValue.ToString()!);
                }
            }
            else
            {
                sheet.SetCellValue(targetRow, col, cellValue.ToString()!);
            }
        }
    }

    // Apply currency format to the salary column data range
    var salaryRange = sheet.GetRange("D2:D5");
    salaryRange.FormatString = "$#,##0";

    workbook.SaveAs("FormattedEmployeeData.xlsx");
}

GetRange メソッドは、標準の Excel 表記 (A1:D1) を受け入れて、連続したセル ブロックを選択します。 Style.SetBackgroundColor、および Style.Font.SetColor を設定すると、選択範囲内のすべてのセルにこれらの書式が適用されます。 数値列の場合、値を文字列ではなく decimal として書き込むと、データ型がそのまま維持されます。つまり、Excel は $#,##0 などの数値書式を正しく適用できます。 文字列として保存されたセルは数値書式コードに応答しません。

IronXLスタイル設定ドキュメントを参照して、このパターンを拡張し、交互の行の網掛け、列幅の自動調整、またはペインの固定を適用できます。

DataGridView データを XLSX ではなく CSV にエクスポートするにはどうすればよいですか?

一部のワークフローでは、レガシー システムまたは軽量データ パイプラインとの互換性を確保するために CSV 出力が必要です。 IronXL は、メイン コードに追加の構成変更を加えずに CSV エクスポートを処理します。

void ExportToCsv()
{
    var workbook = WorkBook.Create();
    var sheet = workbook.DefaultWorkSheet;

    for (int col = 0; col < DataGridView1.Columns.Count; col++)
    {
        sheet.SetCellValue(0, col, DataGridView1.Columns[col].HeaderText);
    }

    for (int row = 0; row < DataGridView1.Rows.Count; row++)
    {
        if (DataGridView1.Rows[row].IsNewRow) continue;

        for (int col = 0; col < DataGridView1.Columns.Count; col++)
        {
            object? cell = DataGridView1.Rows[row].Cells[col].Value;
            if (cell is not null)
                sheet.SetCellValue(row + 1, col, cell.ToString()!);
        }
    }

    // Saving with a .csv extension produces a comma-separated file
    workbook.SaveAs("EmployeeData.csv");
}

void ExportToCsv()
{
    var workbook = WorkBook.Create();
    var sheet = workbook.DefaultWorkSheet;

    for (int col = 0; col < DataGridView1.Columns.Count; col++)
    {
        sheet.SetCellValue(0, col, DataGridView1.Columns[col].HeaderText);
    }

    for (int row = 0; row < DataGridView1.Rows.Count; row++)
    {
        if (DataGridView1.Rows[row].IsNewRow) continue;

        for (int col = 0; col < DataGridView1.Columns.Count; col++)
        {
            object? cell = DataGridView1.Rows[row].Cells[col].Value;
            if (cell is not null)
                sheet.SetCellValue(row + 1, col, cell.ToString()!);
        }
    }

    // Saving with a .csv extension produces a comma-separated file
    workbook.SaveAs("EmployeeData.csv");
}

XLSX エクスポートからの唯一の変更点は、SaveAs に渡されるファイル拡張子です。 IronXL は拡張子を検出し、ワークブックを正しい形式で自動的にシリアル化します。 この一貫性により、出力形式に関係なくデータ書き込みロジックは同一のままになります。これは、形式ごとに個別のコードパスを必要とするライブラリに比べて大きな利点です。

CSV エクスポートは、下流のコンシューマーがPython pandas スクリプト、データベース一括インポート ツール、またはバイナリ XLSX ファイルを読み取ることができない分析プラットフォームである場合に特に便利です。

大規模な DataGridView データセットを効率的に処理するにはどうすればよいでしょうか?

数万行のグリッドの場合、パフォーマンスが考慮されるようになります。 次のパターンは、完全なデータセットを 1 回のパスで構築することでメモリ負荷を軽減します。

DataGridView が DataTable にバインドされている場合、セルごとの反復処理を完全にバイパスして、 WorkSheet.LoadDataTableメソッドを使用してテーブルをIronXLに直接ロードできます。 このアプローチはより高速であり、すべての列タイプが自動的に保持されます。

DataTable に裏付けられていないグリッドの場合、前に示したセルごとのパターンが標準的なアプローチのままになります。 大規模なエクスポート中に UI の応答性を維持するために非同期的にエクスポートする必要がある場合は、エクスポート ロジックを Task.Run 呼び出しでラップし、結果をバックグラウンド スレッドで await します。 結果を UI スレッドにマーシャリングするパターンについては、非同期ファイル操作のドキュメントを参照してください。

DataGridView エクスポートの場合、 IronXL がオフィス相互運用性 よりも優れているのはなぜですか?

従来 for .NETソリューションでは、実行中の Excel プロセスを駆動するために Microsoft.Office.Interop.Excel を使用していました。 このアプローチでは、いくつかの展開および信頼性の問題が発生します。

• アプリケーションを実行するすべてのマシンに、Microsoft Excel のライセンスコピーがインストールされている必要があります。
• サーバー環境やクラウドコンテナでは、通常、Officeをインストールできません。
• COM相互運用性では、メモリリークやゾンビExcelプロセスを回避するために、すべてのオブジェクトの明示的な解放が必要です。
• COM境界を越えたエラー処理は冗長で脆弱である
• 行数が増えるとパフォーマンスが急速に低下します

IronXL は、外部プロセスを起動せずにOOXML ファイル形式に直接書き込みます。 アプリケーションは自己完結型のユニットとして展開されます。 ライブラリの API は完全に管理された.NETであるため、ガベージ コレクションは、Marshal.ReleaseComObject 呼び出しなしでメモリを自動的に処理します。 プロセス間通信が発生しないため、速度が大幅に向上します。

代替案を評価するチームにとって、 ClosedXMLは人気のあるオープンソース オプションです。 IronXL は、 PDF 変換、チャート生成、商用サポートなど、企業の調達決定の要因となる可能性のある幅広い機能セットを提供します。 IronXLライセンス オプションを確認し、チームの規模と展開シナリオに適した層を選択します。

IronXLチュートリアル セクションでは、既存の Excel ファイルの読み取り、テンプレートの変更、グラフの生成、条件付き書式の適用について説明します。これらはすべて、ここで示す DataGridView エクスポート パターンから自然に拡張される機能です。

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

これで、 IronXLを使用して DataGridView をフォーマットされた Excel ファイルにエクスポートするための C# コードが機能するようになりました。 ここから、次の方向を検討してください。

-エラー処理を追加: エクスポート コードを try/catch ブロックで囲み、ファイルがロックされているかパスが無効な場合は、ユーザーフレンドリーなメッセージを表示します。 -ファイル パスの選択をサポート: SaveFileDialog を使用して、実行時にユーザーが出力場所とファイル名を選択できるようにします。 -実際のデータをロードする: サンプル DataTable をADO .NETまたは Entity Framework を使用したデータベース クエリに置き換えます -既存のファイルの読み取り: WorkBook.Loadを使用して、常に新しいスプレッドシートを作成するのではなく、既存のスプレッドシートを開いて更新します。 -複数のシートにエクスポート: 関連するデータセットを整理するために、同じシートに追加のオブジェクトを作成します。 -条件付き書式を適用する: IronXL の条件付き書式 APIを使用して、しきい値を超えるセルを強調表示します。 -ライセンス オプションを確認します。無料試用版が利用可能です。 ライセンス層は、個々の開発者から企業展開までをカバーします -完全なAPIリファレンスを参照: IronXLオブジェクトリファレンスには、利用可能なすべてのクラスとメソッドが記載されています。