IronXLを使用して C# で SQL データを Excel にエクスポートする

SQL Data ExportのためにIronXLをどのようにインストールしますか？

コードを書く前に、プロジェクトにIronXLを追加する必要があります。 最も早い方法は、Visual StudioのNuGetパッケージマネージャーコンソールを使用することです。

Install-Package IronXl.Excel

Install-Package IronXl.Excel

または、.NET CLIを使用します。

dotnet add package IronXl.Excel

dotnet add package IronXl.Excel

インストールが完了したら、ファイルの最初に必要な名前空間を追加します。.NET 10のトップレベルステートメントを使用すると、セットアップは次のようになります。

using IronXL;
using System.Data;
using System.Data.SqlClient;

using IronXL;
using System.Data;
using System.Data.SqlClient;

IronXLは.NET Standard 2.0以上を対象としているため、追加の設定なしで.NET 10、.NET Framework、ASP.NET Core、Blazorプロジェクトで動作します。 パッケージはNuGetで見つけることができます。

SQLサーバーのデータベースからデータをエクスポートする最良の方法は何ですか?

SQL ServerからExcelファイルにデータをエクスポートするための最も効率的なアプローチは、データベース接続を確立し、データをDataTableに取得し、IronXLを使用してExcelワークシートにデータを書き込むという3つのステップに分かれています。 Microsoft Interopソリューションとは異なり、IronXLは独立して動作し、COM interopのオーバーヘッドによるパフォーマンス低下なしに大きなデータセットを扱います。

コアパターンは簡単です。 SqlDataAdapterはMicrosoftのADO.NETデータアクセスフレームワークの一部であり、.NET 1.0以来リレーショナルデータベースからDataTableオブジェクトを埋めるための標準的な方法です：

1. 接続文字列を使用してSqlConnectionを開く
2. DataSetを埋める
3. IronXLのメソッドを呼び出してワークブックを作成し、ワークシートのセルを埋める
4. ワークブックを.xlsとして保存する

このアプローチはSQL Server 2012以降、およびAzure SQL Database、Amazon RDS for SQL Server、任意のADO.NET互換データソースと互換性があります。 このパターンはコンソールアプリケーションでもWebベースのレポートツールでも同様です。

どのように SQL Server に接続し、データを取得しますか?

SQLデータをエクスポートする前に、接続を確立してSQLクエリを実行し、DataTableを埋める必要があります。 接続文字列には、データへのアクセスに必要なSQL Serverデータベースの認証情報とサーバー情報が含まれています。

次の例では、なしrthwindのCustomersテーブルをクエリし、各行をIronXLのセル書き込みAPIを使用してExcelワークシートに書き込みます：

using IronXL;
using System.Data;
using System.Data.SqlClient;

string connectionString = "Data Source=localhost;Initial Catalog=なしrthwind;Integrated Security=True";
string sql = "SELECT * FROM Customers";

using SqlConnection connection = new SqlConnection(connectionString);
connection.Open();

SqlDataAdapter adapter = new SqlDataAdapter(sql, connection);
DataTable dt = new DataTable();
adapter.Fill(dt);

WorkBook workBook = WorkBook.Create(ExcelFileFormat.XLSX);
WorkSheet workSheet = workBook.CreateWorkSheet("Customers");

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

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

workBook.SaveAs("CustomerExport.xlsx");

using IronXL;
using System.Data;
using System.Data.SqlClient;

string connectionString = "Data Source=localhost;Initial Catalog=なしrthwind;Integrated Security=True";
string sql = "SELECT * FROM Customers";

using SqlConnection connection = new SqlConnection(connectionString);
connection.Open();

SqlDataAdapter adapter = new SqlDataAdapter(sql, connection);
DataTable dt = new DataTable();
adapter.Fill(dt);

WorkBook workBook = WorkBook.Create(ExcelFileFormat.XLSX);
WorkSheet workSheet = workBook.CreateWorkSheet("Customers");

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

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

workBook.SaveAs("CustomerExport.xlsx");

LoadWorkSheetsFromDataSetを使って複数のテーブルをエクスポートする方法は？

レポートが複数のSQLテーブルからデータを必要とする場合、例えばProductsとCategories、DataSetにロードし、IronXLが自動的にテーブルごとに1つのワークシートを作成します。 これはDataSetまたはDataTableをExcelにエクスポートするための最も簡潔なアプローチです。

using IronXL;
using System.Data;
using System.Data.SqlClient;

string connectionString = "Data Source=.;Initial Catalog=Inventory;Integrated Security=True";

using SqlConnection connection = new SqlConnection(connectionString);
connection.Open();

SqlDataAdapter productsAdapter = new SqlDataAdapter("SELECT * FROM Products", connection);
SqlDataAdapter categoriesAdapter = new SqlDataAdapter("SELECT * FROM Categories", connection);

