C# CSV ファイル リーダー: IronXLで CSV データを解析および処理する

CSV 読み取り用にIronXLをインストールするにはどうすればよいでしょうか?

IronXL をプロジェクトに導入するには、ほんの少しの時間しかかかりません。 Visual Studio のNuGetパッケージ マネージャーからインストールすることも、 .NET CLI または PowerShell のNuGetパッケージ マネージャー コンソールを使用してコマンド ラインからインストールすることもできます。 どちらの方法でも同じパッケージがインストールされ、任意 for .NET 10 プロジェクト タイプで動作します。

# .NET CLI
dotnet add package IronXl.Excel

# NuGet Package Manager Console
Install-Package IronXl.Excel

# .NET CLI
dotnet add package IronXl.Excel

# NuGet Package Manager Console
Install-Package IronXl.Excel

インストール オプションと構成の詳細については、 IronXLインストール ドキュメントを参照してください。

インストールが完了すると、最初の CSV ファイルを読み取るのに必要なコードはごくわずかになります。 以下の例では、 .NET 10 のトップレベルステートメントを使用しています。

using IronXL;

// Load CSV file
WorkBook workbook = WorkBook.LoadCSV("data.csv");
WorkSheet sheet = workbook.DefaultWorkSheet;

// Read a specific cell
string cellValue = sheet["A1"].StringValue;

// Iterate through all rows and cells
foreach (var row in sheet.Rows)
{
    foreach (var cell in row)
    {
        Console.WriteLine(cell.StringValue);
    }
}

using IronXL;

// Load CSV file
WorkBook workbook = WorkBook.LoadCSV("data.csv");
WorkSheet sheet = workbook.DefaultWorkSheet;

// Read a specific cell
string cellValue = sheet["A1"].StringValue;

// Iterate through all rows and cells
foreach (var row in sheet.Rows)
{
    foreach (var cell in row)
    {
        Console.WriteLine(cell.StringValue);
    }
}

WorkBook.LoadCSVメソッドは、ヘッダーの識別を処理し、内部データ構造を作成し、メモリ効率の高い解析を実行することで、コードの最初の行からデータ管理を簡素化します。

カスタム区切り文字を使用した CSV ファイルを読み取るにはどうすればよいでしょうか?

実際の CSV ファイルでは、必ずしもコンマが使用されるわけではありません。 国際的なデータセットでは、特にセミコロン、パイプ、タブが一般的な代替品であり、カンマが小数点区切りとして機能しています。 IronXL は、柔軟な読み込みオプションを通じてあらゆる区切り文字を処理します。

using IronXL;

// Load CSV with semicolon delimiter (common in European data exports)
WorkBook workbook = WorkBook.LoadCSV("european-data.csv",
    fileFormat: ExcelFileFormat.XLSX,
    listデリミタ: ";");

// Load tab-separated values (TSV)
WorkBook tsvWorkbook = WorkBook.LoadCSV("export_data.tsv",
    fileFormat: ExcelFileFormat.XLSX,
    listデリミタ: "\t");

// Load pipe-delimited file
WorkBook pipeWorkbook = WorkBook.LoadCSV("log_export.csv",
    fileFormat: ExcelFileFormat.XLSX,
    listデリミタ: "|");

// Access data normally after loading
WorkSheet sheet = workbook.DefaultWorkSheet;
decimal totalSales = sheet["B2:B10"].Sum();

Console.WriteLine($"Total sales: {totalSales}");

using IronXL;

// Load CSV with semicolon delimiter (common in European data exports)
WorkBook workbook = WorkBook.LoadCSV("european-data.csv",
    fileFormat: ExcelFileFormat.XLSX,
    listデリミタ: ";");

// Load tab-separated values (TSV)
WorkBook tsvWorkbook = WorkBook.LoadCSV("export_data.tsv",
    fileFormat: ExcelFileFormat.XLSX,
    listデリミタ: "\t");

// Load pipe-delimited file
WorkBook pipeWorkbook = WorkBook.LoadCSV("log_export.csv",
    fileFormat: ExcelFileFormat.XLSX,
    listデリミタ: "|");

