C# オブジェクトリストをExcelにエクスポート

リストをExcelファイルにエクスポートすることがなぜ難しいのですか？

データを Excel にエクスポートするための従来のアプローチでは、多くの場合 Microsoft Office Interop が使用されますが、そのためにはサーバー上に MS Excel をインストールする必要があり、展開に問題が生じます。 リフレクションを使用した手動のセルごとの入力は時間を要し、エラーが起きやすいです。 IronXL のデータ インポート機能は、 MS Office や複雑なリフレクション コードを必要とせずに、データ ソースと Excel 列ヘッダー間のインテリジェントなプロパティ マッピングによってこれらの問題を解決します。

このライブラリは型変換を自動的に処理し、ネストオブジェクトをサポートし、CSVやXLSXファイルのような異なる形式でのデータの一貫性を維持します。 Interop なしで C# Excel 操作に取り組んでいる開発者にとって、 IronXL は、信頼性の高い Excel 生成とデータのインポート/エクスポート機能を必要とする最新 for .NETプロジェクトに最適な選択肢です。

IronXL はどのようにインストールしますか?

IronXLを使い始めるには、最小限の設定が必要です。NuGetパッケージマネージャーコンソールからライブラリをインストールしてください。

Install-Package IronXL

Install-Package IronXL

または.NET CLIを使用します：

dotnet add package IronXL

dotnet add package IronXL

インストールが完了したら、ファイルにusing IronXL;ディレクティブを追加してください。追加のOffice依存関係やランタイムのインストールは必要ありません。

シンプルなリストを Excel にエクスポートするにはどうすればよいでしょうか?

次の例は、 .NET 10 で推奨されるスタイルであるトップレベル ステートメントを使用して、Employee オブジェクトのリストを XLSX ファイルにエクスポートする方法を示しています。

using IronXL;
using System.Data;

// Define the Employee model
record Employee(int Id, string Name, string Department, decimal Salary, DateTime HireDate);

// Create sample employee data
List<Employee> employees =
[
    new(1, "Alice Johnson", "Engineering", 95000, new DateTime(2020, 3, 15)),
    new(2, "Bob Smith",    "Marketing",   75000, new DateTime(2021, 7, 1)),
    new(3, "Carol Williams","Engineering",105000, new DateTime(2019, 11, 20))
];

// Build a DataTable from the list
DataTable dataTable = new();
dataTable.Columns.Add("Id",         typeof(int));
dataTable.Columns.Add("Name",       typeof(string));
dataTable.Columns.Add("Department", typeof(string));
dataTable.Columns.Add("Salary",     typeof(decimal));
dataTable.Columns.Add("HireDate",   typeof(DateTime));

foreach (var emp in employees)
    dataTable.Rows.Add(emp.Id, emp.Name, emp.Department, emp.Salary, emp.HireDate);

// Create an IronXL workbook and worksheet
WorkBook workbook  = new();
WorkSheet worksheet = workbook.CreateWorkSheet("Employees");

// Write headers
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]);

// Save as XLSX
workbook.SaveAs("EmployeeReport.xlsx");
Console.WriteLine("EmployeeReport.xlsx saved.");

using IronXL;
using System.Data;

// Define the Employee model
record Employee(int Id, string Name, string Department, decimal Salary, DateTime HireDate);

// Create sample employee data
List<Employee> employees =
[
    new(1, "Alice Johnson", "Engineering", 95000, new DateTime(2020, 3, 15)),
    new(2, "Bob Smith",    "Marketing",   75000, new DateTime(2021, 7, 1)),
    new(3, "Carol Williams","Engineering",105000, new DateTime(2019, 11, 20))
];

// Build a DataTable from the list
DataTable dataTable = new();
dataTable.Columns.Add("Id",         typeof(int));
dataTable.Columns.Add("Name",       typeof(string));
dataTable.Columns.Add("Department", typeof(string));
dataTable.Columns.Add("Salary",     typeof(decimal));
dataTable.Columns.Add("HireDate",   typeof(DateTime));

