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

DataTable エクスポート用にIronXLをインストールするにはどうすればよいでしょうか?

エクスポート コードを記述する前に、 IronXL をプロジェクトに追加します。 Visual StudioでPackage Manager Consoleを開き、実行してください：

Install-Package IronXL
dotnet add package IronXL

Install-Package IronXL
dotnet add package IronXL

IronXL は、Microsoft Office、Access データベース エンジン、または COM 相互運用レイヤーに依存しません。 パッケージをインストールすると、1 行も変更せずに、Windows、Linux、macOS、Docker、 Azure 、 AWSで同じコードを実行できます。

開発者が Excel エクスポートに オレDB を依然として使用する理由は何ですか?

オレDB はすでに.NET Frameworkの一部であったため、Excel 自動化のデフォルトの選択肢となりました。 開発者は既に ADO .NETを知っていたので、オレDBCommand、および オレDBDataAdapter を再利用して Excel に書き込むのは自然なことでした。 サードパーティのパッケージは必要ありませんでした。また、CREATE TABLE および INSERT INTO の SQL のような構文により、データベース プログラミングに精通しているユーザーであればその意図が明らかになりました。

オレDB を使用して DataTable をエクスポートするための従来のパターンは次のとおりです。

using System.Data;
using System.Data.オレDB;

// Build a sample DataTable
DataTable dataTable = new DataTable("Products");
dataTable.Columns.Add("ProductID", typeof(int));
dataTable.Columns.Add("ProductName", typeof(string));
dataTable.Columns.Add("Price", typeof(decimal));
dataTable.Rows.Add(1, "Widget", 29.99m);
dataTable.Rows.Add(2, "Gadget", 49.99m);
dataTable.Rows.Add(3, "Gizmo", 19.99m);

// オレDB connection string -- file must already exist on disk
string filename = @"C:\Output\Products.xlsx";
string connectionString =
    $"Provider=Microsoft.ACE.OLEDB.12.0;Data Source={filename};" +
    "Extended Properties='Excel 12.0 Xml;HDR=YES'";

using オレDBConnection connection = new(connectionString);
connection.Open();

// Create the sheet structure with SQL DDL
string create = "CREATE TABLE [Sheet1$] (ProductID INT, ProductName CHAR(255), Price DOUBLE)";
using (var createCmd = new オレDBCommand(create, connection))
    createCmd.ExecuteなしnQuery();

// Insert rows one at a time
string insert = "INSERT INTO [Sheet1$] (ProductID, ProductName, Price) VALUES (?, ?, ?)";
using オレDBCommand insertCmd = new(insert, connection);
insertCmd.Parameters.Add(new オレDBParameter("ProductID", オレDBType.Integer));
insertCmd.Parameters.Add(new オレDBParameter("ProductName", オレDBType.VarChar, 255));
insertCmd.Parameters.Add(new オレDBParameter("Price", オレDBType.Double));

foreach (DataRow row in dataTable.Rows)
{
    insertCmd.Parameters[0].Value = row["ProductID"];
    insertCmd.Parameters[1].Value = row["ProductName"];
    insertCmd.Parameters[2].Value = row["Price"];
    insertCmd.ExecuteなしnQuery();
}

using System.Data;
using System.Data.オレDB;

// Build a sample DataTable
DataTable dataTable = new DataTable("Products");
dataTable.Columns.Add("ProductID", typeof(int));
dataTable.Columns.Add("ProductName", typeof(string));
dataTable.Columns.Add("Price", typeof(decimal));
dataTable.Rows.Add(1, "Widget", 29.99m);
dataTable.Rows.Add(2, "Gadget", 49.99m);
dataTable.Rows.Add(3, "Gizmo", 19.99m);

// オレDB connection string -- file must already exist on disk
string filename = @"C:\Output\Products.xlsx";
string connectionString =
    $"Provider=Microsoft.ACE.OLEDB.12.0;Data Source={filename};" +
    "Extended Properties='Excel 12.0 Xml;HDR=YES'";