// Access data normally after loading
WorkSheet sheet = workbook.DefaultWorkSheet;
decimal totalSales = sheet["B2:B10"].Sum();

Console.WriteLine($"Total sales: {totalSales}");

listデリミタ パラメータは任意の文字列を受け入れるため、解析動作を完全に制御できます。 IronXL は解析中に列の値とデータ型を保持します。数値は数値のまま、日付はオブジェクトのまま、数式はそれらの関係を維持します。

フォーマットが一貫していないファイルの場合、IronXL のエラー処理により、アプリケーションがクラッシュすることなく不正な行が管理されるため、個々の行に問題があっても有効なデータの処理が継続されます。

CSV データを C# オブジェクトに解析するにはどうすればよいですか?

CSV 行を厳密に型指定されたオブジェクトに変換すると、データ処理が簡素化され、LINQ 操作が可能になります。 IronXL は、セル アクセス メソッドを通じてこのマッピングを簡単に実現します。 次のコードは、 .NET 10 のトップレベル ステートメントを使用して、CSV ファイルを型指定されたオブジェクトのリストにマップする方法を示しています。

using IronXL;

// Define a typed model matching your CSV structure
public record Product(string Name, decimal Price, int Stock, DateTime? LastUpdated);

// Load and parse CSV file
WorkBook workbook = WorkBook.LoadCSV("inventory.csv");
WorkSheet sheet = workbook.DefaultWorkSheet;

var products = new List<Product>();

// Start from row 2 to skip the header row
for (int row = 2; row <= sheet.RowCount; row++)
{
    products.Add(new Product(
        Name: sheet[$"A{row}"].StringValue,
        Price: sheet[$"B{row}"].DecimalValue,
        Stock: sheet[$"C{row}"].IntValue,
        LastUpdated: sheet[$"D{row}"].DateTimeValue
    ));
}

// Use LINQ for analysis after loading
var lowStock = products.Where(p => p.Stock < 10).ToList();
var highValue = products.Where(p => p.Price > 100m).OrderByDescending(p => p.Price).ToList();

Console.WriteLine($"Products with low stock: {lowStock.Count}");
Console.WriteLine($"High-value products: {highValue.Count}");

using IronXL;

// Define a typed model matching your CSV structure
public record Product(string Name, decimal Price, int Stock, DateTime? LastUpdated);

// Load and parse CSV file
WorkBook workbook = WorkBook.LoadCSV("inventory.csv");
WorkSheet sheet = workbook.DefaultWorkSheet;

var products = new List<Product>();

// Start from row 2 to skip the header row
for (int row = 2; row <= sheet.RowCount; row++)
{
    products.Add(new Product(
        Name: sheet[$"A{row}"].StringValue,
        Price: sheet[$"B{row}"].DecimalValue,
        Stock: sheet[$"C{row}"].IntValue,
        LastUpdated: sheet[$"D{row}"].DateTimeValue
    ));
}

// Use LINQ for analysis after loading
var lowStock = products.Where(p => p.Stock < 10).ToList();
var highValue = products.Where(p => p.Price > 100m).OrderByDescending(p => p.Price).ToList();

Console.WriteLine($"Products with low stock: {lowStock.Count}");
Console.WriteLine($"High-value products: {highValue.Count}");

IronXL の型指定された値のプロパティ (DateTimeValue) は、変換を安全に処理し、無効なデータに対して例外をスローするのではなく、デフォルト値を返します。 この防御的なアプローチにより、アプリケーションは中断することなく不完全なデータを処理できるようになります。 これは、C# 9 で導入され、マップされた CSV 行に簡潔で不変のデータ モデルを提供するC# レコード タイプと自然に組み合わせられます。

IronXL機能ページでは、セル データの読み取りに使用できる値アクセサー タイプの概要をすべて説明しています。

using IronXL;

WorkBook workbook = WorkBook.LoadCSV("sales-data.csv");
WorkSheet sheet = workbook.DefaultWorkSheet;

// Read entire columns using range notation
var productNames = sheet["A2:A100"]
    .Select(cell => cell.StringValue)
    .Where(name => !string.IsNullOrEmpty(name))
    .ToList();

