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

相互運用性の前提条件

Interop を使用する前に、次の点を確認してください。

1. 開発マシンと展開マシンに Microsoft Excel がインストールされています。
2. Visual Studio に"Microsoft Excel オブジェクト ライブラリ"への COM 参照が追加されます。
3. Microsoft.Office.Interop.Excel 名前空間がプロジェクトに含まれます。

相互運用エクスポートコード

次のコードは、トップレベルのステートメントを使用して C# で Microsoft Office Interop を使用して DataTable を Excel ファイルにエクスポートする方法を示しています。

using Microsoft.Office.Interop.Excel;
using System.Data;
using System.Runtime.InteropServices;

// Create a sample DataTable with employee data
DataTable dt = new DataTable("Employees");
dt.Columns.Add("EmployeeID", typeof(int));
dt.Columns.Add("Name", typeof(string));
dt.Columns.Add("Department", typeof(string));
dt.Columns.Add("Salary", typeof(decimal));

dt.Rows.Add(1, "John Smith", "Engineering", 75000);
dt.Rows.Add(2, "Sarah Johnson", "Marketing", 65000);
dt.Rows.Add(3, "Michael Chen", "Finance", 70000);
dt.Rows.Add(4, "Emily Davis", "Engineering", 80000);

// Initialize Excel Application object
Application excelApp = new Application
{
    Visible = false,
    DisplayAlerts = false
};

Workbook workbook = excelApp.Workbooks.Add();
Worksheet worksheet = (Worksheet)workbook.ActiveSheet;

try
{
    // Write column headers to the first row
    for (int i = 0; i < dt.Columns.Count; i++)
    {
        worksheet.Cells[1, i + 1] = dt.Columns[i].ColumnName;
    }

    // Write data rows starting from row 2
    for (int i = 0; i < dt.Rows.Count; i++)
    {
        for (int j = 0; j < dt.Columns.Count; j++)
        {
            worksheet.Cells[i + 2, j + 1] = dt.Rows[i][j].ToString();
        }
    }

    string filePath = @"C:\Reports\EmployeeReport_Interop.xlsx";
    workbook.SaveAs(filePath);
    Console.WriteLine("Excel file created using Interop.");
}
catch (Exception ex)
{
    Console.WriteLine("Error: " + ex.Message);
}
finally
{
    // Always release COM objects to prevent orphaned Excel processes
    workbook.Close();
    excelApp.Quit();
    Marshal.ReleaseComObject(worksheet);
    Marshal.ReleaseComObject(workbook);
    Marshal.ReleaseComObject(excelApp);
}

using Microsoft.Office.Interop.Excel;
using System.Data;
using System.Runtime.InteropServices;

// Create a sample DataTable with employee data
DataTable dt = new DataTable("Employees");
dt.Columns.Add("EmployeeID", typeof(int));
dt.Columns.Add("Name", typeof(string));
dt.Columns.Add("Department", typeof(string));
dt.Columns.Add("Salary", typeof(decimal));

dt.Rows.Add(1, "John Smith", "Engineering", 75000);
dt.Rows.Add(2, "Sarah Johnson", "Marketing", 65000);
dt.Rows.Add(3, "Michael Chen", "Finance", 70000);
dt.Rows.Add(4, "Emily Davis", "Engineering", 80000);

// Initialize Excel Application object
Application excelApp = new Application
{
    Visible = false,
    DisplayAlerts = false
};

Workbook workbook = excelApp.Workbooks.Add();
Worksheet worksheet = (Worksheet)workbook.ActiveSheet;