DataSet dataSet = new DataSet();
productsAdapter.Fill(dataSet, "Products");
categoriesAdapter.Fill(dataSet, "Categories");

WorkBook workBook = WorkBook.Create(ExcelFileFormat.XLSX);
WorkBook.LoadWorkSheetsFromDataSet(dataSet, workBook);

workBook.SaveAs("InventoryReport.xlsx");

using IronXL;
using System.Data;
using System.Data.SqlClient;

string connectionString = "Data Source=.;Initial Catalog=Inventory;Integrated Security=True";

using SqlConnection connection = new SqlConnection(connectionString);
connection.Open();

SqlDataAdapter productsAdapter = new SqlDataAdapter("SELECT * FROM Products", connection);
SqlDataAdapter categoriesAdapter = new SqlDataAdapter("SELECT * FROM Categories", connection);

DataSet dataSet = new DataSet();
productsAdapter.Fill(dataSet, "Products");
categoriesAdapter.Fill(dataSet, "Categories");

WorkBook workBook = WorkBook.Create(ExcelFileFormat.XLSX);
WorkBook.LoadWorkSheetsFromDataSet(dataSet, workBook);

workBook.SaveAs("InventoryReport.xlsx");

どのようにASP.NETエクスポートボタンを使用してデータをエクスポートできますか?

webアプリケーションの場合、通常、ユーザーのボタンクリックによってエクスポートをトリガーします。 次のASP.NET Web Formsの例では、ボタンクリックイベントを処理し、SQLクエリからExcelワークブックを構築し、Response.AddHeaderを使用してファイルをブラウザにダウンロードとしてプッシュする方法を示しています：

using IronXL;
using System;
using System.Data;
using System.Data.SqlClient;
using System.IO;
using System.Web.UI;

public partial class ExportPage : Page
{
    private void ExportButton_Click(object sender, EventArgs e)
    {
        string connectionString = "Data Source=localhost;Initial Catalog=Sales;Integrated Security=True";

        using SqlConnection connection = new SqlConnection(connectionString);
        SqlDataAdapter adapter = new SqlDataAdapter("SELECT * FROM Orders", connection);
        DataSet dataSet = new DataSet();
        adapter.Fill(dataSet);

        WorkBook workBook = WorkBook.Create(ExcelFileFormat.XLSX);
        WorkBook.LoadWorkSheetsFromDataSet(dataSet, workBook);

        byte[] fileBytes = workBook.ToByteArray();
        string filename = "OrdersExport.xlsx";

        Response.Clear();
        Response.ContentType = "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet";
        Response.AddHeader("content-disposition", "attachment;filename=" + filename);
        Response.BinaryWrite(fileBytes);
        Response.End();
    }
}

using IronXL;
using System;
using System.Data;
using System.Data.SqlClient;
using System.IO;
using System.Web.UI;

public partial class ExportPage : Page
{
    private void ExportButton_Click(object sender, EventArgs e)
    {
        string connectionString = "Data Source=localhost;Initial Catalog=Sales;Integrated Security=True";

        using SqlConnection connection = new SqlConnection(connectionString);
        SqlDataAdapter adapter = new SqlDataAdapter("SELECT * FROM Orders", connection);
        DataSet dataSet = new DataSet();
        adapter.Fill(dataSet);

        WorkBook workBook = WorkBook.Create(ExcelFileFormat.XLSX);
        WorkBook.LoadWorkSheetsFromDataSet(dataSet, workBook);

        byte[] fileBytes = workBook.ToByteArray();
        string filename = "OrdersExport.xlsx";

        Response.Clear();
        Response.ContentType = "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet";
        Response.AddHeader("content-disposition", "attachment;filename=" + filename);
        Response.BinaryWrite(fileBytes);
        Response.End();
    }
}

エクスポートされたExcelファイルにフォーマットと列ヘッダーを追加する方法は？

生のSQLエクスポートは、エンドユーザーと共有する前にプレゼンテーションの改善が必要なことがよくあります。 IronXLを使用すると、ワークシートにデータが書き込まれた後で、セルのスタイル、列幅、数字形式を制御できます。 次の例は、ヘッダー行を太字にし、列幅を自動調整する方法を示しています：

using IronXL;
using System.Data;
using System.Data.SqlClient;

string connectionString = "Data Source=localhost;Initial Catalog=Sales;Integrated Security=True";

using SqlConnection connection = new SqlConnection(connectionString);
connection.Open();

SqlDataAdapter adapter = new SqlDataAdapter("SELECT OrderID, CustomerID, OrderDate, Total FROM Orders", connection);
DataTable dt = new DataTable();
adapter.Fill(dt);

