IronXLを使用してC#でデータセットをExcelにエクスポート | Officeは不要

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

エクスポート コードを記述する前に、 NuGetパッケージ マネージャーを使用してIronXL をプロジェクトに追加します。 プロジェクト ルートでターミナルを開き、 .NET CLI コマンドを実行するか、Visual Studio のパッケージ マネージャー コンソールで Install-Package コマンドを使用します。

dotnet add package IronXl.Excel
# Or in Visual Studio Package Manager Console:
# Install-Package IronXl.Excel

dotnet add package IronXl.Excel
# Or in Visual Studio Package Manager Console:
# Install-Package IronXl.Excel

インストール後、トップレベルの using ステートメントを追加してIronXL名前空間をインポートします。

using IronXL;
using System.Data;

using IronXL;
using System.Data;

IronXL は、.NET 8、 .NET 9、 .NET 10 に加え、古い.NET Frameworkバージョン (4.6.2+) もターゲットとしています。 サーバー、デスクトップ、クラウドなど、どのマシンにも Office をインストールする必要はありません。 パッケージをインストールすると、XLSX、XLS、CSV ファイルを完全にマネージ コードで作成、読み取り、書き込みできるようになります。

詳細なインストール オプションについては、 IronXLインストール ガイドとバージョン履歴のNuGetパッケージ ページを参照してください。

単一の DataTable を Excel ファイルにエクスポートするにはどうすればよいですか?

最も一般的なシナリオは、1 つの DataTable を 1 つのワークシートにエクスポートすることです。 IronXL の WorkBook および WorkSheet クラスは、Excel オブジェクト モデルに自然にマップされます。 ワークブックを作成し、ワークシートを追加して、DataTable の列と行を反復処理します。

次の例では、メモリ内に Employees DataTable を作成し、それを EmployeeData.xlsx に書き込みます。

using IronXL;
using System.Data;

// Build an in-memory DataTable
DataTable dt = new DataTable("Employees");
dt.Columns.Add("ID", typeof(int));
dt.Columns.Add("Name", typeof(string));
dt.Columns.Add("Department", typeof(string));

dt.Rows.Add(1, "John Smith", "Engineering");
dt.Rows.Add(2, "Sarah Jones", "Marketing");
dt.Rows.Add(3, "Mike Wilson", "Sales");

// Create a workbook and a named worksheet
WorkBook workbook = WorkBook.Create(ExcelFileFormat.XLSX);
WorkSheet worksheet = workbook.CreateWorkSheet("Employees");

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

// Write data rows starting at row 1
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("EmployeeData.xlsx");

using IronXL;
using System.Data;

// Build an in-memory DataTable
DataTable dt = new DataTable("Employees");
dt.Columns.Add("ID", typeof(int));
dt.Columns.Add("Name", typeof(string));
dt.Columns.Add("Department", typeof(string));

dt.Rows.Add(1, "John Smith", "Engineering");
dt.Rows.Add(2, "Sarah Jones", "Marketing");
dt.Rows.Add(3, "Mike Wilson", "Sales");

// Create a workbook and a named worksheet
WorkBook workbook = WorkBook.Create(ExcelFileFormat.XLSX);
WorkSheet worksheet = workbook.CreateWorkSheet("Employees");

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

// Write data rows starting at row 1
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("EmployeeData.xlsx");

DataSet を複数の Excel ワークシートにエクスポートするにはどうすればよいですか?

DataSet に複数の関連テーブル (製品や注文など) が含まれている場合は、各 DataTable を 1 つのブック内の独自のワークシートにマップできます。 これにより、受信者は複数のドキュメントを開かなくても、関連するすべてのデータを 1 つのファイルで確認できます。

以下のループは ds.Tables を反復し、テーブルごとに 1 つのシートを作成します。

using IronXL;
using System.Data;

// Build a DataSet with two related tables
DataSet ds = new DataSet("CompanyData");

DataTable dtProducts = new DataTable("Products");
dtProducts.Columns.Add("ProductID", typeof(int));
dtProducts.Columns.Add("ProductName", typeof(string));
dtProducts.Columns.Add("Price", typeof(decimal));
dtProducts.Rows.Add(101, "Widget A", 29.99m);
dtProducts.Rows.Add(102, "Widget B", 49.99m);
ds.Tables.Add(dtProducts);