using オレDBConnection connection = new(connectionString);
connection.Open();

// Create the sheet structure with SQL DDL
string create = "CREATE TABLE [Sheet1$] (ProductID INT, ProductName CHAR(255), Price DOUBLE)";
using (var createCmd = new オレDBCommand(create, connection))
    createCmd.ExecuteなしnQuery();

// Insert rows one at a time
string insert = "INSERT INTO [Sheet1$] (ProductID, ProductName, Price) VALUES (?, ?, ?)";
using オレDBCommand insertCmd = new(insert, connection);
insertCmd.Parameters.Add(new オレDBParameter("ProductID", オレDBType.Integer));
insertCmd.Parameters.Add(new オレDBParameter("ProductName", オレDBType.VarChar, 255));
insertCmd.Parameters.Add(new オレDBParameter("Price", オレDBType.Double));

foreach (DataRow row in dataTable.Rows)
{
    insertCmd.Parameters[0].Value = row["ProductID"];
    insertCmd.Parameters[1].Value = row["ProductName"];
    insertCmd.Parameters[2].Value = row["Price"];
    insertCmd.ExecuteなしnQuery();
}

このコードは、各DataRowを個別のデータベースラウンドトリップとして挿入します。大規模なデータセットの場合、オレDBにはバッチ挿入メカニズムがないため、このループがボトルネックになります。 すべての行は、次の行に移動する前に、完全な SQL 解析、パラメータ バインド、および書き込みサイクルをトリガーします。

Excel エクスポートにおける オレDB の主な制限は何ですか?

オレDB が不十分な理由を理解することで、チームに移行の正当性を示し、適切な代替品を選択するのに役立ちます。

IronXLを使用して DataTable を Excel にエクスポートするにはどうすればよいですか?

IronXL は、オレDB パイプライン全体を直接オブジェクト モデルに置き換えます。 接続文字列、SQL コマンド、ドライバー要件はありません。 各セルに対して、WorkBook を作成し、WorkSheet を追加して、SetCellValue() を呼び出します。

using IronXL;
using System.Data;

// Build the same DataTable
DataTable dataTable = new DataTable("Products");
dataTable.Columns.Add("ProductID", typeof(int));
dataTable.Columns.Add("ProductName", typeof(string));
dataTable.Columns.Add("Price", typeof(decimal));
dataTable.Rows.Add(1, "Widget", 29.99m);
dataTable.Rows.Add(2, "Gadget", 49.99m);
dataTable.Rows.Add(3, "Gizmo", 19.99m);

// Create a new workbook and worksheet -- no template file needed
WorkBook workbook = WorkBook.Create(ExcelFileFormat.XLSX);
WorkSheet worksheet = workbook.CreateWorkSheet("Products");

// Write column headers into the first row
for (int col = 0; col < dataTable.Columns.Count; col++)
{
    worksheet.SetCellValue(0, col, dataTable.Columns[col].ColumnName);
}

// Write data rows
for (int row = 0; row < dataTable.Rows.Count; row++)
{
    for (int col = 0; col < dataTable.Columns.Count; col++)
    {
        worksheet.SetCellValue(row + 1, col, dataTable.Rows[row][col].ToString());
    }
}

workbook.SaveAs("Products.xlsx");

using IronXL;
using System.Data;

// Build the same DataTable
DataTable dataTable = new DataTable("Products");
dataTable.Columns.Add("ProductID", typeof(int));
dataTable.Columns.Add("ProductName", typeof(string));
dataTable.Columns.Add("Price", typeof(decimal));
dataTable.Rows.Add(1, "Widget", 29.99m);
dataTable.Rows.Add(2, "Gadget", 49.99m);
dataTable.Rows.Add(3, "Gizmo", 19.99m);

// Create a new workbook and worksheet -- no template file needed
WorkBook workbook = WorkBook.Create(ExcelFileFormat.XLSX);
WorkSheet worksheet = workbook.CreateWorkSheet("Products");

