C# DataGridView から Excel へのエクスポート: 書式設定の完全ガイド | IronXL

NuGet経由でIronXLをインストールする

まず、Visual Studio で.NET 10 をターゲットとする新しい Windows フォーム アプリ プロジェクトを作成します。フォーム サーフェイスに DataGridView コントロールと Button を追加します。 ボタンに btnExport という名前を付け、"Excel にエクスポート"というラベルを付けます。 次に、 NuGetパッケージ マネージャー コンソールを開いて、次を実行します。

Install-Package IronXl.Excel

Install-Package IronXl.Excel

必要な名前空間をフォーム ファイルの先頭に追加します。

using IronXL;
using System.Data;

using IronXL;
using System.Data;

これら 2 つの名前空間は、 Excel ワークブックの読み取りと書き込みに必要なすべてのIronXL型と、エクスポート パイプラインに橋渡しするオブジェクトを操作するための標準の型をカバーします。

DataTable を DataGridView にバインドする

void Form1_Load(object sender, EventArgs e)
{
    DataTable dt = new DataTable();
    dt.Columns.Add("ProductID", typeof(int));
    dt.Columns.Add("ProductName", typeof(string));
    dt.Columns.Add("Price", typeof(decimal));
    dt.Columns.Add("Stock", typeof(int));

    dt.Rows.Add(1, "Laptop", 999.99m, 50);
    dt.Rows.Add(2, "Mouse", 29.99m, 200);
    dt.Rows.Add(3, "Keyboard", 79.99m, 150);
    dt.Rows.Add(4, "Monitor", 349.99m, 75);
    dt.Rows.Add(5, "Webcam", 89.99m, 120);

    dataGridView1.DataSource = dt;
}

void Form1_Load(object sender, EventArgs e)
{
    DataTable dt = new DataTable();
    dt.Columns.Add("ProductID", typeof(int));
    dt.Columns.Add("ProductName", typeof(string));
    dt.Columns.Add("Price", typeof(decimal));
    dt.Columns.Add("Stock", typeof(int));

    dt.Rows.Add(1, "Laptop", 999.99m, 50);
    dt.Rows.Add(2, "Mouse", 29.99m, 200);
    dt.Rows.Add(3, "Keyboard", 79.99m, 150);
    dt.Rows.Add(4, "Monitor", 349.99m, 75);
    dt.Rows.Add(5, "Webcam", 89.99m, 120);

    dataGridView1.DataSource = dt;
}

このコードでは、イベント ハンドラーのシグネチャにトップレベルのステートメント スタイルが使用されています。 DataTable には、整数、文字列、小数点、整数の 4 つの型指定された列があり、 IronXL はExcel ブックに書き込むときにこれらを保持します。 型指定された列は重要ですIronXL は数値列をテキストではなく数値セルとして書き込むため、ユーザーは Excel で値を再フォーマットせずに並べ替えたり合計したりすることができます。

DataGridView は、DataTable 列名から列ヘッダー行を自動的にレンダリングします。 エクスポートする場合、ヘッダー行を Excel ファイル内に保持する必要があります。つまり、エクスポート コードではヘッダーをデータ行とは別に処理する必要があります。次のセクションでは、この点について詳しく説明します。

運用環境では、DataTable が Entity Framework、Dapper、ADO .NET、またはその他のデータ アクセス レイヤーからのものであるかどうかに関係なく、同じパターンが適用されます。 DataGridView バインディングはエクスポート コードから分離されているため、エクスポート ロジックに触れることなくデータ ソースを交換できます。

ボタンクリックエクスポートハンドラー

void btnExport_Click(object sender, EventArgs e)
{
    try
    {
        DataTable dt = new DataTable();

        foreach (DataGridViewColumn column in dataGridView1.Columns)
            dt.Columns.Add(column.HeaderText);

        foreach (DataGridViewRow row in dataGridView1.Rows)
        {
            if (row.IsNewRow) continue;

            DataRow dataRow = dt.NewRow();
            for (int i = 0; i < dataGridView1.Columns.Count; i++)
                dataRow[i] = row.Cells[i].Value ?? DBNull.Value;

            dt.Rows.Add(dataRow);
        }

        WorkBook workbook = WorkBook.Create(ExcelFileFormat.XLSX);
        WorkSheet worksheet = workbook.DefaultWorkSheet;
        worksheet.Name = "Product Data";

        worksheet.LoadFromDataTable(dt, true);

        string outputPath = Path.Combine(
            Environment.GetFolderPath(Environment.SpecialFolder.Desktop),
            "DataGridViewExport.xlsx"
        );

        workbook.SaveAs(outputPath);
        MessageBox.Show($"Exported successfully to:\n{outputPath}", "Export Complete",
            MessageBoxButtons.OK, MessageBoxIcon.Information);
    }
    catch (Exception ex)
    {
        MessageBox.Show($"Export failed: {ex.Message}", "Error",
            MessageBoxButtons.OK, MessageBoxIcon.Error);
    }
}