DataTable dtOrders = new DataTable("Orders");
dtOrders.Columns.Add("OrderID", typeof(int));
dtOrders.Columns.Add("Customer", typeof(string));
dtOrders.Columns.Add("Total", typeof(decimal));
dtOrders.Rows.Add(1001, "Acme Corp", 599.90m);
dtOrders.Rows.Add(1002, "Tech Inc", 299.95m);
ds.Tables.Add(dtOrders);

// Create one workbook and iterate each DataTable
WorkBook workbook = WorkBook.Create(ExcelFileFormat.XLSX);

foreach (DataTable table in ds.Tables)
{
    WorkSheet sheet = workbook.CreateWorkSheet(table.TableName);

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

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

workbook.SaveAs("CompanyReport.xlsx");

using IronXL;
using System.Data;

// Build a DataSet with two related tables
DataSet ds = new DataSet("CompanyData");

DataTable dtProducts = new DataTable("Products");
dtProducts.Columns.Add("ProductID", typeof(int));
dtProducts.Columns.Add("ProductName", typeof(string));
dtProducts.Columns.Add("Price", typeof(decimal));
dtProducts.Rows.Add(101, "Widget A", 29.99m);
dtProducts.Rows.Add(102, "Widget B", 49.99m);
ds.Tables.Add(dtProducts);

DataTable dtOrders = new DataTable("Orders");
dtOrders.Columns.Add("OrderID", typeof(int));
dtOrders.Columns.Add("Customer", typeof(string));
dtOrders.Columns.Add("Total", typeof(decimal));
dtOrders.Rows.Add(1001, "Acme Corp", 599.90m);
dtOrders.Rows.Add(1002, "Tech Inc", 299.95m);
ds.Tables.Add(dtOrders);

// Create one workbook and iterate each DataTable
WorkBook workbook = WorkBook.Create(ExcelFileFormat.XLSX);

foreach (DataTable table in ds.Tables)
{
    WorkSheet sheet = workbook.CreateWorkSheet(table.TableName);

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

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

workbook.SaveAs("CompanyReport.xlsx");

Excel エクスポートにヘッダー書式を追加するにはどうすればよいですか?

プレーンなデータのエクスポートは機能しますが、太字のヘッダーと列幅を追加すると、出力をビジネス コンテキストですぐに使用できるようになります。 IronXL は、任意の WorkSheet 範囲に添付された Style オブジェクトを通じて、セルと範囲のスタイルを公開します。

以下のスニペットは、ヘッダー行に太字のフォント書式を適用し、データの書き込み後に列のサイズを自動変更します。

using IronXL;
using System.Data;

DataTable dt = new DataTable("Sales");
dt.Columns.Add("Region", typeof(string));
dt.Columns.Add("Q1", typeof(decimal));
dt.Columns.Add("Q2", typeof(decimal));
dt.Columns.Add("Q3", typeof(decimal));
dt.Columns.Add("Q4", typeof(decimal));

dt.Rows.Add("なしrth", 120000m, 135000m, 142000m, 158000m);
dt.Rows.Add("South", 98000m, 104000m, 112000m, 121000m);
dt.Rows.Add("East",  87000m, 93000m,  99000m,  108000m);
dt.Rows.Add("West",  145000m, 152000m, 161000m, 174000m);

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

// Write and style headers
for (int col = 0; col < dt.Columns.Count; col++)
{
    sheet.SetCellValue(0, col, dt.Columns[col].ColumnName);
    sheet["A1:E1"].Style.Font.Bold = true;
    sheet["A1:E1"].Style.Font.Height = 12;
}

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

workbook.SaveAs("SalesReport.xlsx");

using IronXL;
using System.Data;

DataTable dt = new DataTable("Sales");
dt.Columns.Add("Region", typeof(string));
dt.Columns.Add("Q1", typeof(decimal));
dt.Columns.Add("Q2", typeof(decimal));
dt.Columns.Add("Q3", typeof(decimal));
dt.Columns.Add("Q4", typeof(decimal));

dt.Rows.Add("なしrth", 120000m, 135000m, 142000m, 158000m);
dt.Rows.Add("South", 98000m, 104000m, 112000m, 121000m);
dt.Rows.Add("East",  87000m, 93000m,  99000m,  108000m);
dt.Rows.Add("West",  145000m, 152000m, 161000m, 174000m);

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

// Write and style headers
for (int col = 0; col < dt.Columns.Count; col++)
{
    sheet.SetCellValue(0, col, dt.Columns[col].ColumnName);
    sheet["A1:E1"].Style.Font.Bold = true;
    sheet["A1:E1"].Style.Font.Height = 12;
}

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

workbook.SaveAs("SalesReport.xlsx");

Style.Font.Bold プロパティは、単一のステートメント内のヘッダー範囲全体に適用されます。 IronXL は、背景色 (Style.BackgroundColor)、境界線のスタイル (Style.Border)、数値形式 (Style.NumberFormat.FormatCode)、水平方向の配置 (Style.HorizontalAlignment) もサポートしています。 完全なスタイル設定のリファレンスについては、 IronXLセル書式設定ガイドを参照してください。

データベースクエリの結果を Excel にエクスポートするにはどうすればよいですか?

SQL データベースに接続し、結果を直接 Excel にエクスポートすると、スケジュールされたレポート、データ スナップショット、管理エクスポートなど、実際の主要な使用例がカバーされます。 このアプローチでは、SqlDataAdapter を使用して DataSet を入力し、結果の DataTable をIronXLワークシートにマップします。

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

string connectionString = "Server=localhost;Database=SalesDB;Integrated Security=True;";
string query = "SELECT CustomerID, CompanyName, ContactName, Country FROM Customers";

// Fill DataSet from SQL query
DataSet ds = new DataSet();
using (SqlConnection connection = new SqlConnection(connectionString))
{
    SqlDataAdapter adapter = new SqlDataAdapter(query, connection);
    adapter.Fill(ds, "Customers");
}

DataTable dt = ds.Tables["Customers"]!;

// Create workbook and export
WorkBook workbook = WorkBook.Create(ExcelFileFormat.XLSX);
WorkSheet worksheet = workbook.CreateWorkSheet("CustomerData");

// Bold header row
for (int col = 0; col < dt.Columns.Count; col++)
{
    worksheet.SetCellValue(0, col, dt.Columns[col].ColumnName);
}
worksheet["A1:D1"].Style.Font.Bold = true;

// Write rows, handling DBNull values safely
for (int row = 0; row < dt.Rows.Count; row++)
{
    for (int col = 0; col < dt.Columns.Count; col++)
    {
        object cellValue = dt.Rows[row][col];
        worksheet.SetCellValue(row + 1, col,
            cellValue == DBNull.Value ? "" : cellValue.ToString()!);
    }
}

workbook.SaveAs("CustomerExport.xlsx");
Console.WriteLine("Export complete.");

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

string connectionString = "Server=localhost;Database=SalesDB;Integrated Security=True;";
string query = "SELECT CustomerID, CompanyName, ContactName, Country FROM Customers";

// Fill DataSet from SQL query
DataSet ds = new DataSet();
using (SqlConnection connection = new SqlConnection(connectionString))
{
    SqlDataAdapter adapter = new SqlDataAdapter(query, connection);
    adapter.Fill(ds, "Customers");
}

DataTable dt = ds.Tables["Customers"]!;

// Create workbook and export
WorkBook workbook = WorkBook.Create(ExcelFileFormat.XLSX);
WorkSheet worksheet = workbook.CreateWorkSheet("CustomerData");

// Bold header row
for (int col = 0; col < dt.Columns.Count; col++)
{
    worksheet.SetCellValue(0, col, dt.Columns[col].ColumnName);
}
worksheet["A1:D1"].Style.Font.Bold = true;

// Write rows, handling DBNull values safely
for (int row = 0; row < dt.Rows.Count; row++)
{
    for (int col = 0; col < dt.Columns.Count; col++)
    {
        object cellValue = dt.Rows[row][col];
        worksheet.SetCellValue(row + 1, col,
            cellValue == DBNull.Value ? "" : cellValue.ToString()!);
    }
}

workbook.SaveAs("CustomerExport.xlsx");
Console.WriteLine("Export complete.");

IronXL を他の Excel エクスポート方法と比較するとどうなりますか?

ライブラリを選択する前に、DataSet エクスポート シナリオにとって最も重要な領域で、主要なオプションが互いにどのように比較されるかを理解しておくと役立ちます。

Microsoft Office Interop は、Office がインストールされている Windows マシンでのみ動作するため、サーバー展開やクラウド機能には使用できません。 IronXL、EPPlus、ClosedXML はすべてサーバー側での生成をサポートしています。主な差別化要因は、スタイル API とライセンス モデルの幅広さです。 IronXL のライセンスには商用利用が含まれており、単一のパッケージですべて for .NETターゲット フレームワークがカバーされます。

サードパーティのベンチマークと比較については、 Excel ファイル形式に関する Microsoft のドキュメントとEPPlus プロジェクト ページに、プロジェクトに適切な選択を行うための追加のコンテキストが提供されています。

メモリの問題を起こさずに大規模なデータセットを処理するにはどうすればよいでしょうか?

数万行の DataTables をエクスポートする場合、メモリ使用量を予測可能に保つことが重要です。 以下のパターンでは、結果セット全体を最初にDataTableにロードするのではなく、IDataReaderからデータをストリーミングします。これにより、リーダーバッファとDataTableの両方を同時に保持することによるメモリコストの二重化を回避できます。

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

string connectionString = "Server=localhost;Database=InventoryDB;Integrated Security=True;";
string query = "SELECT ProductID, SKU, Description, StockLevel, UnitCost FROM Products";

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

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

using SqlCommand cmd = new SqlCommand(query, conn);
using SqlDataReader reader = cmd.ExecuteReader();

// Write schema-derived headers
for (int col = 0; col < reader.FieldCount; col++)
{
    sheet.SetCellValue(0, col, reader.GetName(col));
}

// Stream rows directly into IronXL without buffering a DataTable
int excelRow = 1;
while (reader.Read())
{
    for (int col = 0; col < reader.FieldCount; col++)
    {
        sheet.SetCellValue(excelRow, col,
            reader.IsDBNull(col) ? "" : reader.GetValue(col).ToString()!);
    }
    excelRow++;
}

workbook.SaveAs("InventoryExport.xlsx");
Console.WriteLine($"Exported {excelRow - 1} rows.");

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

string connectionString = "Server=localhost;Database=InventoryDB;Integrated Security=True;";
string query = "SELECT ProductID, SKU, Description, StockLevel, UnitCost FROM Products";

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

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

using SqlCommand cmd = new SqlCommand(query, conn);
using SqlDataReader reader = cmd.ExecuteReader();

// Write schema-derived headers
for (int col = 0; col < reader.FieldCount; col++)
{
    sheet.SetCellValue(0, col, reader.GetName(col));
}

// Stream rows directly into IronXL without buffering a DataTable
int excelRow = 1;
while (reader.Read())
{
    for (int col = 0; col < reader.FieldCount; col++)
    {
        sheet.SetCellValue(excelRow, col,
            reader.IsDBNull(col) ? "" : reader.GetValue(col).ToString()!);
    }
    excelRow++;
}

workbook.SaveAs("InventoryExport.xlsx");
Console.WriteLine($"Exported {excelRow - 1} rows.");

このパターンは、結果セットが50,000行を超える可能性がある場合、またはメモリ制約のあるサービス内で実行する場合に適しています。IronXL のパフォーマンスに関するドキュメントでは、大量エクスポートにおけるメモリとスループットのチューニングに関する追加オプションについて説明しています。

using IronXL;

// IronXL can save any workbook as CSV
workbook.SaveAs("LargeExport.csv");

using IronXL;

// IronXL can save any workbook as CSV
workbook.SaveAs("LargeExport.csv");

Excel ファイルをさまざまな形式や場所に保存するにはどうすればよいですか?

IronXL は、ファイル パスへの保存、MemoryStream、および byte[] をサポートしています。これらは、ダウンロード応答として Excel を返すASP.NETアプリケーションにとって重要です。

using IronXL;
using System.IO;

WorkBook workbook = WorkBook.Create(ExcelFileFormat.XLSX);
WorkSheet sheet = workbook.CreateWorkSheet("Report");
sheet.SetCellValue(0, 0, "Generated Report");

// Save to file path
workbook.SaveAs("Report.xlsx");

// Save as XLS (legacy format)
workbook.SaveAs("Report.xls");

// Save to MemoryStream for HTTP response
using MemoryStream ms = new MemoryStream();
workbook.SaveAs(ms);
byte[] fileBytes = ms.ToArray();
// fileBytes can be returned from an ASP.NET controller action

using IronXL;
using System.IO;

WorkBook workbook = WorkBook.Create(ExcelFileFormat.XLSX);
WorkSheet sheet = workbook.CreateWorkSheet("Report");
sheet.SetCellValue(0, 0, "Generated Report");

// Save to file path
workbook.SaveAs("Report.xlsx");

// Save as XLS (legacy format)
workbook.SaveAs("Report.xls");

// Save to MemoryStream for HTTP response
using MemoryStream ms = new MemoryStream();
workbook.SaveAs(ms);
byte[] fileBytes = ms.ToArray();
// fileBytes can be returned from an ASP.NET controller action

ASP.NET Coreの場合、コントローラー アクションから File(fileBytes, "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet", "Report.xlsx") を返して、ブラウザーのダウンロードをトリガーします。 IronXL ASP.NET Excel ガイドでは、完全なコントローラー統合パターンが示されています。

代替 for .NET Excel ライブラリとしては、 Open XML SDK が多くのライブラリの基盤となるオープン ソースの基盤です。

エクスポートされた Excel ファイルが正しいことをどのように確認しますか?

エクスポート後、 IronXLを使用してファイルを再度読み込んで、行数を確認したり、値をスポットチェックしたり、テスト プロジェクトで自動アサーションを実行したりできます。

using IronXL;

WorkBook loaded = WorkBook.Load("EmployeeData.xlsx");
WorkSheet sheet = loaded.WorkSheets[0];

// Verify row count (header row + data rows)
int totalRows = sheet.Rows.Count();
Console.WriteLine($"Rows in file: {totalRows}");

// Spot-check specific cell values
string header = sheet["A1"].StringValue;
string firstEmployee = sheet["A2"].StringValue;

Console.WriteLine($"Header: {header}, First row: {firstEmployee}");

using IronXL;

WorkBook loaded = WorkBook.Load("EmployeeData.xlsx");
WorkSheet sheet = loaded.WorkSheets[0];

// Verify row count (header row + data rows)
int totalRows = sheet.Rows.Count();
Console.WriteLine($"Rows in file: {totalRows}");

// Spot-check specific cell values
string header = sheet["A1"].StringValue;
string firstEmployee = sheet["A2"].StringValue;

Console.WriteLine($"Header: {header}, First row: {firstEmployee}");

この検証パターンは、ファイルを外部システムに送信する前にエクスポートの正確性を確認する必要がある統合テスト スイートで特に役立ちます。 IronXL読み取りチュートリアルでは、ファイルの読み込み後に使用できる読み取り操作の全範囲を示します。

.NETの DataSet および DataTable パターンの詳細については、 Microsoft DataSet ドキュメントで ADO .NETオブジェクト モデルが詳細に説明されています。

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

これで、単一の DataTable から複数シートのブック、データベース駆動型のエクスポート、フォーマットされたヘッダー、大規模データ ストリーミングまで、C# での主要な DataSet から Excel へのエクスポート シナリオすべてに対応する実用的なパターンが利用できるようになりました。 目標に応じて次のステップを実行する方法は次のとおりです。

• IronXL を無料でお試しください-無料の試用ライセンスから始めて、本番環境に移行する前に、上記の例を自分のデータに対して実行してください。 -完全な API リファレンスを読む- IronXLオブジェクト リファレンスには、WorkBook、WorkSheet、およびセル範囲のすべてのメソッドが含まれています。 -関連するエクスポート チュートリアルを調べる- C# DataTable から Excel へのガイドでは、逆のワークフロー (Excel を DataTable オブジェクトに読み込む) について説明します。 -書式設定オプションを確認する- IronXLセル書式設定ドキュメントには、数値の書式、境界線、背景色、配置オプションが表示されます。 -ライセンスを確認する- 実稼働環境での展開の場合は、 IronXLライセンス ページを参照して、開発者、組織、ロイヤリティフリーのオプションから選択してください。 -他のIron Softwareツールと比較- プロジェクトで PDF 生成や OCR も必要な場合は、 Iron Software製品スイートを使用すると、複数のライブラリを割引価格でバンドルできます。

ここで説明したパターンを基にして、スケジュールされたタスクの自動化、 ASP.NET Coreダウンロード エンドポイント、およびマルチフォーマット出力パイプラインをマネージ C# で完全にレイヤー化できます。Office や COM は不要で、 NuGetパッケージ以外のランタイム依存関係もありません。