IronXLを使って C# で Excel ファイルを開く方法

Microsoft.Office.Interop.ExcelよりIronXLを選ぶ理由

Microsoft.Office.Interop.ExcelはExcelの自動化における従来の手法でしたが、重大な制約があるため、最新のアプリケーションにはIronXLの方が適しています。 マイクロソフト自身も、不安定性、拡張性の問題、およびサポートされていない展開シナリオを理由に、サーバー上でのOffice Interopの使用を推奨していません。

IronXLはMicrosoft Excelへの依存を排除​​するため、サーバー環境、 Dockerコンテナ、 Azureなどのクラウドプラットフォームに最適です。 このライブラリは、COMオブジェクトや手動によるメモリ管理を不要にする、クリーンでモダンなAPIを提供します。 IronXLはファイルを開くだけでなく、数式の評価からグラフの生成、セルのスタイル設定まで、あらゆる処理を行います。

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

IronXLの利用開始は簡単です。NuGetパッケージマネージャーを使えば、数分でプロジェクトに追加できます。 Visual StudioでPackage Manager Consoleを開き、実行してください：

Install-Package IronXL
dotnet add package IronXL

Install-Package IronXL
dotnet add package IronXL

どちらのコマンドも同じパッケージをインストールします。 1つ目はVisual Studioパッケージマネージャーコンソールで使用し、2つ目は.NET CLIで使用してください。 インストール後、プロジェクトファイル内の <PackageReference Include="IronXl.Excel" /> の下にパッケージ参照が表示されることを確認できます。

今IronXLを始めましょう。

無料で始める

C#で既存のExcelファイルを開いて読み込むにはどうすればよいですか？

IronXLを使用して既存のExcelファイルを開くには、コードがほんの数行必要です。 このライブラリは、統一されたAPIを通じて、XLSファイルとXLSXファイルに加え、CSV形式とTSV形式のファイルの読み込みをサポートしています。 以下の例は、基本的なワークフローを示しています。

// Load an existing Excel file
WorkBook workbook = WorkBook.Load("sales-data.xlsx");

// Access the first worksheet by index
WorkSheet sheet = workbook.WorkSheets[0];

// Or access a worksheet by name
WorkSheet namedSheet = workbook.GetWorkSheet("January Sales");

// Read a specific cell value
string cellValue = sheet["A1"].StringValue;
Console.WriteLine($"Cell A1 contains: {cellValue}");

// Read a numeric value
decimal revenue = sheet["B2"].DecimalValue;
Console.WriteLine($"Revenue: {revenue:C}");

// Check cell data type before reading
var cell = sheet["C3"];
Console.WriteLine($"Type: {cell.Type}, Value: {cell.Value}");

// Load an existing Excel file
WorkBook workbook = WorkBook.Load("sales-data.xlsx");

// Access the first worksheet by index
WorkSheet sheet = workbook.WorkSheets[0];

// Or access a worksheet by name
WorkSheet namedSheet = workbook.GetWorkSheet("January Sales");

// Read a specific cell value
string cellValue = sheet["A1"].StringValue;
Console.WriteLine($"Cell A1 contains: {cellValue}");

// Read a numeric value
decimal revenue = sheet["B2"].DecimalValue;
Console.WriteLine($"Revenue: {revenue:C}");

// Check cell data type before reading
var cell = sheet["C3"];
Console.WriteLine($"Type: {cell.Type}, Value: {cell.Value}");

WorkBook.Load() メソッドは、ファイル形式 (XLS、XLSX、CSV、または TSV) を自動的に検出し、追加の設定なしで解析を処理します。 ワークシートには、インデックスを使用して workbook.WorkSheets[0] でアクセスするか、名前を使用して GetWorkSheet() でアクセスします。 個々のセル値は角括弧表記(sheet["A1"])で読み取ることができ、コードを簡潔かつ分かりやすく記述できます。サポートされているファイル形式の完全なリストについては、 SpreadsheetML の Open XML SDK ドキュメントおよびIronXL NuGetパッケージのページを参照してください。

型付きアクセスの場合、 IronXLは .BoolValue、および .DateTimeValue のようなプロパティをセルに直接公開します。 これにより、汎用オブジェクトベースAPIでよく発生する型推測が不要になります。より複雑なシナリオについては、 Excel範囲の操作ガイドとセルデータ形式のドキュメントを参照してください。

// Load from a byte array (e.g., from a database or HTTP response)
byte[] fileBytes = File.ReadAllBytes("sales-data.xlsx");
WorkBook workbookFromBytes = WorkBook.Load(fileBytes);