try
{
    // Write column headers to the first row
    for (int i = 0; i < dt.Columns.Count; i++)
    {
        worksheet.Cells[1, i + 1] = dt.Columns[i].ColumnName;
    }

    // Write data rows starting from row 2
    for (int i = 0; i < dt.Rows.Count; i++)
    {
        for (int j = 0; j < dt.Columns.Count; j++)
        {
            worksheet.Cells[i + 2, j + 1] = dt.Rows[i][j].ToString();
        }
    }

    string filePath = @"C:\Reports\EmployeeReport_Interop.xlsx";
    workbook.SaveAs(filePath);
    Console.WriteLine("Excel file created using Interop.");
}
catch (Exception ex)
{
    Console.WriteLine("Error: " + ex.Message);
}
finally
{
    // Always release COM objects to prevent orphaned Excel processes
    workbook.Close();
    excelApp.Quit();
    Marshal.ReleaseComObject(worksheet);
    Marshal.ReleaseComObject(workbook);
    Marshal.ReleaseComObject(excelApp);
}

Application オブジェクトは Excel プロセス自体を表します。 Visible = false を設定すると、バックグラウンド操作に不可欠な処理中に Excel が画面上で開かなくなります。 DisplayAlerts = false 設定により、自動化されたワークフローを中断する可能性のあるダイアログ ボックスが抑制されます。

finally ブロックはオプションではありません。Marshal.ReleaseComObject を使用して各 COM オブジェクトを明示的に解放する必要があります。 この手順を省略すると、タスク マネージャーに孤立した Excel プロセスが残り、メモリが消費され、最終的にサーバーが不安定になります。 このクリーンアップ パターンは、Interop が Web アプリケーションやサービスに適さない原因となる、よく知られた問題点です。

IronXLエクスポートコード

次のコードは、トップレベルのステートメントを持つIronXLライブラリを使用して、DataTable を Excel ファイルに変換する方法を示しています。

using IronXL;
using System.Data;

// Create a sample DataTable
DataTable dt = new DataTable("Employees");
dt.Columns.Add("EmployeeID", typeof(int));
dt.Columns.Add("Name", typeof(string));
dt.Columns.Add("Department", typeof(string));
dt.Columns.Add("Salary", typeof(decimal));

dt.Rows.Add(1, "John Smith", "Engineering", 75000);
dt.Rows.Add(2, "Sarah Johnson", "Marketing", 65000);
dt.Rows.Add(3, "Michael Chen", "Finance", 70000);
dt.Rows.Add(4, "Emily Davis", "Engineering", 80000);

// Create a new Excel workbook
WorkBook workbook = WorkBook.Create(ExcelFileFormat.XLSX);
WorkSheet sheet = workbook.CreateWorkSheet("Employees");

// Write column headers to row 0
for (int i = 0; i < dt.Columns.Count; i++)
{
    sheet.SetCellValue(0, i, dt.Columns[i].ColumnName);
}

// Export DataTable rows to Excel cells
for (int i = 0; i < dt.Rows.Count; i++)
{
    for (int j = 0; j < dt.Columns.Count; j++)
    {
        sheet.SetCellValue(i + 1, j, dt.Rows[i][j]);
    }
}

string filePath = @"C:\Reports\EmployeeReport_IronXL.xlsx";
workbook.SaveAs(filePath);
Console.WriteLine("Excel file created using IronXL.");

using IronXL;
using System.Data;

// Create a sample DataTable
DataTable dt = new DataTable("Employees");
dt.Columns.Add("EmployeeID", typeof(int));
dt.Columns.Add("Name", typeof(string));
dt.Columns.Add("Department", typeof(string));
dt.Columns.Add("Salary", typeof(decimal));

dt.Rows.Add(1, "John Smith", "Engineering", 75000);
dt.Rows.Add(2, "Sarah Johnson", "Marketing", 65000);
dt.Rows.Add(3, "Michael Chen", "Finance", 70000);
dt.Rows.Add(4, "Emily Davis", "Engineering", 80000);

// Create a new Excel workbook
WorkBook workbook = WorkBook.Create(ExcelFileFormat.XLSX);
WorkSheet sheet = workbook.CreateWorkSheet("Employees");

// Write column headers to row 0
for (int i = 0; i < dt.Columns.Count; i++)
{
    sheet.SetCellValue(0, i, dt.Columns[i].ColumnName);
}

// Export DataTable rows to Excel cells
for (int i = 0; i < dt.Rows.Count; i++)
{
    for (int j = 0; j < dt.Columns.Count; j++)
    {
        sheet.SetCellValue(i + 1, j, dt.Rows[i][j]);
    }
}

