Interopを使わずにC#でExcelファイルを読み取る方法: 完全な開発者ガイド

Jacob Mellor、Ironチームの最高技術責任者(CTO)
Jacob Mellor
更新日: 2026年9月17日

初めて .NET サービスから Excel ファイルを読む必要があったとき、Microsoft Interop を使いましたが、すぐに後悔しました。 サーバーに Office をインストールする必要があり、メソッドの途中で例外がスローされるとプロセスがリークし、負荷がかかるとチョークします。 私たちはその壁に絶えずぶつかっていたので IronXL を作りました。 このガイドでは、今日実際に生産で XLS と XLSX を読む方法を説明しており、特に使い手を悩ませる点に注意が必要です。

以下のほとんどは、Excel アプリケーションを使用せずに、直接ファイル形式を読み取ります: ワークブックをロードし、セルアドレスで値を取得し、範囲を検証し、データをデータベースや API にプッシュします。 ライブラリはマシンに Microsoft Office がなくても XLS と XLSX を処理します。

クイックスタート: IronXL で一行でセルを読む

一行で Excel のワークブックを読み込み、セルから値を取り出します。 Interop はなし、セットアップはなし、バックグラウンドでの Excel プロセスもなし。

  1. 1IronXL を NuGet Package Manager でインストールします

    PM > Install-Package IronXL.Excel

  2. 2このコード スニペットをコピーして実行します。

    var value = IronXL.WorkBook.Load("file.xlsx").WorkSheets[0]["A1"].StringValue;
  3. 3実際の環境でテストするためにデプロイする

    今日からご自身のプロジェクトでIronXLを使い始めるには、無料トライアルをお試しください。
    arrow pointer

IronXLでC#でExcelファイルを読むにはどうしたら良いですか?

セットアップ自体は NuGet インストールと using IronXL; 命令です。ライブラリは .XLS と .XLSX の両方に対応しているため、レガシー スプレッドシートと最新の Open XML フォーマットのコードパスが同じです。

開始するには、以下の手順に従ってください:

  1. C# ライブラリをダウンロードして Excel ファイルを読み取る
  2. WorkBook.Load() を使用して Excel ワークブックをロードして読み取る
  3. GetWorkSheet() メソッドでワークシートにアクセスする
  4. sheet["A1"].Value のような Excel スタイルのアドレスを使用してセル値を読み取る
  5. プログラムでスプレッドシートデータを検証および処理します
  6. Entity Frameworkを使用してデータをデータベースにエクスポートします

IronXL は Office 製品に依存せずに、C# から Microsoft Excel ドキュメントを読み取り編集します。 Microsoft Excel のインストールは不要で、Interop も必要ありません。 アプローチと API の範囲における違いを知るためにMicrosoft.Office.Interop.Excel との比較を参照してください。

Interop を使用している場合は、メンタルモデルが異なるため、コードを書く前に確立しておく価値があります。 Interop は舞台裏で実際の Excel.exe プロセスを起動し、コードが COM を介してそのアプリケーションを自動化します。 IronXL はファイルバイトを直接メモリに読み込み、それをオブジェクトとして提示します。 Excel プロセスなし、メッセージ ポンプなし、COM マーシャリングなし。 最も多くの人がつまづく実際的な結果: Interop は [1, 1] (1から始まります。これは Excel の UI と同じです) からセルをインデックスしますが、IronXL が行/列にアクセスするには 0 を基準にします。 両方のライブラリでスプレッドシート UI と一致する ["A1"] 文字列インデクサがあるため、文字列形式を維持できるときに限り、移行はほとんど同じように読み取れます。 午後を費やしてのオフバイワンバグはすべて数値インデクサから生じます。

IronXLには以下が含まれます:

  • .NETエンジニアによる専用の製品サポート
  • Microsoft Visual Studioを介した簡単なインストール
  • 開発用の無料試用版。 $999 からのライセンス

C# と VB.NET のプロジェクトの両方で、Excel ファイルを読み取りまたは作成するために IronXL を同じ方法で使用できます。

IronXLを使用して.XLSおよび.XLSX Excelファイルを読み取る

