IronXLを使用して C# でデータセットを Excel に変換する方法

DataSet から Excel への変換が不可欠な理由とは？

.NETの DataSet は、行、列、および関係を持つ 1 つ以上の DataTables を含む、メモリ内のデータ キャッシュを表します。 これらのDataSets を Excel に変換すると、次のことが可能になります。

*ビジネスレポート：*データベースクエリを関係者向けにフォーマットされたスプレッドシートに変換します データアーカイブ：アプリケーションデータをエクスポートして長期保存および分析します。 クロスプラットフォーム互換性：アプリケーションにアクセスできない可能性のあるユーザーとデータを共有できます 視覚化機能の強化：** Excelに組み込まれているグラフ作成ツールと分析ツールがエンドユーザーも利用可能

IronXLは、サーバーや開発マシンにExcelをインストールする必要なく変換処理を行える直感的なAPIを提供することで、このプロセスを簡素化します。このライブラリは、 .NET Framework 4.6.2以降、 .NET Core、および.NET 5から.NET 10までをサポートしており、Linuxコンテナやクラウド環境にデプロイされるアプリケーションを含む、最新のアプリケーションに適しています。 対応プラットフォームの詳細については、 IronXLの機能ページをご覧ください。

IronXLを.NETプロジェクトにインストールするにはどうすればよいですか？

IronXLのセットアップはほんの数分で完了します。 Visual Studioを開き、プロジェクトに移動してから、 NuGetパッケージマネージャーを使用してIronXLをインストールします。 詳しいセットアップ手順については、 IronXLの入門ガイドを参照してください。

パッケージマネージャーコンソールまたは.NET CLIを使用して、次のいずれかを実行します。

Install-Package IronXl.Excel
dotnet add package IronXl.Excel

Install-Package IronXl.Excel
dotnet add package IronXl.Excel

またはNuGetパッケージマネージャーUIで"IronXl.Excel"を検索し、インストールをクリックします。 パッケージは必要な依存関係をすべて自動的にダウンロードして設定します。 IronXLのNuGetインストールガイドには、その他のインストールオプションが記載されています。

インストールが完了したら、C# ファイルにIronXL名前空間を追加します。

using IronXL;
using System.Data;

using IronXL;
using System.Data;

これらのインポートが完了したら、DataSets を Excel ファイルに変換する準備が整いました。 Enterprise環境の場合は、適切な導入構成を確保するために、ライセンスオプションとトライアルライセンスのページを確認してください。

using IronXL;
using System.Data;

// Create a sample DataSet with product information
DataSet dataSet = new DataSet("ProductData");

// Create a DataTable for products
DataTable productsTable = new DataTable("Products");
productsTable.Columns.Add("ProductID", typeof(int));
productsTable.Columns.Add("ProductName", typeof(string));
productsTable.Columns.Add("Price", typeof(decimal));
productsTable.Columns.Add("InStock", typeof(bool));

// Add sample rows
productsTable.Rows.Add(1, "Laptop", 999.99m, true);
productsTable.Rows.Add(2, "Mouse", 19.99m, true);
productsTable.Rows.Add(3, "Keyboard", 49.99m, false);
productsTable.Rows.Add(4, "Monitor", 299.99m, true);
productsTable.Rows.Add(5, "Headphones", 79.99m, true);

// Add the DataTable to the DataSet
dataSet.Tables.Add(productsTable);

// Export DataSet to Excel using IronXL
WorkBook workBook = WorkBook.Create(ExcelFileFormat.XLSX);
WorkBook.LoadWorkSheetsFromDataSet(dataSet, workBook);

// Save the Excel file
workBook.SaveAs("ProductData.xlsx");

using IronXL;
using System.Data;

// Create a sample DataSet with product information
DataSet dataSet = new DataSet("ProductData");

// Create a DataTable for products
DataTable productsTable = new DataTable("Products");
productsTable.Columns.Add("ProductID", typeof(int));
productsTable.Columns.Add("ProductName", typeof(string));
productsTable.Columns.Add("Price", typeof(decimal));
productsTable.Columns.Add("InStock", typeof(bool));