foreach (var emp in employees)
    dataTable.Rows.Add(emp.Id, emp.Name, emp.Department, emp.Salary, emp.HireDate);

// Create an IronXL workbook and worksheet
WorkBook workbook  = new();
WorkSheet worksheet = workbook.CreateWorkSheet("Employees");

// Write headers
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]);

// Save as XLSX
workbook.SaveAs("EmployeeReport.xlsx");
Console.WriteLine("EmployeeReport.xlsx saved.");

この例では、List<Employee> を DataTable に変換し、ヘッダーと行をIronXLワークシートに書き込みます。 IronXL は、DateTime などのデータ型を自動的に処理し、生成されたスプレッドシートのフォーマットがきれいであることを保証します。 Excel の保存機能により、任意のスプレッドシート アプリケーションで開くことができる XLSX ファイルが生成されます。

複雑なビジネス オブジェクトをどのようにエクスポートしますか?

実際 for .NETアプリケーションは、より複雑なデータ構造を伴うことがよくあります。 次の例では、計算プロパティを使用して製品在庫レポートを生成します。

using IronXL;
using System.Data;

// Define the Product model with a computed property
record Product(
    string SKU,
    string ProductName,
    string Category,
    decimal Price,
    int StockLevel,
    bool IsActive,
    DateTime LastRestocked)
{
    public decimal CalculatedValue => Price * StockLevel;
}

// Build the product list
List<Product> products =
[
    new("TECH-001", "Wireless Mouse",      "Electronics",     29.99m, 150, true,  DateTime.Now.AddDays(-5)),
    new("TECH-002", "Mechanical Keyboard", "Electronics",     89.99m,  75, true,  DateTime.Now.AddDays(-12)),
    new("OFF-001",  "Desk Organizer",      "Office Supplies", 15.99m,   0, false, DateTime.Now.AddMonths(-1))
];

// Populate a DataTable
DataTable dt = new();
dt.Columns.Add("SKU",             typeof(string));
dt.Columns.Add("ProductName",     typeof(string));
dt.Columns.Add("Category",        typeof(string));
dt.Columns.Add("Price",           typeof(decimal));
dt.Columns.Add("StockLevel",      typeof(int));
dt.Columns.Add("IsActive",        typeof(bool));
dt.Columns.Add("LastRestocked",   typeof(DateTime));
dt.Columns.Add("CalculatedValue", typeof(decimal));

foreach (var p in products)
    dt.Rows.Add(p.SKU, p.ProductName, p.Category, p.Price,
                p.StockLevel, p.IsActive, p.LastRestocked, p.CalculatedValue);

// Create the workbook
WorkBook  wb = WorkBook.Create();
WorkSheet ws = wb.CreateWorkSheet("Inventory");

// Write column headers
string[] headers = ["SKU","ProductName","Category","Price",
                    "StockLevel","IsActive","LastRestocked","CalculatedValue"];
for (int col = 0; col < headers.Length; col++)
    ws.SetCellValue(0, col, headers[col]);

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

// Auto-size columns for readability
for (int col = 0; col < headers.Length; col++)
    ws.AutoSizeColumn(col);

wb.SaveAs("ProductInventory.xlsx");
Console.WriteLine("ProductInventory.xlsx saved.");

using IronXL;
using System.Data;

// Define the Product model with a computed property
record Product(
    string SKU,
    string ProductName,
    string Category,
    decimal Price,
    int StockLevel,
    bool IsActive,
    DateTime LastRestocked)
{
    public decimal CalculatedValue => Price * StockLevel;
}

// Build the product list
List<Product> products =
[
    new("TECH-001", "Wireless Mouse",      "Electronics",     29.99m, 150, true,  DateTime.Now.AddDays(-5)),
    new("TECH-002", "Mechanical Keyboard", "Electronics",     89.99m,  75, true,  DateTime.Now.AddDays(-12)),
    new("OFF-001",  "Desk Organizer",      "Office Supplies", 15.99m,   0, false, DateTime.Now.AddMonths(-1))
];