// Load from a MemoryStream
using var memStream = new MemoryStream(fileBytes);
WorkBook workbookFromStream = WorkBook.Load(memStream);

// Access data the same way regardless of source
WorkSheet sheet = workbookFromStream.DefaultWorkSheet;
Console.WriteLine(sheet["A1"].StringValue);

// Load from a byte array (e.g., from a database or HTTP response)
byte[] fileBytes = File.ReadAllBytes("sales-data.xlsx");
WorkBook workbookFromBytes = WorkBook.Load(fileBytes);

// Load from a MemoryStream
using var memStream = new MemoryStream(fileBytes);
WorkBook workbookFromStream = WorkBook.Load(memStream);

// Access data the same way regardless of source
WorkSheet sheet = workbookFromStream.DefaultWorkSheet;
Console.WriteLine(sheet["A1"].StringValue);

C#で新しいExcelワークブックを作成するにはどうすればよいですか？

IronXLの表計算ソフトを使えば、新しいExcelファイルの作成も同様に簡単です。 以下の例は、書式設定された四半期報告書を作成するものです。

// Create a new workbook in XLSX format
WorkBook workbook = WorkBook.Create(ExcelFileFormat.XLSX);

// Add metadata
workbook.Metadata.Author = "Sales Department";
workbook.Metadata.Title = "Q1 Revenue Report";

// Create a named worksheet
WorkSheet sheet = workbook.CreateWorkSheet("Q1 Report");

// Add header row
sheet["A1"].Value = "Product";
sheet["B1"].Value = "Units Sold";
sheet["C1"].Value = "Revenue";

// Add data rows
sheet["A2"].Value = "Software Licenses";
sheet["B2"].Value = 120;
sheet["C2"].Value = 45000;

sheet["A3"].Value = "Support Contracts";
sheet["B3"].Value = 55;
sheet["C3"].Value = 27500;

// Add a SUM formula
sheet["C4"].Formula = "=SUM(C2:C3)";

// Apply number formatting
sheet["C2:C4"].FormatString = "$#,##0.00";

// Save the workbook to disk
workbook.SaveAs("quarterly-report.xlsx");
Console.WriteLine("Workbook saved successfully.");

// Create a new workbook in XLSX format
WorkBook workbook = WorkBook.Create(ExcelFileFormat.XLSX);

// Add metadata
workbook.Metadata.Author = "Sales Department";
workbook.Metadata.Title = "Q1 Revenue Report";

// Create a named worksheet
WorkSheet sheet = workbook.CreateWorkSheet("Q1 Report");

// Add header row
sheet["A1"].Value = "Product";
sheet["B1"].Value = "Units Sold";
sheet["C1"].Value = "Revenue";

// Add data rows
sheet["A2"].Value = "Software Licenses";
sheet["B2"].Value = 120;
sheet["C2"].Value = 45000;

sheet["A3"].Value = "Support Contracts";
sheet["B3"].Value = 55;
sheet["C3"].Value = 27500;

// Add a SUM formula
sheet["C4"].Formula = "=SUM(C2:C3)";

// Apply number formatting
sheet["C2:C4"].FormatString = "$#,##0.00";

// Save the workbook to disk
workbook.SaveAs("quarterly-report.xlsx");
Console.WriteLine("Workbook saved successfully.");

WorkBook.Create() メソッドは、指定された形式で新しいワークブックを初期化します。 CreateWorkSheet() を使用して複数のワークシートを追加したり、文字列、数値、ブール値、日付などのさまざまなデータ型でセルにデータを入力したり、Formula プロパティを介してExcel の数式を直接適用したりできます。 このライブラリは、データ型の変換やExcel固有の書式設定要件を自動的に処理します。

ヘッダーのスタイル設定や境界線の追加には、セルのスタイル設定APIを使用してください。 テンプレートベースのレポート生成については、 "既存のExcelテンプレートからのエクスポート"ガイドを参照してください。

Excelワークシートのデータをまとめて読み込んで処理するにはどうすればよいですか？

IronXLは、範囲ベースの操作とDataTable変換を通じて、データ抽出と一括処理を効率的に処理します。

// Load a workbook and select the default sheet
WorkBook workbook = WorkBook.Load("inventory.xlsx");
WorkSheet sheet = workbook.DefaultWorkSheet;

// Read a rectangular range of cells
var range = sheet["A1:D10"];
foreach (var cell in range)
{
    Console.WriteLine($"{cell.AddressString}: {cell.Text}");
}

