Excel をインストールせずに C# で Open Office Excel ファイルを読み取る方法

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

Install-Package IronXL.Excel

OpenOfficeまたはExcelファイルをC#でどうやってロードしますか？

IronXLでは、ODS、XLS、XLSX、CSVファイルをWorkBook.Loadメソッドを通じて同一に扱います。 絶対パスまたは相対パスを渡すと、ライブラリは拡張子だけでなく、ファイルヘッダーからファイル形式を検出します。 これは、.ods から .xlsx に名前を変更されたファイルが依然として正しく読み取られることを意味します。

using IronXL;

// Load an OpenDocument Spreadsheet (.ods) produced by LibreOffice Calc or OpenOffice
WorkBook workbook = WorkBook.Load("quarterly_report.ods");

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

// Read a cell value
string companyName = sheet["A1"].StringValue;
int recordCount   = sheet["B1"].IntValue;

Console.WriteLine($"Company : {companyName}");
Console.WriteLine($"Records : {recordCount}");

using IronXL;

// Load an OpenDocument Spreadsheet (.ods) produced by LibreOffice Calc or OpenOffice
WorkBook workbook = WorkBook.Load("quarterly_report.ods");

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

// Read a cell value
string companyName = sheet["A1"].StringValue;
int recordCount   = sheet["B1"].IntValue;

Console.WriteLine($"Company : {companyName}");
Console.WriteLine($"Records : {recordCount}");

Imports IronXL

' Load an OpenDocument Spreadsheet (.ods) produced by LibreOffice Calc or OpenOffice
Dim workbook As WorkBook = WorkBook.Load("quarterly_report.ods")

' Access the first worksheet by index
Dim sheet As WorkSheet = workbook.WorkSheets(0)

' Read a cell value
Dim companyName As String = sheet("A1").StringValue
Dim recordCount As Integer = sheet("B1").IntValue

Console.WriteLine($"Company : {companyName}")
Console.WriteLine($"Records : {recordCount}")

同じ呼び出し方法はXLSXファイルとXLSファイルにも有効です。パスを変更するだけで済みます。 WorkBook.Load は、ソースフォーマットに関係なく同じ強く型付けされたオブジェクトを返すので、ファイルがMicrosoft Excel、LibreOffice、またはその他のODF準拠のアプリケーションから送信された場合でも、残りのコードは同一のままです。

ワークシートの各行とセルをどのように読み取るのですか？

using IronXL;

WorkBook workbook  = WorkBook.Load("customers.xlsx");
WorkSheet worksheet = workbook.WorkSheets[0];

Console.WriteLine($"Total rows    : {worksheet.RowCount}");
Console.WriteLine($"Total columns : {worksheet.ColumnCount}");
Console.WriteLine();

foreach (var row in worksheet.Rows)
{
    foreach (var cell in row)
    {
        if (!cell.IsEmpty)
            Console.Write($"{cell.StringValue,-20}");
    }
    Console.WriteLine();
}

using IronXL;

WorkBook workbook  = WorkBook.Load("customers.xlsx");
WorkSheet worksheet = workbook.WorkSheets[0];

Console.WriteLine($"Total rows    : {worksheet.RowCount}");
Console.WriteLine($"Total columns : {worksheet.ColumnCount}");
Console.WriteLine();

foreach (var row in worksheet.Rows)
{
    foreach (var cell in row)
    {
        if (!cell.IsEmpty)
            Console.Write($"{cell.StringValue,-20}");
    }
    Console.WriteLine();
}

Imports IronXL

Dim workbook As WorkBook = WorkBook.Load("customers.xlsx")
Dim worksheet As WorkSheet = workbook.WorkSheets(0)

Console.WriteLine($"Total rows    : {worksheet.RowCount}")
Console.WriteLine($"Total columns : {worksheet.ColumnCount}")
Console.WriteLine()

For Each row In worksheet.Rows
    For Each cell In row
        If Not cell.IsEmpty Then
            Console.Write($"{cell.StringValue,-20}")
        End If
    Next
    Console.WriteLine()
Next

セルから入力された値を抽出するにはどうすればよいですか？

using IronXL;

WorkBook workbook = WorkBook.Load("inventory.xlsx");
WorkSheet sheet   = workbook.GetWorkSheet("Products");