IronXLを使用してExcelファイルを読み取る基本的なワークフローは次のとおりです:

  1. NuGet パッケージを介して IronXL Excel ライブラリをインストールするか、.NET Excel DLLをダウンロードします。
  2. WorkBook.Load() メソッドを使用して、任意の XLS、XLSX または CSV ドキュメントを読み取る
  3. Excelスタイルのアドレス sheet["A11"].DecimalValue を使用してセル値にアクセスする
using IronXL;
using System;
using System.Linq;

// Load Excel workbook from file path
WorkBook workBook = WorkBook.Load("test.xlsx");

// Access the first worksheet using LINQ
WorkSheet workSheet = workBook.WorkSheets.First();

// Read integer value from cell A2
int cellValue = workSheet["A2"].IntValue;
Console.WriteLine($"Cell A2 value: {cellValue}");

// Iterate through a range of cells
foreach (var cell in workSheet["A2:A10"])
{
    Console.WriteLine("Cell {0} has value '{1}'", cell.AddressString, cell.Text);
}

// Advanced Operations with LINQ
// Calculate sum using built_in Sum() method
decimal sum = workSheet["A2:A10"].Sum();

// Find maximum value using LINQ
decimal max = workSheet["A2:A10"].Max(c => c.DecimalValue);

// Output calculated results
Console.WriteLine($"Sum of A2:A10: {sum}");
Console.WriteLine($"Maximum value: {max}");

スニペットは、常に使用する 4 つの操作を説明します: ワークブックの読み込み、アドレスによるセルの読み取り、範囲の反復、および範囲に対する計算の実行。 WorkBook.Load() は、拡張子からファイル形式を検出し、範囲の構文 ["A2:A10"] は、Excel そのものに入力するセルの選択を一致させます。 範囲は IEnumerable<Cell> であり、LINQ はそれらに対する合計、フィルター、および投影のために直接機能します。

実際、どれほど速いですか?

現実的なパフォーマンスの感触を提供するために、このチュートリアル全体で使用される種類のファイルを読み込み、操作のタイミングを測定するための小さなコンソールプロジェクトを書きました。 ハーネスは ReadExcelBenchmark サンプルプロジェクトにあり、ご自身で実行することができ、数値を私のものではなく自分のハードウェアで測定できます。複数の実行を通しての相対的なパターンは一貫しています:

手術最初のコールドロード (新しいプロセス)10 回の反復でのウォーム平均
GDP.xlsx (213 行) を読み込み、列 Bを合計スタートアップが支配する最も遅い実行急激に落ちて、その後安定する
People.xlsx (100 行) を読み込み、すべてのセルを正規表現で検証コールドでも速いそのコールド実行と同等

最初のコールドロードは IronXL のアセンブリロードと JIT のウォームアップに支配されます。2度目のコールドランは、アセンブリがすでにメモリにあるため、はるかに低くなります。 ウォームランは、JIT がホットパスをコンパイルした後にきつく収束します。

このサイズのファイルで複数秒かかる読み込みが発生している場合、原因はほぼ常にループ内で WorkBook.Load() を呼び出していることにあります。 一度ワークブックを読み込んでから、実際に必要なセルまたは行を反復してください。 「IronXL が遅い」サポートチケットの約半分でその正確なパターンを見ます。

残り半分は、ループが問題でなかったファイルです。 Load は完全なワークブックを返す前に構築するため、数十万行ある場合、リストラクチャリングの量には助けはありません。 そのサイズのファイルから必要なのが値だけである場合は、一度に一行を戻すことができるフォワードオンリーストリーミングを使用して読み取ってください。

このチュートリアルのコード例は、さまざまなデータシナリオを紹介する3つのサンプルExcelスプレッドシートで動作します:

Visual Studio ソリューションエクスプローラに表示される 3 つの Excel スプレッドシートファイル このチュートリアルで使用されるサンプルExcelファイル(GDP.xlsx、People.xlsx、PopulationByState.xlsx)は、さまざまなIronXL操作を示します。


IronXL C# ライブラリをインストールするには?


.NET プロジェクトに NuGet を通じてまたは直接 DLL を参照することで IronXL.Excel ライブラリを追加します。

IronXL NuGetパッケージのインストール

  1. Visual Studioで、プロジェクトを右クリックし、「NuGetパッケージの管理」を選択します。
  2. [Browse] タブで IronXL.Excel を検索する
  3. インストールボタンをクリックして、IronXLをプロジェクトに追加します