// Populate a DataTable
DataTable dt = new();
dt.Columns.Add("SKU",             typeof(string));
dt.Columns.Add("ProductName",     typeof(string));
dt.Columns.Add("Category",        typeof(string));
dt.Columns.Add("Price",           typeof(decimal));
dt.Columns.Add("StockLevel",      typeof(int));
dt.Columns.Add("IsActive",        typeof(bool));
dt.Columns.Add("LastRestocked",   typeof(DateTime));
dt.Columns.Add("CalculatedValue", typeof(decimal));

foreach (var p in products)
    dt.Rows.Add(p.SKU, p.ProductName, p.Category, p.Price,
                p.StockLevel, p.IsActive, p.LastRestocked, p.CalculatedValue);

// Create the workbook
WorkBook  wb = WorkBook.Create();
WorkSheet ws = wb.CreateWorkSheet("Inventory");

// Write column headers
string[] headers = ["SKU","ProductName","Category","Price",
                    "StockLevel","IsActive","LastRestocked","CalculatedValue"];
for (int col = 0; col < headers.Length; col++)
    ws.SetCellValue(0, col, headers[col]);

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

// Auto-size columns for readability
for (int col = 0; col < headers.Length; col++)
    ws.AutoSizeColumn(col);

wb.SaveAs("ProductInventory.xlsx");
Console.WriteLine("ProductInventory.xlsx saved.");

このコードは、SKU、価格、在庫レベル、再入荷日などの詳細を含む Product オブジェクトのリストを作成し、各アイテムの派生 CalculatedValue を計算します。 IronXL は、小数、ブール値、日付などのデータ型を処理し、プロフェッショナルなスプレッドシート出力を保証します。 結果、ProductInventory.xlsx は、ビジネス レポートや分析に適した、クリーンでデータ駆動型の在庫エクスポートを提供します。 既存のコードベースが既に DataTable オブジェクトで動作している場合は、 DataTable を Excel に直接エクスポートすることもできます。

プロフェッショナルな書式設定を追加するにはどうすればいいですか?

フォーマット設定により、基本的なエクスポートが洗練されたレポートに変換されます。 IronXL のスタイリング API は、任意のセルまたは範囲のフォント、色、境界線、数値形式の設定を公開します。

using IronXL;

WorkBook  wb = WorkBook.Load("ProductInventory.xlsx");
WorkSheet ws = wb.DefaultWorkSheet;

// Bold header row with a blue background and white text
Range headerRange = ws["A1:H1"];
headerRange.Style.Font.Bold            = true;
headerRange.Style.BackgroundColor      = "#4472C4";
headerRange.Style.Font.Color           = "#FFFFFF";

// Format the Price column as currency
Range priceColumn = ws["D2:D100"];
priceColumn.Style.NumberFormat = "$#,##0.00";

// Highlight low-stock rows in red
for (int row = 2; row <= 4; row++)
{
    var stockCell = ws[$"E{row}"];
    if (stockCell.IntValue < 10)
        stockCell.Style.BackgroundColor = "#FF6B6B";
}

wb.SaveAs("FormattedInventory.xlsx");
Console.WriteLine("FormattedInventory.xlsx saved.");

using IronXL;

WorkBook  wb = WorkBook.Load("ProductInventory.xlsx");
WorkSheet ws = wb.DefaultWorkSheet;

// Bold header row with a blue background and white text
Range headerRange = ws["A1:H1"];
headerRange.Style.Font.Bold            = true;
headerRange.Style.BackgroundColor      = "#4472C4";
headerRange.Style.Font.Color           = "#FFFFFF";

// Format the Price column as currency
Range priceColumn = ws["D2:D100"];
priceColumn.Style.NumberFormat = "$#,##0.00";

// Highlight low-stock rows in red
for (int row = 2; row <= 4; row++)
{
    var stockCell = ws[$"E{row}"];
    if (stockCell.IntValue < 10)
        stockCell.Style.BackgroundColor = "#FF6B6B";
}