// Typed accessors handle conversion automatically
string  productName = sheet["A2"].StringValue;
int     quantity    = sheet["B2"].IntValue;
decimal unitPrice   = sheet["C2"].DecimalValue;
bool    inStock     = sheet["D2"].BoolValue;
DateTime? lastAudit = sheet["E2"].DateTimeValue;

Console.WriteLine($"Product  : {productName}");
Console.WriteLine($"Qty      : {quantity}");
Console.WriteLine($"Price    : {unitPrice:C}");
Console.WriteLine($"In Stock : {inStock}");
Console.WriteLine($"Audited  : {lastAudit?.ToString("d") ?? "Never"}");

using IronXL;

WorkBook workbook = WorkBook.Load("inventory.xlsx");
WorkSheet sheet   = workbook.GetWorkSheet("Products");

// Typed accessors handle conversion automatically
string  productName = sheet["A2"].StringValue;
int     quantity    = sheet["B2"].IntValue;
decimal unitPrice   = sheet["C2"].DecimalValue;
bool    inStock     = sheet["D2"].BoolValue;
DateTime? lastAudit = sheet["E2"].DateTimeValue;

Console.WriteLine($"Product  : {productName}");
Console.WriteLine($"Qty      : {quantity}");
Console.WriteLine($"Price    : {unitPrice:C}");
Console.WriteLine($"In Stock : {inStock}");
Console.WriteLine($"Audited  : {lastAudit?.ToString("d") ?? "Never"}");

Imports IronXL

Dim workbook As WorkBook = WorkBook.Load("inventory.xlsx")
Dim sheet As WorkSheet = workbook.GetWorkSheet("Products")

' Typed accessors handle conversion automatically
Dim productName As String = sheet("A2").StringValue
Dim quantity As Integer = sheet("B2").IntValue
Dim unitPrice As Decimal = sheet("C2").DecimalValue
Dim inStock As Boolean = sheet("D2").BoolValue
Dim lastAudit As DateTime? = sheet("E2").DateTimeValue

Console.WriteLine($"Product  : {productName}")
Console.WriteLine($"Qty      : {quantity}")
Console.WriteLine($"Price    : {unitPrice:C}")
Console.WriteLine($"In Stock : {inStock}")
Console.WriteLine($"Audited  : {If(lastAudit?.ToString("d"), "Never")}")

複数の名前付きワークシートをどのように操作しますか？

using IronXL;

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

// Option 1: access by name (throws if the sheet does not exist)
WorkSheet januarySheet = workbook.GetWorkSheet("January");

// Option 2: iterate all sheets in the workbook
foreach (WorkSheet ws in workbook.WorkSheets)
{
    Console.WriteLine($"Sheet: {ws.Name}  |  Rows: {ws.RowCount}");

    // Read the header row from each sheet
    string header = ws["A1"].StringValue;
    Console.WriteLine($"  Header: {header}");
}

// Option 3: access by zero-based index
WorkSheet lastSheet = workbook.WorkSheets[workbook.WorkSheets.Count - 1];
Console.WriteLine($"Last sheet: {lastSheet.Name}");

using IronXL;

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

// Option 1: access by name (throws if the sheet does not exist)
WorkSheet januarySheet = workbook.GetWorkSheet("January");

// Option 2: iterate all sheets in the workbook
foreach (WorkSheet ws in workbook.WorkSheets)
{
    Console.WriteLine($"Sheet: {ws.Name}  |  Rows: {ws.RowCount}");

    // Read the header row from each sheet
    string header = ws["A1"].StringValue;
    Console.WriteLine($"  Header: {header}");
}

// Option 3: access by zero-based index
WorkSheet lastSheet = workbook.WorkSheets[workbook.WorkSheets.Count - 1];
Console.WriteLine($"Last sheet: {lastSheet.Name}");

Imports IronXL

Dim workbook As WorkBook = WorkBook.Load("annual_sales.xlsx")

' Option 1: access by name (throws if the sheet does not exist)
Dim januarySheet As WorkSheet = workbook.GetWorkSheet("January")

' Option 2: iterate all sheets in the workbook
For Each ws As WorkSheet In workbook.WorkSheets
    Console.WriteLine($"Sheet: {ws.Name}  |  Rows: {ws.RowCount}")

    ' Read the header row from each sheet
    Dim header As String = ws("A1").StringValue
    Console.WriteLine($"  Header: {header}")
Next

' Option 3: access by zero-based index
Dim lastSheet As WorkSheet = workbook.WorkSheets(workbook.WorkSheets.Count - 1)
Console.WriteLine($"Last sheet: {lastSheet.Name}")