IronXL.Excel パッケージのインストールを示す NuGet パッケージ マネージャ UI Visual StudioのNuGetパッケージマネージャーを通じてIronXLをインストールすることにより、自動的な依存関係の管理を提供します。

または、パッケージマネージャーコンソールを使用してIronXLをインストールします:

  1. パッケージマネージャーコンソールを開く(ツール → NuGetパッケージマネージャー → パッケージマネージャーコンソール)
  2. インストールコマンドを実行します:

PM > Install-Package IronXL.Excel

また、NuGet ウェブサイトでパッケージの詳細を表示できます。

手動インストール

手動インストールの場合は、IronXL .NET Excel DLL をダウンロードして、Visual Studio プロジェクトで直接参照してください。

Excelワークブックを読み込んで読み取るにはどうすればいいですか?

WorkBook クラスは完全な Excel ファイルを表します。WorkBook.Load() メソッドを使用して Excel ファイルをロードします。これは、XLS、XLSX、CSV、および TSV フォーマットのファイルパスを受け入れます。

using IronXL;
using System;
using System.Linq;

// Load Excel file from specified path
WorkBook workBook = WorkBook.Load(@"Spreadsheets\GDP.xlsx");

Console.WriteLine("Workbook loaded successfully.");

// Access specific worksheet by name
WorkSheet sheet = workBook.GetWorkSheet("Sheet1");

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

// Perform additional operations
// Count non_empty cells in column A
int rowCount = sheet["A:A"].Count(cell => !cell.IsEmpty);
Console.WriteLine($"Column A has {rowCount} non_empty cells");

各 WorkBook は、個々の Excel シートを表す複数の WorkSheet オブジェクトを含みます。 名前でワークシートにアクセスするには GetWorkSheet() を使用します:

using IronXL;
using System;

// Get worksheet by name
WorkSheet workSheet = workBook.GetWorkSheet("GDPByCountry");

Console.WriteLine("Worksheet 'GDPByCountry' not found");
// List available worksheets
foreach (var sheet in workBook.WorkSheets)
{
    Console.WriteLine($"Available: {sheet.Name}");
}

新しいExcelドキュメントをC#で作成するには?

希望のファイル形式で WorkBook オブジェクトを作成して新しい Excel ドキュメントを作成します。 IronXLは、最新のXLSXフォーマットと旧式のXLSフォーマットの両方をサポートしています。

using IronXL;

// Create new XLSX workbook (recommended format)
WorkBook workBook = WorkBook.Create(ExcelFileFormat.XLSX);

// Set workbook metadata
workBook.Metadata.Author = "Your Application";
workBook.Metadata.Comments = "Generated by IronXL";

// Create new XLS workbook for legacy support
WorkBook legacyWorkBook = WorkBook.Create(ExcelFileFormat.XLS);

// Save the workbook
workBook.SaveAs("NewDocument.xlsx");

注: Excel 2003 およびそれ以前のバージョンとの互換性が必要な場合にのみ ExcelFileFormat.XLS を使用します。

Excelドキュメントにワークシートを追加するにはどうすればいいですか?

IronXL WorkBook にはワークシートのコレクションが含まれます。 この構造を理解することで、複数シートのExcelファイルを構築する際に役立ちます。

複数のワークシートを含むワークブックを示す図 IronXLの複数のWorkSheetオブジェクトを含むWorkBookの視覚的表現。

新しいワークシートを CreateWorkSheet() を用いて作成します:

using IronXL;

// Create multiple worksheets with descriptive names
WorkSheet summarySheet = workBook.CreateWorkSheet("Summary");
WorkSheet dataSheet = workBook.CreateWorkSheet("RawData");
WorkSheet chartSheet = workBook.CreateWorkSheet("Charts");

// Set the active worksheet
workBook.SetActiveTab(0); // Makes "Summary" the active sheet

// Access default worksheet (first sheet)
WorkSheet defaultSheet = workBook.DefaultWorkSheet;

セルの値を読み取って編集するにはどうすればいいですか?

単一のセルを読み取って編集する

ワークシートのインデクサープロパティを通じて個々のセルにアクセスします。 IronXL の Cell クラスは厳密に型付けされた値のプロパティを提供します。

using IronXL;
using System;
using System.Linq;

// Load workbook and get worksheet
WorkBook workBook = WorkBook.Load("test.xlsx");
WorkSheet workSheet = workBook.DefaultWorkSheet;

