Microsoft Officeを使わずにC#でExcelファイルを開く方法

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

使い始めるのにかかる時間はほんの数秒です。 プロジェクトを開き、以下のいずれかのパッケージマネージャーを使用してください。

Install-Package IronXL
dotnet add package IronXL

Install-Package IronXL
dotnet add package IronXL

または、Visual Studio を開き、プロジェクトを右クリックして" NuGetパッケージの管理"を選択し、"IronXL"を検索して"インストール"をクリックします。 インストールガイドには、DockerやAzureを含む、サポートされているすべての環境に関する情報が記載されています。

インストールが完了したら、ファイルの先頭に名前空間を追加してください。

using IronXL;

using IronXL;

必要なのはその一行だけです。 複雑なCOM参照、Officeへの依存関係、バージョン固有のアセンブリは一切ありません。 無料の評価キーを入手するには、 IronXLのトライアルライセンスページをご覧ください。

Excelワークブックを開いてセルの値を読み取るにはどうすればよいですか？

コアとなるAPIはシンプルです。 ワークブックを読み込み、ワークシートを選択し、アドレスまたは反復処理によってセルにアクセスします。

using IronXL;

// Load any Excel file -- XLSX, XLS, CSV, or TSV
WorkBook workbook = WorkBook.Load("example.xlsx");

// Access the second worksheet (zero-indexed)
WorkSheet worksheet = workbook.WorkSheets[1];

// Read a specific cell value
decimal revenue = worksheet["E2"].DecimalValue;
Console.WriteLine($"Order Total: {revenue}");

// Iterate over a range of cells
foreach (var cell in worksheet["C2:C6"])
{
    Console.WriteLine($"Product: {cell.Text}");
}

using IronXL;

// Load any Excel file -- XLSX, XLS, CSV, or TSV
WorkBook workbook = WorkBook.Load("example.xlsx");

// Access the second worksheet (zero-indexed)
WorkSheet worksheet = workbook.WorkSheets[1];

// Read a specific cell value
decimal revenue = worksheet["E2"].DecimalValue;
Console.WriteLine($"Order Total: {revenue}");

// Iterate over a range of cells
foreach (var cell in worksheet["C2:C6"])
{
    Console.WriteLine($"Product: {cell.Text}");
}

WorkBook.Load() ファイル形式は自動的に検出されます。ファイルが XLS か XLSX かを指定する必要はありません。 workbook.GetWorkSheet("Sheet1") を使用して、インデックスまたは名前でワークシートにアクセスします。 各セルは、Textなどの型付きプロパティを公開します。

ファイルを開くためのその他のオプションについては、 "ワークブックを開く方法"ガイドを参照してください。

using IronXL;

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

// Access worksheet by exact name
WorkSheet salesSheet = workbook.GetWorkSheet("Sales Data");
Console.WriteLine($"Sales sheet rows: {salesSheet.RowCount}");

// Iterate all worksheets in the workbook
foreach (WorkSheet sheet in workbook.WorkSheets)
{
    if (sheet.Name.Contains("Inventory"))
    {
        Console.WriteLine($"Found inventory sheet: {sheet.Name}");
    }
}

using IronXL;

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

// Access worksheet by exact name
WorkSheet salesSheet = workbook.GetWorkSheet("Sales Data");
Console.WriteLine($"Sales sheet rows: {salesSheet.RowCount}");

// Iterate all worksheets in the workbook
foreach (WorkSheet sheet in workbook.WorkSheets)
{
    if (sheet.Name.Contains("Inventory"))
    {
        Console.WriteLine($"Found inventory sheet: {sheet.Name}");
    }
}

Excelのセルから様々なデータ型を読み取るにはどうすればよいですか？

IronXLは、一般的なExcelデータ型すべてに対応する型付きアクセサーを提供します。 文字列、整数、小数、日付、ブール値、数式の結果を、手動で解析することなく読み込むことができます。

using IronXL;

WorkBook wb = WorkBook.Load(@"C:\Data\Inventory.xlsx");
WorkSheet ws = wb.GetWorkSheet("Products");