結合されたセルと書式設定された領域はどのように処理しますか？

レポートやダッシュボードでは、見出し、グループ化されたラベル、および要約行に結合セルがよく使用されます。 IronXLは、結合領域の左上のセルから、Excelが表示するのと全く同じ値を読み取ります。

using IronXL;

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

// The merged region A1:D1 stores its value in cell A1
string reportTitle = sheet["A1"].StringValue;
Console.WriteLine($"Report title : {reportTitle}");

// Read cell formatting metadata
var titleCell = sheet["A1"];
Console.WriteLine($"Bold         : {titleCell.Style.Font.Bold}");
Console.WriteLine($"Font size    : {titleCell.Style.Font.Height}");

// Scan an entire column for non-empty section headers
foreach (var cell in sheet["A1:A100"])
{
    if (!cell.IsEmpty && cell.Style.Font.Bold)
        Console.WriteLine($"Section header at {cell.AddressString}: {cell.StringValue}");
}

using IronXL;

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

// The merged region A1:D1 stores its value in cell A1
string reportTitle = sheet["A1"].StringValue;
Console.WriteLine($"Report title : {reportTitle}");

// Read cell formatting metadata
var titleCell = sheet["A1"];
Console.WriteLine($"Bold         : {titleCell.Style.Font.Bold}");
Console.WriteLine($"Font size    : {titleCell.Style.Font.Height}");

// Scan an entire column for non-empty section headers
foreach (var cell in sheet["A1:A100"])
{
    if (!cell.IsEmpty && cell.Style.Font.Bold)
        Console.WriteLine($"Section header at {cell.AddressString}: {cell.StringValue}");
}

Imports IronXL

Dim workbook As WorkBook = WorkBook.Load("report_with_merges.xlsx")
Dim sheet As WorkSheet = workbook.DefaultWorkSheet

' The merged region A1:D1 stores its value in cell A1
Dim reportTitle As String = sheet("A1").StringValue
Console.WriteLine($"Report title : {reportTitle}")

' Read cell formatting metadata
Dim titleCell = sheet("A1")
Console.WriteLine($"Bold         : {titleCell.Style.Font.Bold}")
Console.WriteLine($"Font size    : {titleCell.Style.Font.Height}")

' Scan an entire column for non-empty section headers
For Each cell In sheet("A1:A100")
    If Not cell.IsEmpty AndAlso cell.Style.Font.Bold Then
        Console.WriteLine($"Section header at {cell.AddressString}: {cell.StringValue}")
    End If
Next

Style プロパティツリーは、OOXML SpreadsheetML 仕様の構造を反映しています。そのため、Open XML SDK を使用したことがある場合は、プロパティ名に馴染みがあるでしょう。 しかし、 IronXLはそうした複雑さをすべて、ユーザー側でXMLを操作する必要のない、クリーンなAPIに包み込んでいます。

同じAPIを使用してCSVファイルをインポートするにはどうすればよいですか？

データベースのエクスポート、CRMシステム、レガシーアプリケーションによって生成されたCSVファイルは、WorkBook.Load呼び出しを通じて同様に読み取ることができます。 IronXLはファイルの内容から区切り文字を推測します。

using IronXL;

// Load a comma-separated values file -- same method, same API
WorkBook csvWorkbook  = WorkBook.Load("export.csv");
WorkSheet csvSheet    = csvWorkbook.DefaultWorkSheet;

Console.WriteLine($"CSV rows loaded: {csvSheet.RowCount}");

// Process rows exactly like any other worksheet
foreach (var row in csvSheet.Rows)
{
    string id   = row[0].StringValue;
    string name = row[1].StringValue;
    Console.WriteLine($"{id,-10} {name}");
}

using IronXL;

// Load a comma-separated values file -- same method, same API
WorkBook csvWorkbook  = WorkBook.Load("export.csv");
WorkSheet csvSheet    = csvWorkbook.DefaultWorkSheet;

Console.WriteLine($"CSV rows loaded: {csvSheet.RowCount}");

// Process rows exactly like any other worksheet
foreach (var row in csvSheet.Rows)
{
    string id   = row[0].StringValue;
    string name = row[1].StringValue;
    Console.WriteLine($"{id,-10} {name}");
}

Imports IronXL

' Load a comma-separated values file -- same method, same API
Dim csvWorkbook As WorkBook = WorkBook.Load("export.csv")
Dim csvSheet As WorkSheet = csvWorkbook.DefaultWorkSheet