// Add sample rows
productsTable.Rows.Add(1, "Laptop", 999.99m, true);
productsTable.Rows.Add(2, "Mouse", 19.99m, true);
productsTable.Rows.Add(3, "Keyboard", 49.99m, false);
productsTable.Rows.Add(4, "Monitor", 299.99m, true);
productsTable.Rows.Add(5, "Headphones", 79.99m, true);

// Add the DataTable to the DataSet
dataSet.Tables.Add(productsTable);

// Export DataSet to Excel using IronXL
WorkBook workBook = WorkBook.Create(ExcelFileFormat.XLSX);
WorkBook.LoadWorkSheetsFromDataSet(dataSet, workBook);

// Save the Excel file
workBook.SaveAs("ProductData.xlsx");

// Save as legacy XLS format
workBook.SaveAs("ProductData.xls");

// Save as CSV (comma-separated values)
workBook.SaveAsCsv("ProductData.csv");

// Save as TSV (tab-separated values)
workBook.SaveAs("ProductData.tsv");

// Save as legacy XLS format
workBook.SaveAs("ProductData.xls");

// Save as CSV (comma-separated values)
workBook.SaveAsCsv("ProductData.csv");

// Save as TSV (tab-separated values)
workBook.SaveAs("ProductData.tsv");

データベースデータをExcelに直接エクスポートするにはどうすればよいですか？

実際のアプリケーションはよくSQLデータベースからデータをエクスポートする必要があります。 次の例は、C# のトップレベル ステートメントを使用してデータベースにクエリを実行し、結果を Excel にエクスポートします。

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

string connectionString = "Data Source=server;Initial Catalog=SampleDB;Integrated Security=True";
string query = "SELECT OrderID, CustomerName, OrderDate, TotalAmount FROM Orders WHERE OrderDate >= '2024-01-01'";

DataSet dataSet = new DataSet();

// Populate DataSet from database
using (SqlConnection connection = new SqlConnection(connectionString))
{
    using (SqlDataAdapter adapter = new SqlDataAdapter(query, connection))
    {
        adapter.Fill(dataSet, "Orders");
    }
}

// Create Excel workbook and load data
WorkBook workBook = WorkBook.Create();
WorkBook.LoadWorkSheetsFromDataSet(dataSet, workBook);

// Auto-size columns for readability
WorkSheet worksheet = workBook.WorkSheets[0];
for (int i = 0; i < worksheet.Columns.Count(); i++)
{
    worksheet.AutoSizeColumn(i);
}

// Save with timestamp in filename
string fileName = $"OrdersExport_{DateTime.Now:yyyyMMdd_HHmmss}.xlsx";
workBook.SaveAs(fileName);

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

string connectionString = "Data Source=server;Initial Catalog=SampleDB;Integrated Security=True";
string query = "SELECT OrderID, CustomerName, OrderDate, TotalAmount FROM Orders WHERE OrderDate >= '2024-01-01'";

DataSet dataSet = new DataSet();

// Populate DataSet from database
using (SqlConnection connection = new SqlConnection(connectionString))
{
    using (SqlDataAdapter adapter = new SqlDataAdapter(query, connection))
    {
        adapter.Fill(dataSet, "Orders");
    }
}

// Create Excel workbook and load data
WorkBook workBook = WorkBook.Create();
WorkBook.LoadWorkSheetsFromDataSet(dataSet, workBook);

// Auto-size columns for readability
WorkSheet worksheet = workBook.WorkSheets[0];
for (int i = 0; i < worksheet.Columns.Count(); i++)
{
    worksheet.AutoSizeColumn(i);
}

// Save with timestamp in filename
string fileName = $"OrdersExport_{DateTime.Now:yyyyMMdd_HHmmss}.xlsx";
workBook.SaveAs(fileName);

この例では、データベースクエリからExcelファイルへの完全なワークフローを示します。SqlDataAdapter はクエリ結果をDataSet に格納し、 IronXLはそれをフォーマット済みのExcelファイルに変換します。自動サイズ調整機能により、列幅を手動で調整することなく、すべてのデータが表示されます。 より大規模なデータセットを扱う場合は、 ExcelをDataSetに変換してワークブックにデータをインポートする方法に関するガイドを参照してください。