// Write column headers into the first row
for (int col = 0; col < dataTable.Columns.Count; col++)
{
    worksheet.SetCellValue(0, col, dataTable.Columns[col].ColumnName);
}

// Write data rows
for (int row = 0; row < dataTable.Rows.Count; row++)
{
    for (int col = 0; col < dataTable.Columns.Count; col++)
    {
        worksheet.SetCellValue(row + 1, col, dataTable.Rows[row][col].ToString());
    }
}

workbook.SaveAs("Products.xlsx");

WorkBook.Create(ExcelFileFormat.XLSX) はメモリ内に新しいワークブックを構築します。事前にファイルが存在している必要はありません。 CreateWorkSheet("Products") 名前付きタブを追加します。 ネストされたループは、DataTable の行と列の数を正確に反映し、セルごとに 1 つの値を書き込みます。 SaveAs() ワークブックを完全に有効な XLSX ファイルとしてディスクにフラッシュします。

DataTable をエクスポートするときにセルの書式設定を追加するにはどうすればよいですか?

基本的なエクスポート後の最も一般的な要件の 1 つは、ヘッダー行をスタイル設定してデータ行と区別することです。 IronXL は、オレDB では対応できない完全なスタイル API を公開します。

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

DataTable dataTable = new DataTable("Products");
dataTable.Columns.Add("ProductID", typeof(int));
dataTable.Columns.Add("ProductName", typeof(string));
dataTable.Columns.Add("Price", typeof(decimal));
dataTable.Rows.Add(1, "Widget", 29.99m);
dataTable.Rows.Add(2, "Gadget", 49.99m);
dataTable.Rows.Add(3, "Gizmo", 19.99m);

WorkBook workbook = WorkBook.Create(ExcelFileFormat.XLSX);
WorkSheet worksheet = workbook.CreateWorkSheet("Products");

// Write and style the header row
for (int col = 0; col < dataTable.Columns.Count; col++)
{
    var headerCell = worksheet[$"{(char)('A' + col)}1"];
    headerCell.Value = dataTable.Columns[col].ColumnName;
    headerCell.Style.Font.Bold = true;
    headerCell.Style.BackgroundColor = "#4472C4";
    headerCell.Style.Font.FontColor = "#FFFFFF";
}

// Write data rows with price column formatted as currency
for (int row = 0; row < dataTable.Rows.Count; row++)
{
    for (int col = 0; col < dataTable.Columns.Count; col++)
    {
        var cell = worksheet[$"{(char)('A' + col)}{row + 2}"];
        cell.Value = dataTable.Rows[row][col].ToString();

        // Apply currency format to the Price column
        if (dataTable.Columns[col].ColumnName == "Price")
            cell.FormatString = "$#,##0.00";
    }
}

// Auto-size columns so content is not clipped
worksheet.AutoSizeColumn(0);
worksheet.AutoSizeColumn(1);
worksheet.AutoSizeColumn(2);

workbook.SaveAs("ProductsStyled.xlsx");

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

DataTable dataTable = new DataTable("Products");
dataTable.Columns.Add("ProductID", typeof(int));
dataTable.Columns.Add("ProductName", typeof(string));
dataTable.Columns.Add("Price", typeof(decimal));
dataTable.Rows.Add(1, "Widget", 29.99m);
dataTable.Rows.Add(2, "Gadget", 49.99m);
dataTable.Rows.Add(3, "Gizmo", 19.99m);

WorkBook workbook = WorkBook.Create(ExcelFileFormat.XLSX);
WorkSheet worksheet = workbook.CreateWorkSheet("Products");

// Write and style the header row
for (int col = 0; col < dataTable.Columns.Count; col++)
{
    var headerCell = worksheet[$"{(char)('A' + col)}1"];
    headerCell.Value = dataTable.Columns[col].ColumnName;
    headerCell.Style.Font.Bold = true;
    headerCell.Style.BackgroundColor = "#4472C4";
    headerCell.Style.Font.FontColor = "#FFFFFF";
}