void btnExport_Click(object sender, EventArgs e)
{
    try
    {
        DataTable dt = new DataTable();

        foreach (DataGridViewColumn column in dataGridView1.Columns)
            dt.Columns.Add(column.HeaderText);

        foreach (DataGridViewRow row in dataGridView1.Rows)
        {
            if (row.IsNewRow) continue;

            DataRow dataRow = dt.NewRow();
            for (int i = 0; i < dataGridView1.Columns.Count; i++)
                dataRow[i] = row.Cells[i].Value ?? DBNull.Value;

            dt.Rows.Add(dataRow);
        }

        WorkBook workbook = WorkBook.Create(ExcelFileFormat.XLSX);
        WorkSheet worksheet = workbook.DefaultWorkSheet;
        worksheet.Name = "Product Data";

        worksheet.LoadFromDataTable(dt, true);

        string outputPath = Path.Combine(
            Environment.GetFolderPath(Environment.SpecialFolder.Desktop),
            "DataGridViewExport.xlsx"
        );

        workbook.SaveAs(outputPath);
        MessageBox.Show($"Exported successfully to:\n{outputPath}", "Export Complete",
            MessageBoxButtons.OK, MessageBoxIcon.Information);
    }
    catch (Exception ex)
    {
        MessageBox.Show($"Export failed: {ex.Message}", "Error",
            MessageBoxButtons.OK, MessageBoxIcon.Error);
    }
}

LoadFromDataTable(dt, true) 呼び出しは、DataTable と、 IronXL に列名を最初の Excel 行として書き込むように指示するブール フラグを受け取ります。これらがヘッダー セルになります。 ワークブックは、ハードコードされたパスではなく、Environment.SpecialFolder.Desktop を使用してユーザーのデスクトップに保存されるため、ユーザー アカウント間でコードを移植できます。

null チェック (?? セルに値が含まれていない場合は、DBNull.Value) prevents a NullReferenceException が発生します。 これは、オプションのフィールドが空になる可能性がある実際のデータにとって重要です。 IronXL は、DBNull を文字列 "DBNull" ではなく空のセルとして書き込むため、出力はクリーンなままになります。

Excel ファイルから DataGridView にデータを読み込む方法の詳細については、 IronXL DataTable のドキュメントを参照してください。このドキュメントでは、逆の操作と、複数シートのワークブック用にExcel を DataSet に変換する方法について説明しています。

ヘッダースタイルと行の色の切り替えの適用

void ExportWithFormatting(object sender, EventArgs e)
{
    WorkBook workbook = WorkBook.Create(ExcelFileFormat.XLSX);
    WorkSheet worksheet = workbook.DefaultWorkSheet;
    worksheet.Name = "Formatted Export";

    string[] headers = { "ID", "Product Name", "Price", "Stock" };

    // Write and style header row
    for (int col = 0; col < headers.Length; col++)
    {
        char colLetter = (char)('A' + col);
        string cellAddress = $"{colLetter}1";

        worksheet.SetCellValue(0, col, headers[col]);
        worksheet[cellAddress].Style.Font.Bold = true;
        worksheet[cellAddress].Style.Font.Height = 12;
        worksheet[cellAddress].Style.SetBackgroundColor("#4472C4");
        worksheet[cellAddress].Style.Font.Color = "#FFFFFF";
        worksheet[cellAddress].Style.HorizontalAlignment =
            IronXl.Styles.HorizontalAlignment.Center;
    }

    // Write data rows with alternating background colors
    int rowIndex = 1;
    foreach (DataGridViewRow row in dataGridView1.Rows)
    {
        if (row.IsNewRow) continue;

        for (int col = 0; col < dataGridView1.Columns.Count; col++)
        {
            worksheet.SetCellValue(rowIndex, col,
                row.Cells[col].Value?.ToString() ?? string.Empty);
        }

        if (rowIndex % 2 == 0)
        {
            string rangeAddress = $"A{rowIndex + 1}:D{rowIndex + 1}";
            worksheet[rangeAddress].Style.SetBackgroundColor("#D6DCE5");
        }

        rowIndex++;
    }

    // Format the Price column as currency
    worksheet["C2:C100"].Style.Format = "$#,##0.00";

    // Auto-fit column widths
    worksheet.AutoSizeColumn(0);
    worksheet.AutoSizeColumn(1);
    worksheet.AutoSizeColumn(2);
    worksheet.AutoSizeColumn(3);

    string outputPath = Path.Combine(
        Environment.GetFolderPath(Environment.SpecialFolder.Desktop),
        "FormattedExport.xlsx"
    );

    workbook.SaveAs(outputPath);
    MessageBox.Show("Formatted export complete.", "Done",
        MessageBoxButtons.OK, MessageBoxIcon.Information);
}