Console.WriteLine($"CSV rows loaded: {csvSheet.RowCount}")

' Process rows exactly like any other worksheet
For Each row In csvSheet.Rows
    Dim id As String = row(0).StringValue
    Dim name As String = row(1).StringValue
    Console.WriteLine($"{id,-10} {name}")
Next

読み込み後、csvWorkbook.SaveAs("output.xlsx")を使用してデータをXLSXとして節約できます。 これは、CSVからExcelへの変換パイプラインでよく見られるパターンです。CSVファイルを受け取り、計算列や書式設定を追加して内容を充実させ、書式設定されたXLSXレポートをユーザーに返します。

タブ区切りファイルやカスタム区切り文字の場合は、WorkBook.LoadCSV("file.tsv", fileFormat: ExcelFileFormat.TSV)を使用して形式を明示的に指定してください。

IronXLはMicrosoft.Office.Interop.Excelと比べてどうですか？

Excel処理をLinuxとDockerにデプロイするにはどうすればよいですか？

サーバー展開においてこそ、IronXLがExcelに依存しないことの真価が発揮される。 Windowsで書いたコードは、Ubuntu、Alpine Linux、macOSでもそのまま動作します。 コンテナ化されたデプロイメントの場合、Dockerfileに特別な設定は必要ありません。

# Standard .NET runtime image -- no Office packages needed
FROM mcr.microsoft.com/dotnet/runtime:10.0
WORKDIR /app
COPY --from=build /app/publish .
ENTRYPOINT ["dotnet", "ExcelProcessor.dll"]

# Standard .NET runtime image -- no Office packages needed
FROM mcr.microsoft.com/dotnet/runtime:10.0
WORKDIR /app
COPY --from=build /app/publish .
ENTRYPOINT ["dotnet", "ExcelProcessor.dll"]

Azure FunctionsとAWS Lambdaの場合、 IronXLは追加の設定なしでマネージドランタイム内で動作します。 COMの初期化手順がないため、コールドスタート時のオーバーヘッドは最小限です。

スレッドセーフ性が組み込まれています：複数のスレッドが異なるWorkBookインスタンスを同時に開くことができ、調整を必要としません。 ユーザーがアップロードしたスプレッドシートを取り込むバックグラウンドジョブなどで、数千のファイルを並行して処理する必要がある場合、Parallel.ForEach や Task.WhenAll を WorkBook インスタンスのプールで使用しても、破損のリスクはありません。

IronXLは初期化時にワークブック全体ではなく、要求されたワークシートのみをメモリに読み込むため、メモリ使用量は予測可能なままです。 非常に大きなファイルの場合、この違いは重要になります。例えば、50MBのシートが10枚含まれているワークブックでは、1枚のシートを読み込むためだけに500MBのRAMは必要ありません。 IronXLパフォーマンスドキュメントでは、高ボリュームのファイル処理シナリオを処理するための追加戦略について説明しています。

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

プロジェクトでIronXL を検証する最も簡単な方法は、 NuGetパッケージをインストールし、このガイドのサンプルを実際の環境にあるファイルに対して実行することです。 無料トライアルライセンスでは、本番環境への移行時にコード変更を一切必要とせず、すべての機能が利用可能になります。

ファイル読み取りを補完するIronXLの関連機能をご覧ください。

• C#でExcelファイルを作成および作成する --プログラム的にレポートとデータエクスポートを構築します
• セル、行、列のフォーマット --コードで色、フォント、境界線を適用します
• C#でExcelの数式を操作する --数式セルを読み書きします
• Excelを.NETでPDFに変換する --スプレッドシートデータからPDFレポートを生成します
• IronXL APIドキュメント-- すべてのクラスとメソッドの完全なリファレンス IronXLのライセンスと価格設定- 個人開発者向けおよびEnterpriseチーム向けのオプション
• IronXL NuGet ページ -- すべてのプロジェクトタイプ向けのインストール手順
• IronXLチュートリアル --一般的なユースケースのステップバイステップガイド
• IronXLをEPPlusと比較する --機能とライセンスの比較を横並びで行います IronXL製品ホーム- 機能概要と入門リソース

ライセンス、クロスプラットフォーム対応、または特定のファイル形式要件に関するご質問は、 IronXLサポートチームがライブチャットとメールで対応いたします。

今IronXLを始めましょう。

無料で始める