// Access cell B1
IronXL.Cell cell = workSheet["B1"].First();

// Read cell value with type safety
string textValue = cell.StringValue;
int intValue = cell.IntValue;
decimal decimalValue = cell.DecimalValue;
DateTime? dateValue = cell.DateTimeValue;

// Check cell data type
if (cell.IsNumeric)
{
    Console.WriteLine($"Numeric value: {cell.DecimalValue}");
}
else if (cell.IsText)
{
    Console.WriteLine($"Text value: {cell.StringValue}");
}

Cell クラスはさまざまなデータ型に対する複数のプロパティを提供し、自動的に可能な場合は値を変換します。 セル整形チュートリアルを参照して、より多くのセル操作を確認してください。

// Write different data types to cells
workSheet["A1"].Value = "Product Name";     // String
workSheet["B1"].Value = 99.95m;             // Decimal
workSheet["C1"].Value = DateTime.Today;     // Date
workSheet["D1"].Formula = "=B1*1.2";        // Formula
                                            // Format cells
workSheet["B1"].FormatString = "$#,##0.00"; // Currency format
workSheet["C1"].FormatString = "yyyy-MM-dd";// Date format
                                            // Save changes
workBook.Save();

セル範囲を操作するにはどうすればいいですか?

Range クラスはセルのコレクションを表し、Excel データに対する一括操作を可能にします。

using IronXL;
using Range = IronXL.Range;

// Select range using Excel notation
Range range = workSheet["D2:D101"];

// Alternative: Use Range class for dynamic selection
Range dynamicRange = workSheet.GetRange("D2:D101"); // Row 2_101, Column D

// Perform bulk operations
range.Value = 0; // Set all cells to 0

セルの数がわかっている場合は、ループを使用して効率的に範囲を処理します:

// Data validation example
public class ValidationResult
{
    public int Row { get; set; }
    public string PhoneError { get; set; }
    public string EmailError { get; set; }
    public string DateError { get; set; }
    public bool IsValid => string.IsNullOrEmpty(PhoneError) && 
                           string.IsNullOrEmpty(EmailError) && 
                           string.IsNullOrEmpty(DateError);
}

// Validate data in rows 2-101
var results = new List<ValidationResult>();

for (int row = 2; row <= 101; row++)
{
    var result = new ValidationResult { Row = row };
    
    // Get row data efficiently
    var phoneCell = workSheet[$"B{row}"];
    var emailCell = workSheet[$"D{row}"];
    var dateCell = workSheet[$"E{row}"];
    
    // Validate phone number
    if (!IsValidPhoneNumber(phoneCell.StringValue))
        result.PhoneError = "Invalid phone format";
    
    // Validate email
    if (!IsValidEmail(emailCell.StringValue))
        result.EmailError = "Invalid email format";
    
    // Validate date
    if (!dateCell.IsDateTime)
        result.DateError = "Invalid date format";
    
    results.Add(result);
}

// Helper methods
bool IsValidPhoneNumber(string phone) => 
    System.Text.RegularExpressions.Regex.IsMatch(phone, @"^\d{3}-\d{3}-\d{4}$");

bool IsValidEmail(string email) => 
    email.Contains("@") && email.Contains(".");

Excelスプレッドシートに数式を追加するにはどうすればいいですか?

Excel の数式を使用するには Formula プロパティを適用します。 IronXLは、標準のExcel数式構文をサポートしています。

using IronXL;

// Add formulas to calculate percentages
int lastRow = 50;
for (int row = 2; row < lastRow; row++)
{
    // Calculate percentage: current value / total
    workSheet[$"C{row}"].Formula = $"=B{row}/B{lastRow}";
    // Format as percentage
    workSheet[$"C{row}"].FormatString = "0.00%";
}
// Add summary formulas
workSheet["B52"].Formula = "=SUM(B2:B50)";      // Sum
workSheet["B53"].Formula = "=AVERAGE(B2:B50)";   // Average
workSheet["B54"].Formula = "=MAX(B2:B50)";       // Maximum
workSheet["B55"].Formula = "=MIN(B2:B50)";       // Minimum
                                                 // Force formula evaluation
workBook.EvaluateAll();

既存の数式を編集するには、Excel 数式のチュートリアルを探ってください。