// Read different data types directly
string productName = ws["A2"].StringValue;
int quantity       = ws["B2"].IntValue;
decimal price      = ws["C2"].DecimalValue;
DateTime updated   = ws["D2"].DateTimeValue;

// Use aggregate functions on ranges for performance
decimal totalStock = ws["B2:B100"].Sum();
decimal maxPrice   = ws["C2:C100"].Max();

Console.WriteLine($"Product: {productName}, Qty: {quantity}, Price: {price:C}");
Console.WriteLine($"Total stock units: {totalStock}, Highest price: {maxPrice:C}");

using IronXL;

WorkBook wb = WorkBook.Load(@"C:\Data\Inventory.xlsx");
WorkSheet ws = wb.GetWorkSheet("Products");

// Read different data types directly
string productName = ws["A2"].StringValue;
int quantity       = ws["B2"].IntValue;
decimal price      = ws["C2"].DecimalValue;
DateTime updated   = ws["D2"].DateTimeValue;

// Use aggregate functions on ranges for performance
decimal totalStock = ws["B2:B100"].Sum();
decimal maxPrice   = ws["C2:C100"].Max();

Console.WriteLine($"Product: {productName}, Qty: {quantity}, Price: {price:C}");
Console.WriteLine($"Total stock units: {totalStock}, Highest price: {maxPrice:C}");

以下の表は、利用可能な型付きアクセサーをまとめたものです。

セルデータの読み書きに関する詳細については、セル書式設定ガイドおよびデータインポート方法ガイドを参照してください。

using IronXL;

WorkBook workbook = WorkBook.Load("data.xlsx");
WorkSheet ws = workbook.DefaultWorkSheet;

// Check if a cell is empty before reading
if (!ws["A1"].IsEmpty)
{
    Console.WriteLine(ws["A1"].StringValue);
}

// Provide a fallback value using a null-coalescing pattern
string cellText = ws["A1"].StringValue ?? "Default Value";

// Iterate a range and skip empty cells
foreach (var cell in ws["A1:A20"])
{
    if (!cell.IsEmpty)
    {
        Console.WriteLine(cell.Text);
    }
}

using IronXL;

WorkBook workbook = WorkBook.Load("data.xlsx");
WorkSheet ws = workbook.DefaultWorkSheet;

// Check if a cell is empty before reading
if (!ws["A1"].IsEmpty)
{
    Console.WriteLine(ws["A1"].StringValue);
}

// Provide a fallback value using a null-coalescing pattern
string cellText = ws["A1"].StringValue ?? "Default Value";

// Iterate a range and skip empty cells
foreach (var cell in ws["A1:A20"])
{
    if (!cell.IsEmpty)
    {
        Console.WriteLine(cell.Text);
    }
}

実運用可能なExcelリーダーを構築するにはどうすればよいでしょうか？

実用的なExcelリーダーには、ファイル検証、エラー処理、複数シートのサポート、およびオプションの出力生成機能が必要です。 次の例は、これらのパターンすべてを単一のクラスで示しています。

using IronXL;
using System.IO;

// Validate and load the file
static List<string> CheckLowStock(string filePath)
{
    var lowStockItems = new List<string>();

    if (!File.Exists(filePath))
    {
        Console.WriteLine($"File not found: {filePath}");
        return lowStockItems;
    }

    string ext = Path.GetExtension(filePath).ToLower();
    if (ext is not (".xlsx" or ".xls" or ".csv"))
    {
        Console.WriteLine($"Unsupported file type: {ext}");
        return lowStockItems;
    }

    try
    {
        WorkBook workbook = WorkBook.Load(filePath);

        foreach (WorkSheet sheet in workbook.WorkSheets)
        {
            Console.WriteLine($"Checking sheet: {sheet.Name}");

            for (int row = 2; row <= sheet.RowCount; row++)
            {
                string itemName  = sheet[$"A{row}"].StringValue;
                int stockLevel   = sheet[$"B{row}"].IntValue;

                if (stockLevel < 10 && !string.IsNullOrEmpty(itemName))
                {
                    lowStockItems.Add($"{itemName} -- {stockLevel} units ({sheet.Name})");
                }
            }
        }
    }
    catch (Exception ex)
    {
        Console.WriteLine($"Error reading Excel file: {ex.Message}");
    }

    return lowStockItems;
}