// Aggregate numeric columns directly
decimal totalRevenue = sheet["C2:C100"].Sum();
decimal averageOrder = sheet["C2:C100"].Avg();

Console.WriteLine($"Products loaded: {productNames.Count}");
Console.WriteLine($"Total revenue: {totalRevenue:C}");
Console.WriteLine($"Average order value: {averageOrder:C}");

using IronXL;

WorkBook workbook = WorkBook.LoadCSV("sales-data.csv");
WorkSheet sheet = workbook.DefaultWorkSheet;

// Read entire columns using range notation
var productNames = sheet["A2:A100"]
    .Select(cell => cell.StringValue)
    .Where(name => !string.IsNullOrEmpty(name))
    .ToList();

// Aggregate numeric columns directly
decimal totalRevenue = sheet["C2:C100"].Sum();
decimal averageOrder = sheet["C2:C100"].Avg();

Console.WriteLine($"Products loaded: {productNames.Count}");
Console.WriteLine($"Total revenue: {totalRevenue:C}");
Console.WriteLine($"Average order value: {averageOrder:C}");

C# で CSV を Excel 形式に変換するにはどうすればよいでしょうか?

多くのビジネス ワークフローでは、高度な分析、書式設定、配布のために Excel 形式の CSV データが必要です。 IronXL を使用すると、すべてのデータの整合性を維持しながら、この変換が簡単になります。

using IronXL;

// Load CSV file
WorkBook csvWorkbook = WorkBook.LoadCSV("monthly-report.csv");
WorkSheet sheet = csvWorkbook.DefaultWorkSheet;

// Apply formatting before saving
sheet["A1:D1"].Style.Font.Bold = true;
sheet["A1:D1"].Style.BackgroundColor = "#4472C4";
sheet["A1:D1"].Style.Font.Color = "#FFFFFF";

// Apply currency format to price column
sheet["B2:B1000"].FormatString = "$#,##0.00";

// Apply date format to date column
sheet["D2:D1000"].FormatString = "yyyy-MM-dd";

// Save as Excel with a single method call
csvWorkbook.SaveAs("monthly-report.xlsx");

Console.WriteLine("Conversion complete: monthly-report.xlsx");

using IronXL;

// Load CSV file
WorkBook csvWorkbook = WorkBook.LoadCSV("monthly-report.csv");
WorkSheet sheet = csvWorkbook.DefaultWorkSheet;

// Apply formatting before saving
sheet["A1:D1"].Style.Font.Bold = true;
sheet["A1:D1"].Style.BackgroundColor = "#4472C4";
sheet["A1:D1"].Style.Font.Color = "#FFFFFF";

// Apply currency format to price column
sheet["B2:B1000"].FormatString = "$#,##0.00";

// Apply date format to date column
sheet["D2:D1000"].FormatString = "yyyy-MM-dd";

// Save as Excel with a single method call
csvWorkbook.SaveAs("monthly-report.xlsx");

Console.WriteLine("Conversion complete: monthly-report.xlsx");

変換は数値の精度、日付フォーマット、特別な文字を保持し、手動変換方法による問題を引き起こすことはありません。 IronXLは、生成されるExcelファイルの構造を自動的に最適化し、大きなデータセットでもすばやく開く効率的なファイルを作成します。

出力形式をさらに制御するには、エクスポート方法ガイドで、XLSX、XLS、CSV、PDF エクスポートなどのオプションについて説明しています。 Excel ファイルの書き方や、 Excel ファイルを最初から作成する方法も学習できます。

using IronXL;
using System.Data;

WorkBook workbook = WorkBook.LoadCSV("customer-export.csv");

// Convert entire workbook to DataSet
DataSet dataSet = workbook.ToDataSet();

// The first sheet becomes the first Dataタブle
Dataタブle customerタブle = dataSet.タブles[0];

Console.WriteLine($"Rows loaded: {customerタブle.Rows.Count}");
Console.WriteLine($"Columns: {customerタブle.Columns.Count}");

// Process with standard ADO.NET
foreach (DataRow row in customerタブle.Rows)
{
    string name = row["Name"]?.ToString() ?? string.Empty;
    string email = row["Email"]?.ToString() ?? string.Empty;
    Console.WriteLine($"Customer: {name} <{email}>");
}

