IronXLを使用して C# .NET Coreで Excel スプレッドシートを作成する方法

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

スプレッドシートを作成する前に、プロジェクトにIronXL を追加する必要があります。 Visual Studio でNuGetパッケージ マネージャー コンソールを開き、次のいずれかのコマンドを実行します。

Install-Package IronXL
dotnet add package IronXL

Install-Package IronXL
dotnet add package IronXL

最初のコマンドは、Visual Studio パッケージ マネージャー コンソールで機能します。 2 番目は、 .NET CLI を使用する任意のターミナルで動作します。 どちらも同じNuGetパッケージをインストールし、プロジェクト参照にIronXL を自動的に追加します。

インストールが完了すると、 IronXLはusingディレクティブを1つ追加するだけで使用できるようになります。このライブラリは、追加の設定、ランタイム依存関係、またはMicrosoft Officeのインストールを必要としません。 これは、 .NET 10 が実行されるあらゆるプラットフォーム (Windows、Linux、macOS、または任意のクラウド環境) で動作します。

手動による DLL のダウンロードを含む詳細なインストール オプションについては、 IronXLインストール ガイドを参照してください。 Linux 開発者は、プラットフォーム固有のガイダンスについてはLinux 展開ドキュメントも確認する必要があります。

Office に依存せずに Excel スプレッドシートを作成するにはどうすればよいですか?

従来の Microsoft Excel 自動化では、MS Office のインストールが必要で、Office Interop が使用されますが、これは Linux やコンテナー化された環境では動作しません。 Microsoft の Office Interop に関するドキュメントで説明されているように、Office Interop では展開の複雑さとライセンスに関する懸念が生じます。 IronXL for .NETは、Excelファイルをネイティブに処理し、最新のスプレッドシート機能を完全にサポートする純粋な.NETソリューションを提供することで、これらの制限を排除します。

このライブラリは、.NET 8、.NET 9、.NET 10、および以前 for .NET Coreバージョンをサポートしています。 XLSX、XLS、CSV、その他のスプレッドシート形式を、外部依存なしに処理します。 これは、サーバー側アプリケーション、マイクロサービス、および Microsoft Office のインストールが現実的でないシナリオにとって特に有益です。 NuGetによる簡単な統合により、数分以内に Excel ファイルの作成を開始できます。

using IronXL;

// Create a new workbook in XLSX format
WorkBook workbook = WorkBook.Create(ExcelFileFormat.XLSX);
// Add an Excel worksheet with a custom name
WorkSheet sheet = workbook.CreateWorkSheet("SalesReport");
// Set a cell value
sheet["A1"].Value = "Product Sales Summary";
// Save the generated Excel file
workbook.SaveAs("SalesReport.xlsx");

using IronXL;

// Create a new workbook in XLSX format
WorkBook workbook = WorkBook.Create(ExcelFileFormat.XLSX);
// Add an Excel worksheet with a custom name
WorkSheet sheet = workbook.CreateWorkSheet("SalesReport");
// Set a cell value
sheet["A1"].Value = "Product Sales Summary";
// Save the generated Excel file
workbook.SaveAs("SalesReport.xlsx");

WorkBook.Create() メソッドは、XLSX (Excel 2007 で導入された最新の XML ベースの形式) または XLS (従来のバイナリ形式) を指定するための ExcelFileFormat パラメータを受け入れて、新しい Excel ブックを初期化します。 ファイルサイズが小さく、最新のツールとの互換性が高いため、ほとんどのシナリオではXLSXを推奨します。 CreateWorkSheet() メソッドは、Excel データが存在する名前付きワークシートを追加します。各ワークブックには、関連するデータを整理するための複数の個別のシートを含めることができます。

セルの値は、Excel のアドレス指定システムを反映した括弧表記を使用して設定されます -- sheet["A1"] はセル A1 を直接ターゲットにします。 この構文は特定のセルと範囲の両方をサポートしているため、あらゆるスプレッドシート プロジェクトで一括操作が簡単になります。

プログラムでワークシートを追加してデータを入力するにはどうすればよいですか?

実際のExcelスプレッドシートには、複数のワークシートにまたがる構造化データが含まれています。 IronXLは、データ駆動型アプリケーションにおける手動データ入力や自動化されたデータパイプラインを問わず、情報を整理しセルに効率的に入力するための柔軟な方法を提供します。

using IronXL;

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

// Set column names as headers
sheet["A1"].Value = "Month";
sheet["B1"].Value = "Revenue";
sheet["C1"].Value = "Units Sold";

// Populate Excel data using a loop (mock sales data)
string[] months = { "January", "February", "March", "April", "May", "June" };
decimal[] revenue = { 45000.50m, 52000.75m, 48500.25m, 61000.00m, 58750.50m, 67200.25m };
int[] units = { 150, 175, 160, 200, 190, 220 };