// Convert the worksheet to a DataTable for database integration
System.Data.DataTable dataTable = sheet.ToDataTable(useFirstRowAsColumnHeaders: true);
Console.WriteLine($"Rows: {dataTable.Rows.Count}, Columns: {dataTable.Columns.Count}");

// Use aggregate functions directly on a range
decimal total = sheet["C2:C10"].Sum();
decimal average = sheet["C2:C10"].Avg();
decimal maxValue = sheet["C2:C10"].Max();

Console.WriteLine($"Total: {total:C}");
Console.WriteLine($"Average: {average:C}");
Console.WriteLine($"Max: {maxValue:C}");

// Filter and find rows using LINQ on the DataTable
var highValue = dataTable.AsEnumerable()
    .Where(row => row.Field<decimal>("Revenue") > 10000)
    .ToList();
Console.WriteLine($"High-value rows: {highValue.Count}");

// Load a workbook and select the default sheet
WorkBook workbook = WorkBook.Load("inventory.xlsx");
WorkSheet sheet = workbook.DefaultWorkSheet;

// Read a rectangular range of cells
var range = sheet["A1:D10"];
foreach (var cell in range)
{
    Console.WriteLine($"{cell.AddressString}: {cell.Text}");
}

// Convert the worksheet to a DataTable for database integration
System.Data.DataTable dataTable = sheet.ToDataTable(useFirstRowAsColumnHeaders: true);
Console.WriteLine($"Rows: {dataTable.Rows.Count}, Columns: {dataTable.Columns.Count}");

// Use aggregate functions directly on a range
decimal total = sheet["C2:C10"].Sum();
decimal average = sheet["C2:C10"].Avg();
decimal maxValue = sheet["C2:C10"].Max();

Console.WriteLine($"Total: {total:C}");
Console.WriteLine($"Average: {average:C}");
Console.WriteLine($"Max: {maxValue:C}");

// Filter and find rows using LINQ on the DataTable
var highValue = dataTable.AsEnumerable()
    .Where(row => row.Field<decimal>("Revenue") > 10000)
    .ToList();
Console.WriteLine($"High-value rows: {highValue.Count}");

範囲選択構文(sheet["A1:D10"])を使用すると、複数のセルを一度に操作するための洗練された方法が得られます。 ToDataTable() メソッドは、ワークシート データを System.Data.DataTable に変換します。これは、Entity Framework、データ バインディング コントロール、および SQL 一括コピー操作と直接統合されます。 IronXL は、範囲に対して集計関数-- Max()、および Min() -- を直接サポートしており、手動で反復コードを記述する必要がなくなります。

非常に大規模なデータセットを効率的に処理するには、ストリーミング処理とチャンク処理のパターンに関するIronXL APIリファレンス全文を参照してください。

WorkBook workbook = WorkBook.Load("products.xlsx");
WorkSheet sheet = workbook.DefaultWorkSheet;

// Get total row and column counts
int rowCount = sheet.RowCount;
int colCount = sheet.ColumnCount;

Console.WriteLine($"Sheet dimensions: {rowCount} rows x {colCount} columns");

// Iterate over all rows and columns
for (int row = 1; row <= rowCount; row++)
{
    for (int col = 1; col <= colCount; col++)
    {
        var cell = sheet.GetCellAt(row, col);
        if (cell != null && !string.IsNullOrEmpty(cell.Text))
        {
            Console.WriteLine($"[{row},{col}] = {cell.Text}");
        }
    }
}

// Find the first cell containing specific text
var searchResult = sheet["A1:Z100"]
    .FirstOrDefault(c => c.StringValue.Contains("discontinued", StringComparison.OrdinalIgnoreCase));

if (searchResult != null)
{
    Console.WriteLine($"Found 'discontinued' at: {searchResult.AddressString}");
}

WorkBook workbook = WorkBook.Load("products.xlsx");
WorkSheet sheet = workbook.DefaultWorkSheet;

// Get total row and column counts
int rowCount = sheet.RowCount;
int colCount = sheet.ColumnCount;

Console.WriteLine($"Sheet dimensions: {rowCount} rows x {colCount} columns");

// Iterate over all rows and columns
for (int row = 1; row <= rowCount; row++)
{
    for (int col = 1; col <= colCount; col++)
    {
        var cell = sheet.GetCellAt(row, col);
        if (cell != null && !string.IsNullOrEmpty(cell.Text))
        {
            Console.WriteLine($"[{row},{col}] = {cell.Text}");
        }
    }
}

// Find the first cell containing specific text
var searchResult = sheet["A1:Z100"]
    .FirstOrDefault(c => c.StringValue.Contains("discontinued", StringComparison.OrdinalIgnoreCase));