1つのExcelファイルで複数のDataTablesをどのように処理しますか？

関連データを扱う場合、単一の DataSet には複数の DataTables が含まれる場合があります。 IronXLは各テーブルを自動的に個別のワークシートに変換します。

using IronXL;
using System.Data;

DataSet dataSet = new DataSet("CompanyData");

// Create Employees table
DataTable employeesTable = new DataTable("Employees");
employeesTable.Columns.Add("EmployeeID", typeof(int));
employeesTable.Columns.Add("Name", typeof(string));
employeesTable.Columns.Add("Department", typeof(string));
employeesTable.Rows.Add(1, "John Smith", "Sales");
employeesTable.Rows.Add(2, "Jane Doe", "Marketing");

// Create Departments table
DataTable departmentsTable = new DataTable("Departments");
departmentsTable.Columns.Add("DepartmentName", typeof(string));
departmentsTable.Columns.Add("Budget", typeof(decimal));
departmentsTable.Rows.Add("Sales", 100000m);
departmentsTable.Rows.Add("Marketing", 75000m);

// Add both tables to DataSet
dataSet.Tables.Add(employeesTable);
dataSet.Tables.Add(departmentsTable);

// Convert to Excel -- each DataTable becomes a worksheet
WorkBook workBook = WorkBook.Create();
WorkBook.LoadWorkSheetsFromDataSet(dataSet, workBook);

// Rename worksheets for clarity
workBook.WorkSheets[0].Name = "Employee List";
workBook.WorkSheets[1].Name = "Department Budgets";

workBook.SaveAs("CompanyData.xlsx");

using IronXL;
using System.Data;

DataSet dataSet = new DataSet("CompanyData");

// Create Employees table
DataTable employeesTable = new DataTable("Employees");
employeesTable.Columns.Add("EmployeeID", typeof(int));
employeesTable.Columns.Add("Name", typeof(string));
employeesTable.Columns.Add("Department", typeof(string));
employeesTable.Rows.Add(1, "John Smith", "Sales");
employeesTable.Rows.Add(2, "Jane Doe", "Marketing");

// Create Departments table
DataTable departmentsTable = new DataTable("Departments");
departmentsTable.Columns.Add("DepartmentName", typeof(string));
departmentsTable.Columns.Add("Budget", typeof(decimal));
departmentsTable.Rows.Add("Sales", 100000m);
departmentsTable.Rows.Add("Marketing", 75000m);

// Add both tables to DataSet
dataSet.Tables.Add(employeesTable);
dataSet.Tables.Add(departmentsTable);

// Convert to Excel -- each DataTable becomes a worksheet
WorkBook workBook = WorkBook.Create();
WorkBook.LoadWorkSheetsFromDataSet(dataSet, workBook);

// Rename worksheets for clarity
workBook.WorkSheets[0].Name = "Employee List";
workBook.WorkSheets[1].Name = "Department Budgets";

workBook.SaveAs("CompanyData.xlsx");

DataSet の各 DataTable は Excel ファイル内の個別のワークシートとなり、データの論理的な分離が維持されます。 この方法は、異なるデータカテゴリごとに個別のワークシートが必要なレポートを、すべて単一ファイル内に作成する場合に特に役立ちます。

Excelエクスポートに書式設定を追加するにはどうすればよいですか？

IronXLは基本的な書式設定を自動的に処理しますが、 Excelエクスポートにさらにスタイルを追加することで、プロフェッショナルなレポートを作成できます。

using IronXL;

// Assume workBook is already populated from DataSet
WorkSheet worksheet = workBook.WorkSheets[0];

// Style the header row
IronXl.Range headerRange = worksheet.GetRange("A1:D1");
headerRange.Style.Font.Bold = true;
headerRange.Style.BackgroundColor = "#4472C4";
headerRange.Style.Font.Color = "#FFFFFF";

// Format currency column (column C, rows 2 onward)
for (int rowIndex = 1; rowIndex < worksheet.RowCount; rowIndex++)
{
    worksheet[$"C{rowIndex + 1}"].FormatString = "$#,##0.00";
}