// Export results to a new workbook
static void ExportReport(List<string> items, string outputPath)
{
    WorkBook report     = WorkBook.Create();
    WorkSheet sheet     = report.CreateWorkSheet("Low Stock Report");

    sheet["A1"].Value   = "Item Description";
    sheet["B1"].Value   = "Source Sheet";

    sheet["A1:B1"].Style.Font.Bold        = true;
    sheet["A1:B1"].Style.BackgroundColor  = "#4472C4";
    sheet["A1:B1"].Style.Font.Color       = "#FFFFFF";

    int rowIndex = 2;
    foreach (string item in items)
    {
        sheet[$"A{rowIndex}"].Value = item;
        rowIndex++;
    }

    report.SaveAs(outputPath);
    Console.WriteLine($"Report saved to: {outputPath}");
}

// Run
var lowStockItems = CheckLowStock("inventory.xlsx");
ExportReport(lowStockItems, "low-stock-report.xlsx");

using IronXL;
using System.IO;

// Validate and load the file
static List<string> CheckLowStock(string filePath)
{
    var lowStockItems = new List<string>();

    if (!File.Exists(filePath))
    {
        Console.WriteLine($"File not found: {filePath}");
        return lowStockItems;
    }

    string ext = Path.GetExtension(filePath).ToLower();
    if (ext is not (".xlsx" or ".xls" or ".csv"))
    {
        Console.WriteLine($"Unsupported file type: {ext}");
        return lowStockItems;
    }

    try
    {
        WorkBook workbook = WorkBook.Load(filePath);

        foreach (WorkSheet sheet in workbook.WorkSheets)
        {
            Console.WriteLine($"Checking sheet: {sheet.Name}");

            for (int row = 2; row <= sheet.RowCount; row++)
            {
                string itemName  = sheet[$"A{row}"].StringValue;
                int stockLevel   = sheet[$"B{row}"].IntValue;

                if (stockLevel < 10 && !string.IsNullOrEmpty(itemName))
                {
                    lowStockItems.Add($"{itemName} -- {stockLevel} units ({sheet.Name})");
                }
            }
        }
    }
    catch (Exception ex)
    {
        Console.WriteLine($"Error reading Excel file: {ex.Message}");
    }

    return lowStockItems;
}

// Export results to a new workbook
static void ExportReport(List<string> items, string outputPath)
{
    WorkBook report     = WorkBook.Create();
    WorkSheet sheet     = report.CreateWorkSheet("Low Stock Report");

    sheet["A1"].Value   = "Item Description";
    sheet["B1"].Value   = "Source Sheet";

    sheet["A1:B1"].Style.Font.Bold        = true;
    sheet["A1:B1"].Style.BackgroundColor  = "#4472C4";
    sheet["A1:B1"].Style.Font.Color       = "#FFFFFF";

    int rowIndex = 2;
    foreach (string item in items)
    {
        sheet[$"A{rowIndex}"].Value = item;
        rowIndex++;
    }

    report.SaveAs(outputPath);
    Console.WriteLine($"Report saved to: {outputPath}");
}

// Run
var lowStockItems = CheckLowStock("inventory.xlsx");
ExportReport(lowStockItems, "low-stock-report.xlsx");

この例ではトップレベルのステートメントを使用し、ファイルパスと拡張子の検証、ワークブックの読み込み、すべてのワークシートの反復処理、ビジネスロジックの適用、結果の新規ファイルへの書き込みといったワークフロー全体を網羅しています。ワークブックの書き込みと保存の詳細については、 "Excel ファイル書き込みガイド"および"Excel エクスポート方法"を参照してください。