スプレッドシートデータを検証するにはどうすればいいですか?

私が見る一般的な使用ケースは、データベースに入力する前にユーザーから提供されたスプレッドシートを検証することです。 以下の例では、電話番号、メールアドレス、および日付を正規表現と IronXL の組み込み型チェックで確認します。

using System.Text.RegularExpressions;
using IronXL;

// Validation implementation
for (int i = 2; i <= 101; i++)
{
    var result = new PersonValidationResult { Row = i };
    results.Add(result);
    
    // Get cells for current person
    var cells = workSheet[$"A{i}:E{i}"].ToList();
    
    // Validate phone (column B)
    string phone = cells[1].StringValue;
    if (!Regex.IsMatch(phone, @"^\+?1?\d{10,14}$"))
    {
        result.PhoneNumberErrorMessage = "Invalid phone format";
    }
    
    // Validate email (column D)
    string email = cells[3].StringValue;
    if (!Regex.IsMatch(email, @"^[^@\s]+@[^@\s]+\.[^@\s]+$"))
    {
        result.EmailErrorMessage = "Invalid email address";
    }
    
    // Validate date (column E)
    if (!cells[4].IsDateTime)
    {
        result.DateErrorMessage = "Invalid date format";
    }
}

検証結果を新しいワークシートに保存します:

// Create results worksheet
var resultsSheet = workBook.CreateWorkSheet("ValidationResults");

// Add headers
resultsSheet["A1"].Value = "Row";
resultsSheet["B1"].Value = "Valid";
resultsSheet["C1"].Value = "Phone Error";
resultsSheet["D1"].Value = "Email Error";
resultsSheet["E1"].Value = "Date Error";

// Style headers
resultsSheet["A1:E1"].Style.Font.Bold = true;
resultsSheet["A1:E1"].Style.SetBackgroundColor("#4472C4");
resultsSheet["A1:E1"].Style.Font.Color = "#FFFFFF";

// Output validation results
for (int i = 0; i < results.Count; i++)
{
    var result = results[i];
    int outputRow = i + 2;
    
    resultsSheet[$"A{outputRow}"].Value = result.Row;
    resultsSheet[$"B{outputRow}"].Value = result.IsValid ? "Yes" : "No";
    resultsSheet[$"C{outputRow}"].Value = result.PhoneNumberErrorMessage ?? "";
    resultsSheet[$"D{outputRow}"].Value = result.EmailErrorMessage ?? "";
    resultsSheet[$"E{outputRow}"].Value = result.DateErrorMessage ?? "";
    
    // Highlight invalid rows
    if (!result.IsValid)
    {
        resultsSheet[$"A{outputRow}:E{outputRow}"].Style.SetBackgroundColor("#FFE6E6");
    }
}

// Auto-fit columns
for (int col = 0; col < 5; col++)
{
    resultsSheet.AutoSizeColumn(col);
}

// Save validated workbook
workBook.SaveAs(@"Spreadsheets\PeopleValidated.xlsx");

Excelデータをデータベースにエクスポートするにはどうすればよいですか?

Entity Frameworkを使用してIronXLでスプレッドシートデータを直接データベースにエクスポートします。 この例では、国のGDPデータをSQLiteにエクスポートする方法を示しています。

using System;
using System.ComponentModel.DataAnnotations;
using Microsoft.EntityFrameworkCore;
using IronXL;

// Define entity model
public class Country
{
    [Key]
    public Guid Id { get; set; } = Guid.NewGuid();
    
    [Required]
    [MaxLength(100)]
    public string Name { get; set; }
    
    [Range(0, double.MaxValue)]
    public decimal GDP { get; set; }
    
    public DateTime ImportedDate { get; set; } = DateTime.UtcNow;
}

データベース操作のためにEntity Frameworkコンテキストを構成します:

public class CountryContext : DbContext
{
    public DbSet<Country> Countries { get; set; }
    
    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
    {
        // Configure SQLite connection
        optionsBuilder.UseSqlite("Data Source=CountryGDP.db");
        
        // Enable sensitive data logging in development
        #if DEBUG
        optionsBuilder.EnableSensitiveDataLogging();
        #endif
    }
    