using IronXL;
using System.Data;

WorkBook workbook = WorkBook.LoadCSV("customer-export.csv");

// Convert entire workbook to DataSet
DataSet dataSet = workbook.ToDataSet();

// The first sheet becomes the first Dataタブle
Dataタブle customerタブle = dataSet.タブles[0];

Console.WriteLine($"Rows loaded: {customerタブle.Rows.Count}");
Console.WriteLine($"Columns: {customerタブle.Columns.Count}");

// Process with standard ADO.NET
foreach (DataRow row in customerタブle.Rows)
{
    string name = row["Name"]?.ToString() ?? string.Empty;
    string email = row["Email"]?.ToString() ?? string.Empty;
    Console.WriteLine($"Customer: {name} <{email}>");
}

大きな CSV ファイルとパフォーマンスの最適化をどのように処理しますか?

数万行以上の大規模な CSV ファイルを処理する場合は、データへのアクセス方法とメモリの管理方法に注意する必要があります。 IronXL には、大容量ファイルのシナリオに役立つ機能が含まれています。

using IronXL;

WorkBook workbook = WorkBook.LoadCSV("large-dataset.csv");
WorkSheet sheet = workbook.DefaultWorkSheet;

int rowCount = sheet.RowCount;
int colCount = sheet.ColumnCount;

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

// Efficient: read entire range at once
var allData = sheet[$"A1:{GetColumnLetter(colCount)}{rowCount}"]
    .Select(cell => cell.StringValue)
    .ToList();

// Efficient: aggregate a column without row-by-row iteration
decimal columnSum = sheet[$"B2:B{rowCount}"].Sum();

Console.WriteLine($"Column B total: {columnSum}");

static string GetColumnLetter(int col)
{
    string result = string.Empty;
    while (col > 0)
    {
        col--;
        result = (char)('A' + col % 26) + result;
        col /= 26;
    }
    return result;
}

using IronXL;

WorkBook workbook = WorkBook.LoadCSV("large-dataset.csv");
WorkSheet sheet = workbook.DefaultWorkSheet;

int rowCount = sheet.RowCount;
int colCount = sheet.ColumnCount;

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

// Efficient: read entire range at once
var allData = sheet[$"A1:{GetColumnLetter(colCount)}{rowCount}"]
    .Select(cell => cell.StringValue)
    .ToList();

// Efficient: aggregate a column without row-by-row iteration
decimal columnSum = sheet[$"B2:B{rowCount}"].Sum();

Console.WriteLine($"Column B total: {columnSum}");

static string GetColumnLetter(int col)
{
    string result = string.Empty;
    while (col > 0)
    {
        col--;
        result = (char)('A' + col % 26) + result;
        col /= 26;
    }
    return result;
}

using IronXL;

string filePath = "user-uploaded-data.csv";

try
{
    WorkBook workbook = WorkBook.LoadCSV(filePath);
    WorkSheet sheet = workbook.DefaultWorkSheet;

    Console.WriteLine($"Loaded {sheet.RowCount} rows from {filePath}");

    for (int row = 2; row <= sheet.RowCount; row++)
    {
        string value = sheet[$"A{row}"].StringValue;
        if (!string.IsNullOrWhiteSpace(value))
        {
            Console.WriteLine(value);
        }
    }
}
catch (IronXl.Exceptions.IronXLException ex)
{
    Console.WriteLine($"IronXL error reading {filePath}: {ex.Message}");
}
catch (IOException ex)
{
    Console.WriteLine($"File access error: {ex.Message}");
}

using IronXL;

string filePath = "user-uploaded-data.csv";

try
{
    WorkBook workbook = WorkBook.LoadCSV(filePath);
    WorkSheet sheet = workbook.DefaultWorkSheet;

    Console.WriteLine($"Loaded {sheet.RowCount} rows from {filePath}");

    for (int row = 2; row <= sheet.RowCount; row++)
    {
        string value = sheet[$"A{row}"].StringValue;
        if (!string.IsNullOrWhiteSpace(value))
        {
            Console.WriteLine(value);
        }
    }
}
catch (IronXl.Exceptions.IronXLException ex)
{
    Console.WriteLine($"IronXL error reading {filePath}: {ex.Message}");
}
catch (IOException ex)
{
    Console.WriteLine($"File access error: {ex.Message}");
}