ExportReport メソッドは、ソース ファイルを変更するのではなく、WorkBook.Create() を使用して新しいワークブックを作成することに注意してください。ソース ファイルと出力 ファイルを分離しておくことは、監査証跡の維持に役立ち、他のプロセスが依存するデータを誤って上書きしてしまうことを防ぐ良い方法です。 既存のワークブックにデータを追加する必要がある場合は、WorkBook.Load() を使用してワークブックを読み込み、適切なワークシートに行を追加し、SaveAs() を呼び出して新しいパスを指定するか、その場で上書きします。

using IronXL;

WorkBook workbook = WorkBook.Load("large-dataset.xlsx");
WorkSheet ws      = workbook.DefaultWorkSheet;

// Fast: aggregate functions operate on the range directly
decimal total   = ws["B2:B5000"].Sum();
decimal average = ws["B2:B5000"].Avg();
int count       = ws["B2:B5000"].Count();

Console.WriteLine($"Total: {total:C}, Average: {average:C}, Rows: {count}");

// Export the worksheet to a DataSet for LINQ or database operations
var dataSet = workbook.ToDataSet();
Console.WriteLine($"DataSet tables: {dataSet.Tables.Count}");

using IronXL;

WorkBook workbook = WorkBook.Load("large-dataset.xlsx");
WorkSheet ws      = workbook.DefaultWorkSheet;

// Fast: aggregate functions operate on the range directly
decimal total   = ws["B2:B5000"].Sum();
decimal average = ws["B2:B5000"].Avg();
int count       = ws["B2:B5000"].Count();

Console.WriteLine($"Total: {total:C}, Average: {average:C}, Rows: {count}");

// Export the worksheet to a DataSet for LINQ or database operations
var dataSet = workbook.ToDataSet();
Console.WriteLine($"DataSet tables: {dataSet.Tables.Count}");

ライセンスを取得して本番環境にデプロイするにはどうすればよいですか？

IronXLは商用ライブラリであり、開発およびテスト中にすべての機能を利用できる無料トライアル版が用意されています。 本番環境への導入には、有効なライセンスキーが必要です。 開発者向け、チーム向け、Enterprise向けなど、ライセンス階層の詳細については、 IronXLのライセンスページをご覧ください。

ライセンスキーを適用するには、 IronXLの呼び出しを行う前に設定してください。

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

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

IronXLの機能概要では、ファイルの読み書きからグラフの作成、条件付き書式の適用、名前付き範囲の操作まで、すべての機能をまとめています。 Excelファイルの作成ガイドとセルの結合方法に関する説明は、新しいワークブックを作成する際の便利な出発点となります。

C# による Excel 自動化に関するコミュニティでの議論や質問については、 Microsoft の Q&A フォーラムやStack Overflowが役立つリソースです。 NuGetの公式パッケージページには、バージョン履歴とダウンロード統計情報が掲載されています。

C#でExcelファイルを開く際の重要なポイントは何ですか？

IronXLはMicrosoft Officeへの依存を完全に排除するため、サーバー上、コンテナ内、クラウド機能上でExcelファイルを処理することが実用的になります。 APIはシンプルなパターンに従います。ワークブックを読み込み、名前またはインデックスでワークシートにアクセスし、型付きアクセサーを使用してセルを読み取ります。 Max() のような集計関数は、手動で反復処理を行うオーバーヘッドなしに、大規模なデータセットを処理します。

このライブラリは、XLSX、XLS、CSV、TSV形式をサポートし、 .NET 10およびすべての最新の .NETバージョンで動作し、クロスプラットフォームに対応しています。 IronXLは標準的な.NET例外をスローするため、エラー処理は簡単です。これらの例外は、おなじみのtry/catchパターンでキャッチできます。COM相互運用エラーコードを解読する必要はありません。 利用可能なすべてのオプションを確認するには、まずIronXLのドキュメントホームを参照するか、ステップバイステップの手順が記載されたオープンワークブックのハウツーガイドをお試しください。

IronXLの無料トライアルを開始して、ご自身のプロジェクトでライブラリを評価してみてはいかがでしょうか。一切の義務は発生しません。

今IronXLを始めましょう。

無料で始める