WorkBook workBook = WorkBook.Create(ExcelFileFormat.XLSX);
WorkSheet workSheet = workBook.CreateWorkSheet("Orders");

// Write and style header row
for (int col = 0; col < dt.Columns.Count; col++)
{
    workSheet.SetCellValue(0, col, dt.Columns[col].ColumnName);
    workSheet[0, col].Style.Font.Bold = true;
    workSheet[0, col].Style.Font.Height = 12;
}

// Write data rows with type-aware value assignment
for (int row = 0; row < dt.Rows.Count; row++)
{
    for (int col = 0; col < dt.Columns.Count; col++)
    {
        object value = dt.Rows[row][col];
        if (value is DateTime date)
            workSheet.SetCellValue(row + 1, col, date.ToString("yyyy-MM-dd"));
        else if (value is decimal || value is double || value is int)
            workSheet.SetCellValue(row + 1, col, Convert.ToDouble(value));
        else
            workSheet.SetCellValue(row + 1, col, value.ToString());
    }
}

workBook.SaveAs("FormattedOrdersExport.xlsx");

using IronXL;
using System.Data;
using System.Data.SqlClient;

string connectionString = "Data Source=localhost;Initial Catalog=Sales;Integrated Security=True";

using SqlConnection connection = new SqlConnection(connectionString);
connection.Open();

SqlDataAdapter adapter = new SqlDataAdapter("SELECT OrderID, CustomerID, OrderDate, Total FROM Orders", connection);
DataTable dt = new DataTable();
adapter.Fill(dt);

WorkBook workBook = WorkBook.Create(ExcelFileFormat.XLSX);
WorkSheet workSheet = workBook.CreateWorkSheet("Orders");

// Write and style header row
for (int col = 0; col < dt.Columns.Count; col++)
{
    workSheet.SetCellValue(0, col, dt.Columns[col].ColumnName);
    workSheet[0, col].Style.Font.Bold = true;
    workSheet[0, col].Style.Font.Height = 12;
}

// Write data rows with type-aware value assignment
for (int row = 0; row < dt.Rows.Count; row++)
{
    for (int col = 0; col < dt.Columns.Count; col++)
    {
        object value = dt.Rows[row][col];
        if (value is DateTime date)
            workSheet.SetCellValue(row + 1, col, date.ToString("yyyy-MM-dd"));
        else if (value is decimal || value is double || value is int)
            workSheet.SetCellValue(row + 1, col, Convert.ToDouble(value));
        else
            workSheet.SetCellValue(row + 1, col, value.ToString());
    }
}

workBook.SaveAs("FormattedOrdersExport.xlsx");

太字のテキストと大きなフォントを使用してヘッダー行をスタイリングすると、エクスポートされたレポートをExcelで読みやすくなります。 合計やカウントなどの数字列には、文字列ではなくdouble値を渡すことで、エクスポートされたデータでExcelのネイティブソートおよび集計関数が正しく動作します。

IronXLのセルフォーマットドキュメントでは、セルの罫線、背景色、数字フォーマットマスクを含むフォーマットオプションの全範囲を探ることができます。

大規模なSQLデータセットを効率的に処理する方法は？

何万もの行を持つテーブルでは、メモリ管理が重要になります。 Excelに書き込む前にSqlDataReaderを使用できます。

高ボリュームのエクスポートで作業する際は、以下の戦略を検討してください：

• SQL OFFSET/FETCHでページネーションする: 大規模なエクスポートを複数のワークシートに分割し、それぞれが結果のページを含む。 これによりExcelで個々のシートサイズを管理可能に保ちます。
• ディスクにストリーミングする: すべてをworkBook.SaveAs(filePath)を呼び出します。
• 選択した列を制限する: SQLサーバからの転送データ量を減らすため、SELECTステートメントで明示的な列リストを使用します。

DataTableをExcelに最速でエクスポートする方法のガイダンスについては、IronXLのブログに異なるアプローチとそのメモリプロファイルを比較した専用のベンチマーク記事があります。

DataSetオブジェクトに特に効率的で、内部で行のイテレーションを処理します。 DataTableからExcelへのエクスポートシナリオでは、特にこのメソッドは大量書き込み用に最適化され、ボイラープレートコードを削減します。

ExcelからデータをSQL Serverにインポートする方法は？

多くのレポートアプリケーションにとって、エクスポートワークフローは物語の半分に過ぎません。 ユーザーがテンプレートをダウンロードし、データを入力してSQL Serverに再アップロードできるようにする必要があるかもしれません。 IronXLはこの双方向のワークフローをシンプルにします。

Excelデータをデータベースにインポートするには、アップロード済みのファイルをSqlCommandを使用して各行を挿入します。