// Write data rows with price column formatted as currency
for (int row = 0; row < dataTable.Rows.Count; row++)
{
    for (int col = 0; col < dataTable.Columns.Count; col++)
    {
        var cell = worksheet[$"{(char)('A' + col)}{row + 2}"];
        cell.Value = dataTable.Rows[row][col].ToString();

        // Apply currency format to the Price column
        if (dataTable.Columns[col].ColumnName == "Price")
            cell.FormatString = "$#,##0.00";
    }
}

// Auto-size columns so content is not clipped
worksheet.AutoSizeColumn(0);
worksheet.AutoSizeColumn(1);
worksheet.AutoSizeColumn(2);

workbook.SaveAs("ProductsStyled.xlsx");

これにより、青いヘッダー行、白いヘッダー テキスト、ドル記号と 2 つの小数点以下で表示された価格値を含むファイルが生成されます。 セルのフォント サイズ ガイドと境界線および配置のリファレンスでは、利用可能なスタイル オプションの完全なセットについて説明しています。

ASP.NETで DataTable を Excel にエクスポートするにはどうすればよいですか?

Web アプリケーションでは通常、ワークブックをディスクに保存するのではなく、ブラウザーに直接ストリーミングします。 IronXL はworkbook.ToByteArray() でこれをサポートしており、HTTP 応答に書き込むことができるバイナリ コンテンツを返します。

// In an ASP.NET controller action
WorkBook workbook = WorkBook.Create(ExcelFileFormat.XLSX);
WorkSheet worksheet = workbook.CreateWorkSheet("Report");

// Assume dataTable is populated from your data source
for (int col = 0; col < dataTable.Columns.Count; col++)
    worksheet.SetCellValue(0, col, dataTable.Columns[col].ColumnName);

for (int row = 0; row < dataTable.Rows.Count; row++)
    for (int col = 0; col < dataTable.Columns.Count; col++)
        worksheet.SetCellValue(row + 1, col, dataTable.Rows[row][col].ToString());

byte[] fileBytes = workbook.ToByteArray();
return File(fileBytes, "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet", "Report.xlsx");

// In an ASP.NET controller action
WorkBook workbook = WorkBook.Create(ExcelFileFormat.XLSX);
WorkSheet worksheet = workbook.CreateWorkSheet("Report");

// Assume dataTable is populated from your data source
for (int col = 0; col < dataTable.Columns.Count; col++)
    worksheet.SetCellValue(0, col, dataTable.Columns[col].ColumnName);

for (int row = 0; row < dataTable.Rows.Count; row++)
    for (int col = 0; col < dataTable.Columns.Count; col++)
        worksheet.SetCellValue(row + 1, col, dataTable.Rows[row][col].ToString());

byte[] fileBytes = workbook.ToByteArray();
return File(fileBytes, "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet", "Report.xlsx");

ASP.NET のDataTable を Excel にエクスポートするチュートリアルでは、 ASP.NETアプリケーションのコントローラーとビューの配線全体について説明します。 DataTable から Excel C# へのガイドでは、複数シートのエクスポートや DataSet のサポートなどの追加のシナリオについて説明します。

エクスポート中に列のデータ型をどのように処理しますか?

DataTable 列に数値または日付値が保持されている場合、それらを文字列として書き込むと、Excel ではセルがテキストとして扱われ、並べ替え、フィルター処理、および数式参照が無効になります。 IronXL は、 .ToString() を呼び出すのではなく、値を直接渡すときにネイティブ タイプを保持します。

WorkBook workbook = WorkBook.Create(ExcelFileFormat.XLSX);
WorkSheet worksheet = workbook.CreateWorkSheet("TypedData");

DataTable table = new DataTable();
table.Columns.Add("ID", typeof(int));
table.Columns.Add("Amount", typeof(decimal));
table.Columns.Add("Date", typeof(DateTime));
table.Rows.Add(1, 1500.75m, new DateTime(2025, 6, 15));
table.Rows.Add(2, 3200.00m, new DateTime(2025, 7, 4));

// Write headers
for (int col = 0; col < table.Columns.Count; col++)
    worksheet.SetCellValue(0, col, table.Columns[col].ColumnName);