    protected override void OnModelCreating(ModelBuilder modelBuilder)
    {
        // Configure decimal precision
        modelBuilder.Entity<Country>()
            .Property(c => c.GDP)
            .HasPrecision(18, 2);
    }
}
注意してください: 注: 異なるデータベースを使用するには、対応する NuGet パッケージ (例: SQL Server 用 Microsoft.EntityFrameworkCore.SqlServer) をインストールし、接続設定を適切に変更してください。

Excelデータをデータベースにインポートします:

using System.Threading.Tasks;
using IronXL;
using Microsoft.EntityFrameworkCore;

public async Task ImportGDPDataAsync()
{
    try
    {
        // Load Excel file
        var workBook = WorkBook.Load(@"Spreadsheets\GDP.xlsx");
        var workSheet = workBook.GetWorkSheet("GDPByCountry");
        
        using (var context = new CountryContext())
        {
            // Ensure database exists
            await context.Database.EnsureCreatedAsync();
            
            // Clear existing data (optional)
            await context.Database.ExecuteSqlRawAsync("DELETE FROM Countries");
            
            // Import data with progress tracking
            int totalRows = 213;
            for (int row = 2; row <= totalRows; row++)
            {
                // Read country data
                var countryName = workSheet[$"A{row}"].StringValue;
                var gdpValue = workSheet[$"B{row}"].DecimalValue;
                
                // Skip empty rows
                if (string.IsNullOrWhiteSpace(countryName))
                    continue;
                
                // Create and add entity
                var country = new Country
                {
                    Name = countryName.Trim(),
                    GDP = gdpValue * 1_000_000 // Convert to actual value if in millions
                };
                
                await context.Countries.AddAsync(country);
                
                // Save in batches for performance
                if (row % 50 == 0)
                {
                    await context.SaveChangesAsync();
                    Console.WriteLine($"Imported {row - 1} of {totalRows} countries");
                }
            }
            
            // Save remaining records
            await context.SaveChangesAsync();
            Console.WriteLine($"Successfully imported {await context.Countries.CountAsync()} countries");
        }
    }
    catch (Exception ex)
    {
        Console.WriteLine($"Import failed: {ex.Message}");
        throw;
    }
}

APIデータをExcelスプレッドシートにインポートするにはどうすればよいですか?

HTTPクライアントとIronXLを組み合わせてスプレッドシートをライブAPIデータで埋めます。 この例ではRestClient.Netを利用して国データを取得します。

using System;
using System.Collections.Generic;
using System.Net.Http;
using System.Threading.Tasks;
using Newtonsoft.Json;
using IronXL;

// Define data model matching API response
public class RestCountry
{
    public string Name { get; set; }
    public long Population { get; set; }
    public string Region { get; set; }
    public string NumericCode { get; set; }
    public List<Language> Languages { get; set; }
}

public class Language
{
    public string Name { get; set; }
    public string NativeName { get; set; }
}

// Fetch and process API data
public async Task ImportCountryDataAsync()
{
    using var httpClient = new HttpClient();
    
    try
    {
        // Call REST API
        var response = await httpClient.GetStringAsync("https://restcountries.com/v3.1/all");
        var countries = JsonConvert.DeserializeObject<List<RestCountry>>(response);
        
        // Create new workbook
        var workBook = WorkBook.Create(ExcelFileFormat.XLSX);
        var workSheet = workBook.CreateWorkSheet("Countries");
        
        // Add headers with styling
        string[] headers = { "Country", "Population", "Region", "Code", "Language 1", "Language 2", "Language 3" };
        for (int col = 0; col < headers.Length; col++)
        {
            var headerCell = workSheet[0, col];
            headerCell.Value = headers[col];
            headerCell.Style.Font.Bold = true;
            headerCell.Style.SetBackgroundColor("#366092");
            headerCell.Style.Font.Color = "#FFFFFF";
        }
        
        // Import country data
        await ProcessCountryData(countries, workSheet);
        
        // Save workbook
        workBook.SaveAs("CountriesFromAPI.xlsx");
    }
    catch (Exception ex)
    {
        Console.WriteLine($"API import failed: {ex.Message}");
    }
}

APIはこの形式でJSONデータを返します:

JSON 応答構造: ネストされた言語配列を含む国データ 階層的な国情報を示すREST Countries APIからのサンプルJSON応答。

APIデータを処理してExcelに書き込みます:

private async Task ProcessCountryData(List<RestCountry> countries, WorkSheet workSheet)
{
    for (int i = 0; i < countries.Count; i++)
    {
        var country = countries[i];
        int row = i + 1; // Start from row 1 (after headers)
        
        // Write basic country data
        workSheet[$"A{row}"].Value = country.Name;
        workSheet[$"B{row}"].Value = country.Population;
        workSheet[$"C{row}"].Value = country.Region;
        workSheet[$"D{row}"].Value = country.NumericCode;
        
        // Format population with thousands separator
        workSheet[$"B{row}"].FormatString = "#,##0";
        
        // Add up to 3 languages
        for (int langIndex = 0; langIndex < Math.Min(3, country.Languages?.Count ?? 0); langIndex++)
        {
            var language = country.Languages[langIndex];
            string columnLetter = ((char)('E' + langIndex)).ToString();
            workSheet[$"{columnLetter}{row}"].Value = language.Name;
        }
        
        // Add conditional formatting for regions
        if (country.Region == "Europe")
        {
            workSheet[$"C{row}"].Style.SetBackgroundColor("#E6F3FF");
        }
        else if (country.Region == "Asia")
        {
            workSheet[$"C{row}"].Style.SetBackgroundColor("#FFF2E6");
        }
        
        // Show progress every 50 countries
        if (i % 50 == 0)
        {
            Console.WriteLine($"Processed {i} of {countries.Count} countries");
        }
    }
    
    // Auto-size all columns
    for (int col = 0; col < 7; col++)
    {
        workSheet.AutoSizeColumn(col);
    }
}

一般的な注意点(Gotchas)

いくつかのことがあまりにもしばしば人を噛むので、それらに専用のセクションが必要です。

空のセルは null ではなく 0 を返す

これは初期の頃に私をいたくしました。 ブランクセルで sheet["A1"].IntValue (あるいは DecimalValue、または DoubleValue) を呼び出すと、0 が返され、null ではありません。 隙間のある列を合計または平均するとき、空白は静かにゼロになり、結果を歪めることがあります。 今では、欠損値がある可能性のあるすべてのシートの読み取りを保護しています:

var cell = sheet["B5"];
if (!cell.IsEmpty)
{
    total += cell.DecimalValue;
}

Cell.IsEmpty は安価であるため、スプレッドシートがマシン生成ではなくユーザー提供のものである場合はいつでもそれを使用することにしています。

正しい型を問い合わせなければ、日付はシリアル番号として返ってくる

Excelは日付を裏でシリアル番号として保存します (例: 45292 は 2024-01-01 を意味します)。 サポートの受信トレイで最もよくある日付関連の質問は「なぜ日付が45292として表示されるのですか?」です。答えはほとんどの場合、セルが StringValue または IntValue として読み取られ、DateTimeValue として読み取られなかったためです。

// What you probably want:
DateTime birthday = sheet["E2"].DateTimeValue;

// What gives you "45292":
string birthday = sheet["E2"].StringValue;

Cell.IsDateTime は、そのセルが最初に日付として作成されたかどうかを教えてくれます。これは、入力形式が保証されていない検証パイプラインにとって有用です。

セルインデックス数値は 0 から始まるが、A1 文字列は 1 から始まる

Interop 移行段落にて言及されていますが、COM に近づいたことのない人でもつまずくので、再度言及する価値があります。 sheet[0, 0] は sheet["A1"] と同じセルです。 同じループで両方のスタイルを混用するとオフバイワンバグが発生します。 1 つのファイルにつき 1 つの形状を選んでそれを守ります; スプレッドシート自体で見るものと一致する["A1"] 文字列形式がデフォルトです。

ベンチマーク数値のサンプルプロジェクト

早期のタイミング数を再現したい場合、ハーネスは小さな.NET 9コンソールアプリです:

// ReadExcelBenchmark/Program.cs (excerpt)
IronXL.License.LicenseKey = Environment.GetEnvironmentVariable("IRONXL_LICENSE_KEY");

var sw = Stopwatch.StartNew();
var workbook = WorkBook.Load("GDP.xlsx");
decimal sum = workbook.WorkSheets.First()["B2:B214"].Sum();
sw.Stop();
Console.WriteLine($"cold: {sw.Elapsed.TotalMilliseconds:F1} ms");