using IronXL;
using System.Data.SqlClient;

WorkBook workBook = WorkBook.Load("UploadedData.xlsx");
WorkSheet sheet = workBook.DefaultWorkSheet;

string connectionString = "Data Source=localhost;Initial Catalog=Inventory;Integrated Security=True";

using SqlConnection connection = new SqlConnection(connectionString);
connection.Open();

// Skip header row, start at row index 1
for (int row = 1; row <= sheet.RowCount; row++)
{
    string productName = sheet[row, 0].StringValue;
    int quantity = (int)sheet[row, 1].DoubleValue;
    decimal price = (decimal)sheet[row, 2].DoubleValue;

    using SqlCommand cmd = new SqlCommand(
        "INSERT INTO Products (Name, Quantity, Price) VALUES (@name, @qty, @price)",
        connection);
    cmd.Parameters.AddWithValue("@name", productName);
    cmd.Parameters.AddWithValue("@qty", quantity);
    cmd.Parameters.AddWithValue("@price", price);
    cmd.ExecuteなしnQuery();
}

using IronXL;
using System.Data.SqlClient;

WorkBook workBook = WorkBook.Load("UploadedData.xlsx");
WorkSheet sheet = workBook.DefaultWorkSheet;

string connectionString = "Data Source=localhost;Initial Catalog=Inventory;Integrated Security=True";

using SqlConnection connection = new SqlConnection(connectionString);
connection.Open();

// Skip header row, start at row index 1
for (int row = 1; row <= sheet.RowCount; row++)
{
    string productName = sheet[row, 0].StringValue;
    int quantity = (int)sheet[row, 1].DoubleValue;
    decimal price = (decimal)sheet[row, 2].DoubleValue;

    using SqlCommand cmd = new SqlCommand(
        "INSERT INTO Products (Name, Quantity, Price) VALUES (@name, @qty, @price)",
        connection);
    cmd.Parameters.AddWithValue("@name", productName);
    cmd.Parameters.AddWithValue("@qty", quantity);
    cmd.Parameters.AddWithValue("@price", price);
    cmd.ExecuteなしnQuery();
}

パラメータ化されたクエリは、ユーザー提供のExcelデータを読み取る際にSQLインジェクションから保護します。 Microsoft LearnのSqlCommandドキュメントには利用可能なすべてのオーバーロードとパラメータバインディングパターンが含まれています。 挿入する前にセルの値を常に検証し、空の文字列、範囲外の数値、およびSQL Serverテーブルで制約違反を引き起こす可能性のある予期しないデータ型をチェックします。

逆方向では、IronXLはデータソースが.xlsxファイルの代わりにカンマ区切りの出力を生成するシナリオに対してC#でCSVファイルを読み取ることもサポートしています。

IronXLを他のエクスポートアプローチとどのように比較しますか？

.NETでSQLデータをExcelにエクスポートするためのいくつかのアプローチがあります。 以下の表は、主なトレードオフをまとめたものです。

Microsoft Interopは、サーバーにOfficeがインストールされていることを要求し、サーバー側のWebアプリケーションではサポートされていません。 IronXL、EPPlus、およびNPOIはすべてOfficeなしで動作します。IronXLの利点は、LoadWorkSheetsFromDataSetを通じて一流のレベルで提供し、他のライブラリの手動行イテレーションと比べてエクスポートコードを数行に削減します。

詳細な直面比較については、Microsoft Office Interop alternativesの記事を参照してください。

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

C#を使用してSQLデータをExcelにエクスポートするのは、IronXLを使えば簡単です。 ライブラリは、複雑なInterop依存関係を排除しながら、DataSet、直接データベース統合に対して強力なサポートを提供します。 コンソールアプリケーションやファイルダウンロード機能を備えたWebベースのレポートシステムを構築する際、IronXLはすべて for .NET 10プロジェクトタイプで信頼性の高いExcelファイル生成を提供します。

この基盤をさらに構築するために、以下の関連リソースを探索してください：

• C#でExcelファイルを作成する -- ワークブック作成とフォーマットの完全なチュートリアル
• DataSetとDataTableをExcelにエクスポートする -- LoadWorkSheetsFromDataSetメソッドの公式ハウツーガイド
• ExcelからSQLへのデータインポート -- 完全な往復ワークフロー
• DataTable to Excel Export -- 単一テーブルシナリオに焦点を当てたガイド
• ASP.NETでDataTableをExcelにエクスポートする -- Webアプリケーションエクスポートパターン
• Fastest Way to Export DataTable to Excel -- パフォーマンスベンチマーク

本番展開用のライセンスを購入するか、または無料のトライアルを続け、.NETプロジェクトでこのExcelライブラリの完全な機能をテストしてください。