for (int i = 0; i < months.Length; i++)
{
    int row = i + 2;
    sheet[$"A{row}"].Value = months[i];
    sheet[$"B{row}"].Value = revenue[i];
    sheet[$"C{row}"].Value = units[i];
}

// Set a range of cells to the same value across columns
sheet["D2:D7"].Value = "Active";
workbook.SaveAs("MonthlySales.xlsx");

using IronXL;

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

// Set column names as headers
sheet["A1"].Value = "Month";
sheet["B1"].Value = "Revenue";
sheet["C1"].Value = "Units Sold";

// Populate Excel data using a loop (mock sales data)
string[] months = { "January", "February", "March", "April", "May", "June" };
decimal[] revenue = { 45000.50m, 52000.75m, 48500.25m, 61000.00m, 58750.50m, 67200.25m };
int[] units = { 150, 175, 160, 200, 190, 220 };

for (int i = 0; i < months.Length; i++)
{
    int row = i + 2;
    sheet[$"A{row}"].Value = months[i];
    sheet[$"B{row}"].Value = revenue[i];
    sheet[$"C{row}"].Value = units[i];
}

// Set a range of cells to the same value across columns
sheet["D2:D7"].Value = "Active";
workbook.SaveAs("MonthlySales.xlsx");

文字列補間 ($"A{row}") により、ループ内での動的なセル アドレス指定が可能になり、任意のデータ ソースからプログラムで行を簡単に入力できるようになります。 範囲構文 sheet["D2:D7"] は、複数のセルに対して同時に値を適用します。これは、ステータス列、既定値、またはデータ領域の初期化に役立ちます。 IronXL はデータ型の変換を自動的に処理し、生成されたファイルに適切な Excel データ型を保持しながら、小数を数値として、文字列コンテンツをテキストとして保存します。

WorkSheet summarySheet = workbook.CreateWorkSheet("Summary");
WorkSheet detailSheet = workbook.CreateWorkSheet("Details");
WorkSheet archiveSheet = workbook.CreateWorkSheet("Archive");

WorkSheet summarySheet = workbook.CreateWorkSheet("Summary");
WorkSheet detailSheet = workbook.CreateWorkSheet("Details");
WorkSheet archiveSheet = workbook.CreateWorkSheet("Archive");

プロフェッショナルな書式設定とスタイル設定をどのように適用しますか?

生データは、適切にフォーマットされたときに意味を持つようになります。 IronXL は、背景色、フォント、境界線、数値形式など、Excel スプレッドシートを経営陣向けプレゼンテーションや顧客への成果物に適した洗練されたレポートに変換するための重要な書式設定機能をサポートしています。

using IronXL;

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

// Create headers with styling
sheet["A1"].Value = "Category";
sheet["B1"].Value = "Amount";
sheet["C1"].Value = "Date";

// Apply header formatting to the Excel sheet
sheet["A1:C1"].Style.SetBackgroundColor("#2E86AB");
sheet["A1:C1"].Style.Font.Bold = true;
sheet["A1:C1"].Style.Font.SetColor("#FFFFFF");

// Add sample data to specific cells
sheet["A2"].Value = "Software License";
sheet["B2"].Value = 1299.99m;
sheet["C2"].Value = DateTime.なしw;

// Format currency and date columns
sheet["B2"].FormatString = "$#,##0.00";
sheet["C2"].FormatString = "yyyy-MM-dd";

// Add borders around the data range
var dataRange = sheet["A1:C2"];
dataRange.Style.BottomBorder.SetColor("#000000");
dataRange.Style.BottomBorder.Type = IronXl.Styles.BorderType.Thin;
workbook.SaveAs("FormattedReport.xlsx");

using IronXL;

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

// Create headers with styling
sheet["A1"].Value = "Category";
sheet["B1"].Value = "Amount";
sheet["C1"].Value = "Date";

// Apply header formatting to the Excel sheet
sheet["A1:C1"].Style.SetBackgroundColor("#2E86AB");
sheet["A1:C1"].Style.Font.Bold = true;
sheet["A1:C1"].Style.Font.SetColor("#FFFFFF");

// Add sample data to specific cells
sheet["A2"].Value = "Software License";
sheet["B2"].Value = 1299.99m;
sheet["C2"].Value = DateTime.なしw;

// Format currency and date columns
sheet["B2"].FormatString = "$#,##0.00";
sheet["C2"].FormatString = "yyyy-MM-dd";

// Add borders around the data range
var dataRange = sheet["A1:C2"];
dataRange.Style.BottomBorder.SetColor("#000000");
dataRange.Style.BottomBorder.Type = IronXl.Styles.BorderType.Thin;
workbook.SaveAs("FormattedReport.xlsx");