dotnet run -c Release でそれを実行し、最初の起動時に 2 つのサンプルワークブックを生成し、ファイルサイズと複雑さにあわせて自身のファイルを代用することで数値の変動を見ることができます。


オブジェクトリファレンスとリソース

IronXL API リファレンスは、すべてのクラスとメソッドをカバーしており、このチュートリアルで触れないものも含んでいます。

Excel操作の追加のチュートリアル:

まとめ

IronXL.Excel は、XLS、XLSX、CSV、TSV フォーマットすべてにおいて Excel ファイルを読み取り編集します。 ホストマシンでMicrosoft Excel や Interop を使用せずに実行します。

クラウドベースのスプレッドシート操作の場合、.NET用の Google Sheets API クライアントライブラリを調べることもできます。これは IronXL のローカルファイル機能を補完します。

C#プロジェクトでExcel自動化を実装する準備はできましたか? IronXLをダウンロードするか、またはライセンスオプションを探索して本番で使用します。

よくある質問

IronXLとは何か、C#でExcelファイルを読み込むために使用すべき理由は何ですか?

IronXLは、Microsoft OfficeやInteropを必要とせずにExcelファイルを読み書きするためのC#ライブラリです。スプレッドシートデータに直接アクセスできるシンプルなAPIを提供し、サーバーサイドや自動化されたExcel処理が必要な状況に理想的です。

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

IronXLは、Visual StudioのNuGetパッケージマネージャーで「IronXL.Excel」を検索してインストールすることができます。あるいは、IronXLのウェブサイトからDLLをダウンロードして直接プロジェクトに参照を追加することも可能です。

Excelファイル処理において、IronXLを使用することのMicrosoft Interopとの利点は何ですか?

IronXLはMicrosoft Officeのインストールを必要とせず、バックグラウンドでExcelプロセスが実行されるのを避けることができ、Microsoft Interopに比べて負荷が高い状況でも安定しています。また、直接ファイルを読み込むアプローチを使用しており、より効率的でエラーが少ない可能性があります。

IronXLを使用して、Excelファイルを読み込むだけでなく編集することはできますか?

はい、IronXLはExcelファイルの読み込みと書き込みの両方を可能にします。セルの値を読み取って変更したり、新しいワークシートを追加したり、既存ファイルを保存したり、新しいXLSXまたはXLS形式のファイルを作成したりできます。

IronXLを使用してExcelファイルの特定のセルの値を読み取る方法は?

ワークブックをWorkBook.Load()を使って読み込み、目的のワークシートにアクセスして、セルアドレスを使用してセルの値を取得できます。例: sheet["A1"].StringValue。

IronXLが扱えるExcelファイルの種類は何ですか?

IronXLはXLS、XLSX、CSV、TSVファイルを読み書きできます。ファイルを読み込む際に拡張子からフォーマットを自動的に検出します。

IronXLはExcelファイル内の数式評価をサポートしていますか?

はい、IronXLはExcel数式をサポートしています。セルに数式を追加でき、WorkBook.EvaluateAll()メソッドを使用して、保存する前に正しく計算されていることを確認できます。

IronXLを使用してExcelファイルからデータベースにデータをエクスポートする方法は?

IronXLをEntity Frameworkと組み合わせて使用することで、Excelデータを直接データベースにエクスポートできます。Excelファイルを読み込み、必要なセルを反復処理し、Entity FrameworkのORM機能を使用してデータエンティティを保存します。

Excelデータをデータベースにインポートする前にIronXLで検証することは可能ですか?

はい、IronXLを使用してセルの値を反復し、期待される形式や値をチェックし、データベースインポートを実行する前に不一致を記録することでスプレッドシートデータを検証できます。

IronXLはC#とVB.NETの両方のプロジェクトで使用できますか?

はい、IronXLはC#とVB.NETの両方のプロジェクトで機能の違いなく利用可能で、これらの.NET言語間でのスムーズなExcelファイル操作を可能にします。

Jacob Mellorは、Iron Softwareの最高技術責任者であり、C# PDF技術を先導するビジョナリーなエンジニアです。Iron Softwareのコアコードベースの最初の開発者として、CEOのCameron Rimingtonと共に、NASA、Tesla、および世界中の政府機関を対象にサービスを提供する50人以上の企業に変革しました。

もっと読む

準備はできましたか?

NuGetダウンロード数 2,393,101バージョン:2026.11ちょうどリリースされました