string filePath = @"C:\Reports\EmployeeReport_IronXL.xlsx";
workbook.SaveAs(filePath);
Console.WriteLine("Excel file created using IronXL.");

IronXL のアプローチは同様の論理構造に従いますが、構文がより明確で、COM の複雑さがありません。 WorkBook.Create メソッドは、指定された形式で新しいブックを初期化します -- ExcelFileFormat.XLSX は、Excel 2007 以降と互換性のある最新の Office Open XML ファイルを生成します。 ライブラリは、レガシー システム用の XLS もサポートしています。

SetCellValue は、標準 for .NET規則に一致する 0 ベースのインデックスを使用します。これにより、インデックス システム間の変換時によく発生する off-by-one エラーが削減されます。 このメソッドは型変換を自動的に処理します。整数、文字列、小数、および DateTime の値は、適切な Excel セル型で書き込まれます。

クリーンアップ コードがまったく存在しないことに注意してください。 IronXLオブジェクトは、ガベージ コレクターが自動的に処理する標準 for .NET管理オブジェクトです。 孤立したプロセスや COM 参照カウントを管理するリスクはありません。

ワークブック作成の詳細については、 IronXLスプレッドシート作成ガイドを参照してください。

再利用可能なIronXLエクスポートヘルパー

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

// --- ExcelExporter helper ---

bool ExportToExcel(DataTable dt, string filePath)
{
    if (dt == null || dt.Rows.Count == 0)
        return false;

    try
    {
        WorkBook workbook = WorkBook.Create(ExcelFileFormat.XLSX);
        WorkSheet sheet = workbook.CreateWorkSheet(dt.TableName ?? "Sheet1");

        // Bold headers in the first row
        for (int i = 0; i < dt.Columns.Count; i++)
        {
            var cell = sheet.GetCellAt(0, i);
            cell.Value = dt.Columns[i].ColumnName;
            cell.Style.Font.Bold = true;
        }

        // Data rows
        for (int i = 0; i < dt.Rows.Count; i++)
        {
            for (int j = 0; j < dt.Columns.Count; j++)
            {
                var value = dt.Rows[i][j];
                sheet.SetCellValue(
                    i + 1, j,
                    (value == DBNull.Value || value == null) ? "" : value
                );
            }
        }

        FileInfo fileInfo = new FileInfo(filePath);
        if (!fileInfo.Directory!.Exists)
            fileInfo.Directory.Create();

        workbook.SaveAs(filePath);
        return true;
    }
    catch (Exception ex)
    {
        Console.WriteLine("Export failed: " + ex.Message);
        return false;
    }
}

// --- Usage ---

DataTable employees = new DataTable("Employees");
employees.Columns.Add("EmployeeID", typeof(int));
employees.Columns.Add("Name", typeof(string));
employees.Columns.Add("Department", typeof(string));
employees.Rows.Add(1, "John Smith", "Engineering");
employees.Rows.Add(2, "Sarah Johnson", "Marketing");

bool success = ExportToExcel(employees, @"C:\Reports\Export.xlsx");
Console.WriteLine(success ? "Export completed." : "Export failed.");

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

// --- ExcelExporter helper ---

bool ExportToExcel(DataTable dt, string filePath)
{
    if (dt == null || dt.Rows.Count == 0)
        return false;

    try
    {
        WorkBook workbook = WorkBook.Create(ExcelFileFormat.XLSX);
        WorkSheet sheet = workbook.CreateWorkSheet(dt.TableName ?? "Sheet1");

        // Bold headers in the first row
        for (int i = 0; i < dt.Columns.Count; i++)
        {
            var cell = sheet.GetCellAt(0, i);
            cell.Value = dt.Columns[i].ColumnName;
            cell.Style.Font.Bold = true;
        }

        // Data rows
        for (int i = 0; i < dt.Rows.Count; i++)
        {
            for (int j = 0; j < dt.Columns.Count; j++)
            {
                var value = dt.Rows[i][j];
                sheet.SetCellValue(
                    i + 1, j,
                    (value == DBNull.Value || value == null) ? "" : value
                );
            }
        }

        FileInfo fileInfo = new FileInfo(filePath);
        if (!fileInfo.Directory!.Exists)
            fileInfo.Directory.Create();

        workbook.SaveAs(filePath);
        return true;
    }
    catch (Exception ex)
    {
        Console.WriteLine("Export failed: " + ex.Message);
        return false;
    }
}