Style プロパティは、Microsoft Excel の機能に一致する書式設定オプションを公開します。 背景色は 16 進コード (プレフィックス # の有無にかかわらず) を受け入れますが、FormatString は Excel のカスタム書式設定構文と同じ数値形式を適用します。つまり、同じパターンが両方の環境で機能します。 境界線のスタイル設定では、細線、中線、太線、および二重線がサポートされており、Excel ワークシート内のセルの境界を正確に制御できます。

自動計算に Excel の数式をどのように使用しますか?

Excel の計算エンジンはデータ分析を自動化し、 IronXL は数式を完全にサポートします。 標準の Excel 構文を使用して数式を文字列として設定すると、 IronXL は要求に応じて結果を自動的に計算します。これはレポート作成や財務分析に不可欠です。

using IronXL;

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

// Add expense data to the Excel workbook
sheet["A1"].Value = "Expense";
sheet["B1"].Value = "Amount";
sheet["A2"].Value = "Rent";
sheet["B2"].Value = 2500;
sheet["A3"].Value = "Utilities";
sheet["B3"].Value = 350;
sheet["A4"].Value = "Supplies";
sheet["B4"].Value = 875;
sheet["A5"].Value = "Marketing";
sheet["B5"].Value = 1200;

// Add formulas for calculations
sheet["A7"].Value = "Total:";
sheet["B7"].Formula = "=SUM(B2:B5)";
sheet["A8"].Value = "Average:";
sheet["B8"].Formula = "=AVERAGE(B2:B5)";
sheet["A9"].Value = "Maximum:";
sheet["B9"].Formula = "=MAX(B2:B5)";
sheet["A10"].Value = "Count:";
sheet["B10"].Formula = "=COUNT(B2:B5)";

// Calculate all formulas
workbook.EvaluateAll();

// Access calculated values programmatically
decimal total = sheet["B7"].DecimalValue;
Console.WriteLine($"Calculated total: {total}");
workbook.SaveAs("BudgetCalculations.xlsx");

using IronXL;

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

// Add expense data to the Excel workbook
sheet["A1"].Value = "Expense";
sheet["B1"].Value = "Amount";
sheet["A2"].Value = "Rent";
sheet["B2"].Value = 2500;
sheet["A3"].Value = "Utilities";
sheet["B3"].Value = 350;
sheet["A4"].Value = "Supplies";
sheet["B4"].Value = 875;
sheet["A5"].Value = "Marketing";
sheet["B5"].Value = 1200;

// Add formulas for calculations
sheet["A7"].Value = "Total:";
sheet["B7"].Formula = "=SUM(B2:B5)";
sheet["A8"].Value = "Average:";
sheet["B8"].Formula = "=AVERAGE(B2:B5)";
sheet["A9"].Value = "Maximum:";
sheet["B9"].Formula = "=MAX(B2:B5)";
sheet["A10"].Value = "Count:";
sheet["B10"].Formula = "=COUNT(B2:B5)";

// Calculate all formulas
workbook.EvaluateAll();

// Access calculated values programmatically
decimal total = sheet["B7"].DecimalValue;
Console.WriteLine($"Calculated total: {total}");
workbook.SaveAs("BudgetCalculations.xlsx");

Formula プロパティは標準の Excel 数式構文を受け入れます。つまり、Microsoft Excel で機能するのと同じ数式がここでも機能します。 数式を設定した後、EvaluateAll() を呼び出して結果を計算します。 この手順により、計算された値が、IntValue、または StringValue などの型指定されたプロパティを通じてすぐに利用できるようになります。 EvaluateAll() を呼び出さなくても、数式は正しく保存され、Excel で開いたときに計算されますが、結果へのプログラムによるアクセスには最初に評価が必要です。

decimal sum = sheet["B2:B5"].Sum();
decimal avg = sheet["B2:B5"].Avg();
decimal max = sheet["B2:B5"].Max();

decimal sum = sheet["B2:B5"].Sum();
decimal avg = sheet["B2:B5"].Avg();
decimal max = sheet["B2:B5"].Max();

Excel ファイルをエクスポートしてダウンロード用に提供するにはどうすればよいですか?

IronXLはさまざまな統合要件を満たすために複数のエクスポート形式をサポートしています。 スプレッドシートは、標準的なExcel形式以外にも、データ交換用のCSV、Webアプリケーション用のJSON、レガシーシステムとの互換性を保つためのTSVにエクスポートすることができます。 この柔軟性により、Excel作成をあらゆるワークフローに簡単に統合できます。

using IronXL;

WorkBook workbook = WorkBook.Load("BudgetCalculations.xlsx");

// Export to different formats
workbook.SaveAs("output.xlsx");      // Modern Excel (Office 2007+)
workbook.SaveAs("output.xls");       // Legacy Excel (97-2003)
workbook.SaveAsCsv("output.csv");    // CSV for data import/export
workbook.SaveAsJson("output.json");  // JSON for web APIs

using IronXL;

WorkBook workbook = WorkBook.Load("BudgetCalculations.xlsx");

// Export to different formats
workbook.SaveAs("output.xlsx");      // Modern Excel (Office 2007+)
workbook.SaveAs("output.xls");       // Legacy Excel (97-2003)
workbook.SaveAsCsv("output.csv");    // CSV for data import/export
workbook.SaveAsJson("output.json");  // JSON for web APIs

各フォーマットは、特定の使用ケースに対応しています。 XLSXは、Excelユーザーと共有する際に、書式や数式を保持するために最適です。 CSVは、データベース、分析ツール、または他のスプレッドシートアプリケーションにインポートするための最大の互換性を提供します。 JSON は、 JavaScriptフロントエンドおよび REST API と自然に統合されます。

[HttpGet("download-report")]
public IActionResult DownloadReport()
{
    WorkBook workbook = WorkBook.Create(ExcelFileFormat.XLSX);
    WorkSheet sheet = workbook.CreateWorkSheet("Report");
    sheet["A1"].Value = "Generated Report";
    sheet["A2"].Value = DateTime.なしw;

    var stream = workbook.ToStream();
    return File(
        stream,
        "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
        "Report.xlsx"
    );
}

[HttpGet("download-report")]
public IActionResult DownloadReport()
{
    WorkBook workbook = WorkBook.Create(ExcelFileFormat.XLSX);
    WorkSheet sheet = workbook.CreateWorkSheet("Report");
    sheet["A1"].Value = "Generated Report";
    sheet["A2"].Value = DateTime.なしw;

    var stream = workbook.ToStream();
    return File(
        stream,
        "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
        "Report.xlsx"
    );
}

IronXL と他 for .NET Excel ライブラリを比較するとどうなりますか?

.NET Excel操作用のライブラリはいくつか存在し、それぞれ強みが異なります。 以下の表は、本番アプリケーションにとって最も重要な基準について、各製品を比較したものです。

IronXL は、信頼性の高い技術サポート、ドキュメント、一貫した更新を必要とするエンタープライズ シナリオに最適です。 このライブラリは、オープンソースの代替手段では対応が難しいエッジケース(破損したファイル、複雑な数式、大規模なデータセットなど)を適切に処理します。 開発速度と生産の信頼性を優先するチームにとって、IronXL の商用サポートは安心をもたらします。

Stack Overflow での議論によると、開発者は、.NET Core プロジェクトで Excel ライブラリを選択する際の決め手として、API のシンプルさとドキュメントの質を頻繁に挙げています。 .NET Foundation では、最新 for .NET開発の優先事項としてクロスプラットフォーム展開も重視しており、保守可能なソリューションには Office に依存しないライブラリが不可欠となっています。

セキュリティを重視するチーム向け: IronXL はMicrosoft Office から独立して動作し、Office Interop を回避するため、外部の脆弱性のリスクが最小限に抑えられます。 暗号化とパスワード保護の組み込みサポートにより、生成された Excel ファイルを保護し、許可されたユーザーのみが重要なワークシートやデータにアクセスしたり編集したりできるようにすることができます。 IronXL のライセンス オプションを確認して、チームに適したプランを見つけてください。

大規模なパフォーマンスをどのように処理しますか?

アプリケーションが多数の同時ユーザー向けに Excel ファイルを生成したり、大規模なデータセットを処理したりする場合は、パフォーマンス計画が重要になります。 IronXL は、Office プロセスや COM オブジェクトを生成せずに完全にメモリ内で動作するため、大規模なワークブックを効率的に処理します。 このアーキテクチャにより、CPU とメモリのオーバーヘッドが予測可能になります。

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

IronXLを使用して.NET Core Excel スプレッドシートを作成すると、これまでは依存関係の多いタスクだったものが、簡単な.NET操作に変わります。 基本的なセル操作から数式の計算や専門的な書式設定まで、このライブラリは、Windows サーバー、Linux コンテナー、クラウド プラットフォームなど、 .NET 10 が実行されるあらゆる場所で実行できるスプレッドシート自動化のための完全なツールキットを提供します。

クロスプラットフォームアーキテクチャにより、開発用マシンと実稼働環境で同一の動作が保証されるため、Office Interopソリューションにありがちな"私のマシンでは動作しない"という問題が発生しません。 NuGetインストール コマンドから開始し、最初のワークブックを作成し、そこからこのガイド全体に示されているパターンを使用して構築します。

30 日間の無料トライアルをダウンロードして、制限なしですべての機能を試すか、本番環境への展開のためのライセンス オプションを確認してください。 IronXL のコード例を参照して、実際に動作する追加のシナリオを確認し、完全な API リファレンスと高度な構成ガイドについてはIronXLドキュメント ハブを参照してください。