wb.SaveAs("FormattedInventory.xlsx");
Console.WriteLine("FormattedInventory.xlsx saved.");

これらのスタイリングオプションは、生のデータエクスポートを役員向けのレポートに変換します。 背景色付きの太字のヘッダーは視覚的な階層を作成します。 数値の書式設定により、通貨の値が正しく表示されます。 条件付きフォーマットは、低在庫水準などの重要なビジネスメトリックを強調し、エクスポートされたExcelスプレッドシートをインベントリ管理のためにすぐに実行可能にします。 高度なセル書式設定と境界線スタイルについて詳しく学習して、エクスポートをさらに強化することができます。

リストを他のファイル形式にエクスポートするにはどうすればよいですか?

IronXLは XLSX に限定されません。 同じ WorkBook オブジェクトは、メソッドを 1 つ変更するだけで複数の形式で保存できます。

• XLSX -- デフォルトの最新の Excel 形式: workbook.SaveAs("output.xlsx")
• XLS -- 古いバージョンの Office 用の従来の Excel 形式
• CSV - データパイプラインの互換性のためのカンマ区切り値
• TSV -- タブ区切りの値

CSV形式にエクスポートすると、各ワークシートは個別のCSVファイルになります。そのため、 IronXLはエンドユーザーレポートだけでなく、ETLパイプライン、データサイエンスツール、サードパーティAPIで使用される中間データファイルの生成にも役立ちます。Windowsフォームアプリでよく使用されるDataGridViewデータのエクスポートでは、 IronXLは追加のアダプターを必要とせずにスムーズに機能します。

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

Web API またはRazor Pages アプリケーションを構築する場合、通常は Excel ファイルをディスクに保存するのではなく、HTTP 応答として返す必要があります。 以下のパターンは、コントローラー アクションから FileContentResult を返します。

コントローラは、WorkBook を構築し、workbook.ToByteArray() を呼び出し、MIME タイプ application/vnd.openxmlformats-officedocument.spreadsheetml.sheet と Content-Disposition: attachment ヘッダーを持つバイトを返すサービスを挿入します。 このアプローチは、 .NET 10 の最小限の API または MVC コントローラーで機能します。

完全なチュートリアルについては、 ASP.NET Core Excel エクスポート チュートリアルと、 Blazor WebAssembly またはBlazor Server アプリケーションを構築する場合はBlazorエクスポート チュートリアルを参照してください。

今すぐIronXLを使い始めるにはどうすればいいですか?

IronXL は、Excel 生成のタスクを保守可能なコードに変換します。 その API は、Microsoft Office への依存を排除​​しながら、企業の要件を満たすプロフェッショナルな結果を提供します。 ライブラリの機能セットは、基本的なリストのエクスポートから、スタイルとフォーマットによる複雑なデータ変換まですべてを処理します。

IronXL を使用して、既存のワークブックを読み取って編集したり、 Excel データを DataTable にエクスポートしてさらに処理したり、概要レポート用の ピボット テーブルを作成したりすることもできます。 これらの機能のいずれかを上記の書式設定オプションと組み合わせると、配布前に手動で調整する必要のないスプレッドシートを作成できます。

IronXLはNuGetで入手でき、 .NET 10、 .NET 8、または.NET Framework 4.6.2+を対象とするすべてのプロジェクトで動作します。 Open XML SDK は、 IronXL が読み取りおよび書き込みを行う XLSX ファイル形式の基盤となるため、生成されたファイルが ECMA-376 標準に準拠し、OOXML と互換性のあるあらゆるアプリケーションで正しく開くことが保証されます。

今IronXLを始めましょう。

無料で始める

C# リストを Excel にエクスポートする準備はできましたか? 今すぐIronXLをダウンロードして、 .NETアプリケーションでリスト オブジェクトを Excel に素早く変換できることを体験してください。 実稼働環境での展開では、ニーズに合わせて拡張できる柔軟なライセンス オプションを検討してください。 その他のチュートリアルと例については、ドキュメントをご覧ください。