// --- Usage ---

DataTable employees = new DataTable("Employees");
employees.Columns.Add("EmployeeID", typeof(int));
employees.Columns.Add("Name", typeof(string));
employees.Columns.Add("Department", typeof(string));
employees.Rows.Add(1, "John Smith", "Engineering");
employees.Rows.Add(2, "Sarah Johnson", "Marketing");

bool success = ExportToExcel(employees, @"C:\Reports\Export.xlsx");
Console.WriteLine(success ? "Export completed." : "Export failed.");

ExportToExcel ヘルパーは任意の DataTable とファイル パス文字列を受け入れ、エクスポートが失敗した場合、またはテーブルが空の場合には false を返します。 セルに書き込む前に DBNull.Value をチェックすることで、欠損値を適切に処理します。 ディレクトリ作成手順により、DirectoryNotFoundException が新しいフォルダ パスへのスケジュールされたエクスポートを中断することが防止されます (これは、新しい環境に展開する場合の一般的な運用上の問題です)。

太字のヘッダーは cell.Style.Font.Bold = true を使用して適用され、追加の構成なしでプロフェッショナルな外観の出力が生成されます。 パターンは簡単に拡張でき、組織のレポート標準に合わせて背景色、境界線、列幅の自動調整などを追加できます。

大規模なデータセットを扱う場合、 IronXLパフォーマンス ガイドでは、メモリ割り当てを最小限に抑える一括書き込み戦略について説明しています。 このライブラリは、関連するオブジェクトのコレクションである DataSet -- を単一のワークブック内の複数のワークシートにエクスポートすることもサポートしており、これは複数シートのレポートに便利です。

IronXLによるフォーマット

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

DataTable dt = new DataTable("Sales");
dt.Columns.Add("Product", typeof(string));
dt.Columns.Add("Revenue", typeof(decimal));
dt.Rows.Add("Widget A", 15000.50m);
dt.Rows.Add("Widget B", 22500.75m);

WorkBook workbook = WorkBook.Create(ExcelFileFormat.XLSX);
WorkSheet sheet = workbook.CreateWorkSheet("Sales");

// Write headers with light blue background and bold font
for (int i = 0; i < dt.Columns.Count; i++)
{
    var cell = sheet.GetCellAt(0, i);
    cell.Value = dt.Columns[i].ColumnName;
    cell.Style.Font.Bold = true;
    cell.Style.SetBackgroundColor("#ADD8E6");
    cell.Style.BottomBorder.SetColor("#000000");
    cell.Style.BottomBorder.Type = BorderType.Thin;
}

// Write data rows
for (int i = 0; i < dt.Rows.Count; i++)
{
    for (int j = 0; j < dt.Columns.Count; j++)
    {
        sheet.SetCellValue(i + 1, j, dt.Rows[i][j]);
    }
}

workbook.SaveAs(@"C:\Reports\FormattedReport_IronXL.xlsx");
Console.WriteLine("Formatted Excel file created.");

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

DataTable dt = new DataTable("Sales");
dt.Columns.Add("Product", typeof(string));
dt.Columns.Add("Revenue", typeof(decimal));
dt.Rows.Add("Widget A", 15000.50m);
dt.Rows.Add("Widget B", 22500.75m);

WorkBook workbook = WorkBook.Create(ExcelFileFormat.XLSX);
WorkSheet sheet = workbook.CreateWorkSheet("Sales");