if (searchResult != null)
{
    Console.WriteLine($"Found 'discontinued' at: {searchResult.AddressString}");
}

このアプローチはどのような導入シナリオに対応していますか？

IronXLを使用する最も実用的な利点の1つは、システム上のどこにもMicrosoft Officeがインストールされていなくても動作できることです。 これにより、相互運用性に基づくソリューションでは到底実現できない、導入の柔軟性が生まれます。

基本的な読み書き操作以外に、一般的なExcel操作をどのようにこなせばよいですか？

細胞の読み書きは、あくまで基礎に過ぎない。 実際のExcel自動化には、一般的に書式設定、数式、ワークシート管理、および書式変換が含まれます。

WorkBook workbook = WorkBook.Load("report.xlsx");
WorkSheet sheet = workbook.DefaultWorkSheet;

// Apply bold, font size, and background color to header row
var headerRange = sheet["A1:F1"];
headerRange.Style.Font.Bold = true;
headerRange.Style.Font.Height = 12;
headerRange.Style.SetBackgroundColor("#4472C4");
headerRange.Style.Font.Color = "#FFFFFF";
headerRange.Style.HorizontalAlignment = IronXl.Styles.HorizontalAlignment.Center;

// Format a currency column
sheet["D2:D100"].FormatString = "$#,##0.00";

// Apply a date format
sheet["E2:E100"].FormatString = "yyyy-MM-dd";

// Add borders to a data range
var dataRange = sheet["A1:F20"];
dataRange.Style.Border.Bottom.Type = IronXl.Styles.BorderType.Thin;
dataRange.Style.Border.Right.Type = IronXl.Styles.BorderType.Thin;

workbook.SaveAs("formatted-report.xlsx");

WorkBook workbook = WorkBook.Load("report.xlsx");
WorkSheet sheet = workbook.DefaultWorkSheet;

// Apply bold, font size, and background color to header row
var headerRange = sheet["A1:F1"];
headerRange.Style.Font.Bold = true;
headerRange.Style.Font.Height = 12;
headerRange.Style.SetBackgroundColor("#4472C4");
headerRange.Style.Font.Color = "#FFFFFF";
headerRange.Style.HorizontalAlignment = IronXl.Styles.HorizontalAlignment.Center;

// Format a currency column
sheet["D2:D100"].FormatString = "$#,##0.00";

// Apply a date format
sheet["E2:E100"].FormatString = "yyyy-MM-dd";

// Add borders to a data range
var dataRange = sheet["A1:F20"];
dataRange.Style.Border.Bottom.Type = IronXl.Styles.BorderType.Thin;
dataRange.Style.Border.Right.Type = IronXl.Styles.BorderType.Thin;

workbook.SaveAs("formatted-report.xlsx");

// Load a CSV file and save as XLSX
WorkBook csvBook = WorkBook.Load("data-import.csv");
csvBook.SaveAs("data-import.xlsx");

// Load an XLSX file and export as CSV
WorkBook xlsxBook = WorkBook.Load("report.xlsx");
xlsxBook.DefaultWorkSheet.SaveAsCsv("report.csv");

// Load a CSV file and save as XLSX
WorkBook csvBook = WorkBook.Load("data-import.csv");
csvBook.SaveAs("data-import.xlsx");

// Load an XLSX file and export as CSV
WorkBook xlsxBook = WorkBook.Load("report.xlsx");
xlsxBook.DefaultWorkSheet.SaveAsCsv("report.csv");

無料トライアルを始めるにはどうすればよいですか？

IronXLは、購入を決定する前に全機能を試用できる無料の開発ライセンス付きでダウンロード可能です。 試用期間中は機能制限はありません。本番環境で使用されているライブラリと同じものを評価できます。

開始するには:

1. NuGet経由でパッケージをインストールします。

   dotnet add package IronXL

   dotnet add package IronXL

   SHELL
2. IronXLのライセンスページにアクセスして、無料トライアルキーを入手してください。
3. IronXLの呼び出しを行う前に、コード内でキーを適用します。

   IronXl.License.LicenseKey = "YOUR-LICENSE-KEY-HERE";

   IronXl.License.LicenseKey = "YOUR-LICENSE-KEY-HERE";

   $vbLabelText   $csharpLabel

ライセンスは、個人開発者、チーム、組織向けに提供されています。 IronXLの製品ページには、価格の詳細や導入オプション（ロイヤリティフリーの配布権を含む）がすべて記載されています。 Iron Softwareの全製品とその連携方法についてより詳しく知りたい場合は、 Iron Software製品Suiteをご覧ください。