// Add borders to the data range
IronXl.Range dataRange = worksheet.GetRange($"A1:D{worksheet.RowCount}");
dataRange.Style.Border.TopBorder.Type = IronXl.Styles.BorderType.Thin;
dataRange.Style.Border.BottomBorder.Type = IronXl.Styles.BorderType.Thin;

workBook.SaveAs("FormattedExport.xlsx");

using IronXL;

// Assume workBook is already populated from DataSet
WorkSheet worksheet = workBook.WorkSheets[0];

// Style the header row
IronXl.Range headerRange = worksheet.GetRange("A1:D1");
headerRange.Style.Font.Bold = true;
headerRange.Style.BackgroundColor = "#4472C4";
headerRange.Style.Font.Color = "#FFFFFF";

// Format currency column (column C, rows 2 onward)
for (int rowIndex = 1; rowIndex < worksheet.RowCount; rowIndex++)
{
    worksheet[$"C{rowIndex + 1}"].FormatString = "$#,##0.00";
}

// Add borders to the data range
IronXl.Range dataRange = worksheet.GetRange($"A1:D{worksheet.RowCount}");
dataRange.Style.Border.TopBorder.Type = IronXl.Styles.BorderType.Thin;
dataRange.Style.Border.BottomBorder.Type = IronXl.Styles.BorderType.Thin;

workBook.SaveAs("FormattedExport.xlsx");

これらの書式オプションは、プレーンなデータエクスポートをプロフェッショナルなスプレッドシートに変換します。 スタイル設定機能には、フォントのプロパティ、色、枠線、数値形式などが含まれており、組織のレポート基準に合ったエクスポートを作成できます。 セルレベルの書式設定の詳細については、 IronXLのセル書式設定ガイドを参照してください。

本番環境へのデプロイ前に知っておくべきこととは？

DataSet-to-Excel パイプラインを本番環境にデプロイする前に、以下の事項を確認してください。

ライセンス： IronXLを本番環境で使用するには、有効なライセンスキーが必要です。 無料トライアルライセンスから始めて、必要に応じて有料プランにアップグレードできます。 ライセンスの種類については、 IronXLのライセンスページに詳しく記載されています。

エラー処理：ワークブックの作成およびファイルの保存操作の周囲にtry-catchブロックを実装してください。 IronXLに渡す前に、DataSet の内容を検証します。特に、テーブルと列が null でないことを確認します。 本番環境での問題を診断するのに十分なコンテキスト情報を含めて、障害ログを記録する。

ファイルパスの管理：コンテナ化された環境では、出力パスに環境変数またはボリュームマウントを使用します。 すべてのデプロイメント対象に存在しない可能性のあるハードコードされたパスは避けてください。 コンテナに適したパターンを以下に示します。

using IronXL;

string outputPath = Environment.GetEnvironmentVariable("EXCEL_OUTPUT_PATH") ?? "/app/output";
string fileName = System.IO.Path.Combine(outputPath, $"Export_{Guid.NewGuid()}.xlsx");
workBook.SaveAs(fileName);

using IronXL;

string outputPath = Environment.GetEnvironmentVariable("EXCEL_OUTPUT_PATH") ?? "/app/output";
string fileName = System.IO.Path.Combine(outputPath, $"Export_{Guid.NewGuid()}.xlsx");
workBook.SaveAs(fileName);

プラットフォームのサポート： IronXLの機能ページに、対象環境が記載されていることを確認してください。 IronXLは、Windows、Linux、macOS、Docker、AWS、Azureを標準でサポートしています。

主なメリットの概要：

• Microsoft Officeへの依存なし - サーバーおよびコンテナ環境への導入に適しています
• 複数のExcel形式のサポート (XLSX, XLS, CSV, TSV)
• DataTables からのワークシートの自動作成
• クラウドおよびコンテナ展開のためのクロスプラットフォーム互換性
• 最小限のコードで完全な変換が可能な直感的なAPI DataSets

グラフ作成、数式サポート、高度な書式設定などの追加機能については、 IronXLのドキュメントとIronXLの使い方ライブラリをご覧ください。