void ExportWithFormatting(object sender, EventArgs e)
{
    WorkBook workbook = WorkBook.Create(ExcelFileFormat.XLSX);
    WorkSheet worksheet = workbook.DefaultWorkSheet;
    worksheet.Name = "Formatted Export";

    string[] headers = { "ID", "Product Name", "Price", "Stock" };

    // Write and style header row
    for (int col = 0; col < headers.Length; col++)
    {
        char colLetter = (char)('A' + col);
        string cellAddress = $"{colLetter}1";

        worksheet.SetCellValue(0, col, headers[col]);
        worksheet[cellAddress].Style.Font.Bold = true;
        worksheet[cellAddress].Style.Font.Height = 12;
        worksheet[cellAddress].Style.SetBackgroundColor("#4472C4");
        worksheet[cellAddress].Style.Font.Color = "#FFFFFF";
        worksheet[cellAddress].Style.HorizontalAlignment =
            IronXl.Styles.HorizontalAlignment.Center;
    }

    // Write data rows with alternating background colors
    int rowIndex = 1;
    foreach (DataGridViewRow row in dataGridView1.Rows)
    {
        if (row.IsNewRow) continue;

        for (int col = 0; col < dataGridView1.Columns.Count; col++)
        {
            worksheet.SetCellValue(rowIndex, col,
                row.Cells[col].Value?.ToString() ?? string.Empty);
        }

        if (rowIndex % 2 == 0)
        {
            string rangeAddress = $"A{rowIndex + 1}:D{rowIndex + 1}";
            worksheet[rangeAddress].Style.SetBackgroundColor("#D6DCE5");
        }

        rowIndex++;
    }

    // Format the Price column as currency
    worksheet["C2:C100"].Style.Format = "$#,##0.00";

    // Auto-fit column widths
    worksheet.AutoSizeColumn(0);
    worksheet.AutoSizeColumn(1);
    worksheet.AutoSizeColumn(2);
    worksheet.AutoSizeColumn(3);

    string outputPath = Path.Combine(
        Environment.GetFolderPath(Environment.SpecialFolder.Desktop),
        "FormattedExport.xlsx"
    );

    workbook.SaveAs(outputPath);
    MessageBox.Show("Formatted export complete.", "Done",
        MessageBoxButtons.OK, MessageBoxIcon.Information);
}

フォーマット コードではいくつかのテクニックが適用されます。 ヘッダー行には、青い背景 (#4472C4)、白いテキスト、12 ポイントの太字フォント、中央揃え (標準的なビジネス スプレッドシート スタイル) が適用されます。 データ行は偶数行ごとに白と薄い灰色で交互に表示されます (#D6DCE5)。これにより、ユーザーは幅の広いテーブルでも場所を失うことなく読みやすくなります。 価格列では Excel の組み込み通貨形式 ($#,##0.00) が使用されるため、基になる数値データは変更されずに、スプレッドシートにドル記号と 2 桁の小数点付きで値が表示されます。 AutoSizeColumn 各列をその最長値に適合させるため、内容が切り捨てられることはありません。

セル境界線のスタイル、条件付き書式、およびデータ検証ルールを使用して、このパターンをさらに拡張できます。 企業テンプレートと一致する必要があるレポートの場合は、ページ レイアウトと印刷領域を設定して、エクスポートされたファイルを調整せずに印刷できるようにすることもできます。