IronXLのライセンスを取得するにはどうすればいいですか?

IronXL を実稼働環境で使用するにはライセンス キーが必要です。 評価には無料試用ライセンスをご利用いただけます。また、個々の開発者、チーム、組織には商用ライセンスをご利用いただけます。

IronXL呼び出しを行う前に、アプリケーションにライセンス キーを適用します。

using IronXL;

// Apply license key at application startup
IronXl.License.LicenseKey = "YOUR-LICENSE-KEY-HERE";

// Verify the license is active
if (IronXl.License.IsValidLicense("YOUR-LICENSE-KEY-HERE"))
{
    Console.WriteLine("IronXL license is active.");
}

// Now use IronXL normally
WorkBook workbook = WorkBook.LoadCSV("data.csv");
WorkSheet sheet = workbook.DefaultWorkSheet;
Console.WriteLine($"Loaded {sheet.RowCount} rows.");

using IronXL;

// Apply license key at application startup
IronXl.License.LicenseKey = "YOUR-LICENSE-KEY-HERE";

// Verify the license is active
if (IronXl.License.IsValidLicense("YOUR-LICENSE-KEY-HERE"))
{
    Console.WriteLine("IronXL license is active.");
}

// Now use IronXL normally
WorkBook workbook = WorkBook.LoadCSV("data.csv");
WorkSheet sheet = workbook.DefaultWorkSheet;
Console.WriteLine($"Loaded {sheet.RowCount} rows.");

試用版およびライセンス オプションについては、 IronXLライセンス ページをご覧ください。

CSV 処理にIronXL が最適な選択肢となる理由は何ですか?

IronXL は、C# CSV ファイルの読み取りを面倒な解析タスクから簡単な操作に変えます。 ライブラリは、埋め込まれたコンマ、引用符で囲まれたフィールド内の改行、一貫性のない区切り文字、エンコードのバリエーション、不正な行など、手動解析で間違いが発生する一般的なエッジ ケースを、シナリオごとにカスタム コードを必要とせずに処理します。 一度だけデータを素早くインポートする必要がある場合でも、1 日に何千ものファイルを処理する本番パイプラインが必要な場合でも、同じ API が両方のコンテキストで機能します。

引用符で囲まれたフィールドに区切り文字が含まれている場合、またはフィールド値内に改行が含まれている場合、string.Split または StreamReader を使用した手動の CSV 解析はすぐに機能しなくなります。 IronXL は、引用符で囲まれたフィールドの処理とエスケープ シーケンスに関するCSV 仕様に従って、デフォルトでこれらのケースを正しく処理します。

.NET 10 での CSV 作業においてIronXLが際立つ主な利点は次のとおりです。

• Office に依存しない: サーバーおよびクラウド展開は、Microsoft Office や COM 相互運用機能をインストールしなくても動作します。 -カスタム区切り文字: 任意の区切り文字または文字列は、listデリミタ パラメータを通じてサポートされます。 -型安全なセル アクセス: IntValue、および DateTimeValue アクセサは、不正なデータをスローする代わりに、安全なデフォルトを返します。 -範囲操作: 行ごとの反復処理なしで範囲全体のデータを集計およびクエリします -フォーマット変換:CSVを読み込み、1つのワークフローでXLSX、XLS、PDF、またはその他の形式で保存します -データセット統合: 読み込まれたワークブックを ADO .NETおよびデータベース操作用に DataSet / Dataタブle に変換します -クロスプラットフォーム: Windows、Linux、macOS、Docker、クラウド環境で変更なしで実行できます

IronXL のドキュメントとセル書式設定ガイドでは、書式設定、数式のサポート、高度なワークブック操作に関する詳細情報が提供されています。

CSV ファイルを自信を持って扱う準備はできていますか? 無料トライアルを開始して、 IronXL の全機能セットをお試しください。