// Write typed values -- no .ToString() conversion
for (int row = 0; row < table.Rows.Count; row++)
{
    worksheet.SetCellValue(row + 1, 0, (int)table.Rows[row]["ID"]);
    worksheet.SetCellValue(row + 1, 1, (double)(decimal)table.Rows[row]["Amount"]);
    worksheet[$"C{row + 2}"].Value = (DateTime)table.Rows[row]["Date"];
    worksheet[$"C{row + 2}"].FormatString = "yyyy-MM-dd";
}

workbook.SaveAs("TypedData.xlsx");

WorkBook workbook = WorkBook.Create(ExcelFileFormat.XLSX);
WorkSheet worksheet = workbook.CreateWorkSheet("TypedData");

DataTable table = new DataTable();
table.Columns.Add("ID", typeof(int));
table.Columns.Add("Amount", typeof(decimal));
table.Columns.Add("Date", typeof(DateTime));
table.Rows.Add(1, 1500.75m, new DateTime(2025, 6, 15));
table.Rows.Add(2, 3200.00m, new DateTime(2025, 7, 4));

// Write headers
for (int col = 0; col < table.Columns.Count; col++)
    worksheet.SetCellValue(0, col, table.Columns[col].ColumnName);

// Write typed values -- no .ToString() conversion
for (int row = 0; row < table.Rows.Count; row++)
{
    worksheet.SetCellValue(row + 1, 0, (int)table.Rows[row]["ID"]);
    worksheet.SetCellValue(row + 1, 1, (double)(decimal)table.Rows[row]["Amount"]);
    worksheet[$"C{row + 2}"].Value = (DateTime)table.Rows[row]["Date"];
    worksheet[$"C{row + 2}"].FormatString = "yyyy-MM-dd";
}

workbook.SaveAs("TypedData.xlsx");

Excel では、金額列を数値で並べ替え、日付ピッカーを使用して日付列をフィルターできるようになりました。 追加のデータ形式パターンについては、セル データ形式の設定ガイドを参照してください。 エクスポート後にデータを読み戻す必要がある場合は、 Excel から DataTable へのチュートリアルで逆の操作が説明されています。

IronXL のテストとライセンスはどのように行いますか?

IronXL は試用ライセンスを使用して開発に無料で使用できます。 最初のIronXL呼び出しの前にコードでキーを適用します。

IronXl.License.LicenseKey = "YOUR-LICENSE-KEY-HERE";

IronXl.License.LicenseKey = "YOUR-LICENSE-KEY-HERE";

ライセンス キー アプリケーション ガイドでは、構成ファイルや環境変数など、すべての配置オプションについて説明します。 クラウド デプロイメントの場合、 DockerおよびLinux の入門ページで、プラットフォーム固有のセットアップ手順が説明されています。

Microsoft は、オレDB シナリオのAccess データベース エンジンの既知の制限事項を文書化しており、 NuGet.org は完全なバージョン履歴とダウンロード統計を含むIronXLパッケージをホストしています。 公式のOpen XML SDK ドキュメントでは、 IronXL が実装する基礎となる XLSX 仕様について説明しています。

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

これで、オレDB ドライバー、SQL 構文、プラットフォームの制限なしで、DataTable を XLSX ファイルにエクスポートするための実用的なパターンができました。 コア ワークフロー (ループ内の SetCellValue()、そして SaveAs()) は、3 行のサンプルから数十万行のデータ セットにまで拡張できます。

まず、既存の オレDB エクスポートを上記の基本的なIronXLパターンに置き換え、データのエクスポートが検証されたら、スタイル API を使用してフォーマットを重ねていきます。 ライブラリがサポートする全範囲を理解するには、IronXLのスタートガイドと機能の概要を次に読むとよいでしょう。 同じパイプラインの一部として CSV ファイルを操作する場合は、 C# DataTable から CSV へのガイドで、同じ DataTable オブジェクトからコンマ区切りの出力を生成する方法が示されています。