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

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

Install-Package IronXL
dotnet add package IronXL

Install-Package IronXL
dotnet add package IronXL

C# で OpenOffice または Excel ファイルを読み込むにはどうすればよいでしょうか?

IronXL は、WorkBook.Load メソッドを通じて、ODS、XLS、XLSX、および CSV ファイルを同一に処理します。 絶対または相対ファイル パスを渡すと、ライブラリは拡張子だけでなくファイル ヘッダーから形式を検出します。 つまり、.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}");

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();
}

セルから入力された値をどのように抽出しますか?

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"}");

複数の名前付きワークシートを操作するにはどうすればよいでしょうか?

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}");

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

レポートやダッシュボードでは、見出し、グループ化されたラベル、要約行に結合セルが頻繁に使用されます。 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}");
}

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

同じ 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}");
}

ロード後、csvWorkbook.SaveAs("output.xlsx") を使用してデータを XLSX として保存できます。 これは、CSV から Excel への変換パイプラインの一般的なパターンです。CSV ファイルを受け取り、計算された列や書式設定でそれを拡充し、フォーマットされた XLSX レポートをユーザーに返します。

タブ区切りファイルまたはカスタム区切り文字の場合は、WorkBook.LoadCSV("file.tsv", file形式: ExcelFile形式.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 を使用できます。

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

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

プロジェクトでIronXL を検証する最も簡単な方法は、 NuGetパッケージをインストールし、このガイドの例を環境の実際のファイルに対して実行することです。 無料の試用ライセンスでは、実稼働の準備ができたときにコードを変更することなくすべての機能がロック解除されます。

ファイルの読み取りを補完する関連IronXL機能を調べます。

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

ライセンス、クロスプラットフォーム サポート、または特定のファイル形式の要件に関する質問については、ライブ チャットと電子メールでIronXLサポート チームにお問い合わせください。

今IronXLを始めましょう。

無料で始める