// Write headers with light blue background and bold font
for (int i = 0; i < dt.Columns.Count; i++)
{
    var cell = sheet.GetCellAt(0, i);
    cell.Value = dt.Columns[i].ColumnName;
    cell.Style.Font.Bold = true;
    cell.Style.SetBackgroundColor("#ADD8E6");
    cell.Style.BottomBorder.SetColor("#000000");
    cell.Style.BottomBorder.Type = BorderType.Thin;
}

// Write data rows
for (int i = 0; i < dt.Rows.Count; i++)
{
    for (int j = 0; j < dt.Columns.Count; j++)
    {
        sheet.SetCellValue(i + 1, j, dt.Rows[i][j]);
    }
}

workbook.SaveAs(@"C:\Reports\FormattedReport_IronXL.xlsx");
Console.WriteLine("Formatted Excel file created.");

IronXL のスタイリング API はクリーンなオブジェクト モデルを使用します。 色の値は、#ADD8E6 (水色) などの標準の 16 進コードを受け入れるため、カラー システム間で変換することなく、企業のブランドと簡単に一致させることができます。 BorderType.Thin および BorderType.Thick は、列挙の検索を必要とせずに標準的な境界シナリオをカバーします。

数値書式、条件付き書式、セル結合などのすべてのスタイル設定オプションについては、 IronXLセル スタイル設定ガイドと境界線と配置のドキュメントを参照してください。

相互運用フォーマットの複雑さ

Interop 同等機能は、個々の Range オブジェクトにアクセスし、Interior.Color、および Borders.LineStyle などのプロパティを設定します。 各プロパティへのアクセスはCOMプロセス間呼び出しであるため、オーバーヘッドが増加し、Excelが応答しなくなった場合に例外が発生する可能性が高くなります。色の値はMarshal.ReleaseComObject呼び出し)を実行する必要があります。

この冗長性は、大きなワークシート全体に条件付き書式、列幅、または数値書式を適用するときに問題になります。 IronXL は、クラッシュ後に Excel プロセスが実行されたままになるリスクなしに、より少ないコード行数で同じシナリオを処理します。

命名とパスの規則

エクスポートされたファイルには一貫した命名規則を使用します: {ReportName}_{Timestamp}.xlsx。 予測可能なファイル名により、自動クリーンアップとアーカイブが簡単になります。 出力ディレクトリをハードコーディング パスではなくアプリケーション構成に保存します。これにより、新しい環境にデプロイするときに DirectoryNotFoundException が防止されます。

エラーハンドリング

すべてのエクスポート ロジックを try-catch ブロックでラップし、失敗を診断するのに十分なコンテキストで例外をログに記録します。 スケジュールされたエクスポートの場合は、例外をスローするのではなく結果オブジェクトを返すことを検討してください。これにより、呼び出し元のサービスはクラッシュせずに再試行したり、オペレーターに警告したりできるようになります。 上記の ExportToExcel ヘルパーは、 bool 戻り値を使用してこのパターンを示しています。

大規模データセットの取り扱い

50,000 行を超えるデータセットの場合は、メモリ負荷を回避するためにデータをバッチでストリーミングします。 IronXL はプログレッシブ書き込みをサポートし、 OpenXML SDKは非常に大きなファイルに対して低レベルのストリーミングを提供します。 大規模なデータセットでは Interop を完全に避けてください。メモリ内モデルにより、規模が大きくなると大幅な速度低下が発生します。

クロスプラットフォームデプロイメント

アプリケーションがLinuxまたはmacOS(例えばDockerコンテナやAzure Linux App Services)上で実行される場合、 IronXLが唯一の選択肢となります。InteropはExcel COMサーバーに依存しているため、Windows以外では機能しません。 .NETクロスプラットフォーム展開ガイドを使用して、すべての依存関係がターゲット ランタイムで使用可能であることを確認します。

テスティング

エクスポート ロジックの単体テストでは、出力ファイルが存在し、予想される行数を含み、正しい列名が使用されていることを確認する必要があります。 IronXL の WorkBook.Load メソッドを使用すると、Excel を起動せずにテストでエクスポートされたファイルを簡単に読み戻すことができます。 例については、 IronXL読書ガイドを参照してください。