C# で CSV をインポートする | ASP.NET Coreチュートリアル | IronXL

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

解析コードを書く前に、 IronXL をプロジェクトに追加します。 Visual Studio のパッケージ マネージャー コンソールまたはプロジェクト ディレクトリのターミナルを開き、次のいずれかのコマンドを実行します。

Install-Package IronXl.Excel
dotnet add package IronXl.Excel

Install-Package IronXl.Excel
dotnet add package IronXl.Excel

このパッケージは、.NET 10、 .NET 6+、. .NET Framework 4.6.2+、および.NET Standard 2.0 を対象としているため、あらゆる最新のプロジェクト タイプに適合します。 サーバーに Microsoft Office をインストールする必要はありません。 パッケージが復元されたら、ライブラリを呼び出すファイルの先頭に using IronXL; を追加します。

グローバル ツールのインストールや CI/CD パイプラインの構成などの詳細なセットアップ オプションについては、 IronXLインストール ガイドをご覧ください。

ASP.NET Coreで CSV ファイルをインポートするにはどうすればよいですか?

ASP.NET Coreで CSV ファイルをインポートするには、サーバーからファイル ストリームを読み取り、各行を解析し、値をモデル クラスにマッピングする必要があります。 一部の開発者は手動の実装やサードパーティのパッケージを使用していますが、 IronXL は追加の構成なしで CSV ファイルと Excel 形式を一緒に処理する単一の方法を提供します。

次のコードは、IronXL の WorkBook.LoadCSV メソッドを使用して CSV ファイルをロードする方法を示しています。

using IronXL;

// Load the CSV file directly using the full file path
var csv = WorkBook.LoadCSV("products.csv");
WorkSheet worksheet = csv.DefaultWorkSheet;

// Access CSV data by iterating through rows
foreach (var row in worksheet.Rows)
{
    string productName = row.Columns[1].StringValue;
    decimal price = row.Columns[2].DecimalValue;
    Console.WriteLine($"Product: {productName}, Price: {price}");
}

using IronXL;

// Load the CSV file directly using the full file path
var csv = WorkBook.LoadCSV("products.csv");
WorkSheet worksheet = csv.DefaultWorkSheet;

// Access CSV data by iterating through rows
foreach (var row in worksheet.Rows)
{
    string productName = row.Columns[1].StringValue;
    decimal price = row.Columns[2].DecimalValue;
    Console.WriteLine($"Product: {productName}, Price: {price}");
}

CSV データのモデル クラスを作成するにはどうすればよいですか?

CSV データを厳密に型指定されたオブジェクトにマッピングするには、ファイル構造をミラーリングするモデル クラスが必要です。 生の文字列データを整数、小数、DateTime 値などの特定の型に変換します。 製品在庫データの場合は、各 CSV 列に一致するプロパティを持つクラスを作成します。

public class Product
{
    public int Id { get; set; }
    public string Name { get; set; } = string.Empty;
    public decimal Price { get; set; }
    public int Quantity { get; set; }
}

public class Product
{
    public int Id { get; set; }
    public string Name { get; set; } = string.Empty;
    public decimal Price { get; set; }
    public int Quantity { get; set; }
}

using IronXL;

WorkBook workbook = WorkBook.LoadCSV("inventory.csv");
WorkSheet ws = workbook.DefaultWorkSheet;
var records = new List<Product>();

// Skip header row (index 0), iterate through data rows
for (int i = 1; i < ws.Rows.Count(); i++)
{
    var row = ws.Rows[i];
    var product = new Product
    {
        Id = row.Columns[0].IntValue,
        Name = row.Columns[1].StringValue,
        Price = row.Columns[2].DecimalValue,
        Quantity = row.Columns[3].IntValue
    };
    records.Add(product);
}

Console.WriteLine($"Loaded {records.Count} products.");

using IronXL;

WorkBook workbook = WorkBook.LoadCSV("inventory.csv");
WorkSheet ws = workbook.DefaultWorkSheet;
var records = new List<Product>();

// Skip header row (index 0), iterate through data rows
for (int i = 1; i < ws.Rows.Count(); i++)
{
    var row = ws.Rows[i];
    var product = new Product
    {
        Id = row.Columns[0].IntValue,
        Name = row.Columns[1].StringValue,
        Price = row.Columns[2].DecimalValue,
        Quantity = row.Columns[3].IntValue
    };
    records.Add(product);
}

Console.WriteLine($"Loaded {records.Count} products.");

// Reading an optional DateTime field
DateTime? lastUpdated = string.IsNullOrEmpty(row.Columns[4].StringValue)
    ? null
    : row.Columns[4].DateTimeValue;

// Reading an optional DateTime field
DateTime? lastUpdated = string.IsNullOrEmpty(row.Columns[4].StringValue)
    ? null
    : row.Columns[4].DateTimeValue;

Web API で CSV ファイルのアップロードをどのように処理しますか?

ブラウザからの CSV ファイルのアップロードを受け入れる API エンドポイントを構築するには、 ASP.NET Core の IFormFile と IronXL の解析機能を組み合わせる必要があります。 次のコードは、アップロードされたファイルを解析し、JSON 応答を返す完全なコントローラー実装を示しています。

using IronXL;
using Microsoft.AspNetCore.Mvc;

[Route("api/[controller]")]
[ApiController]
public class CsvController : ControllerBase
{
    [HttpPost("upload")]
    public async Task<IActionResult> UploadCsv(IFormFile file)
    {
        if (file == null || file.Length == 0)
            return BadRequest("Please upload a valid CSV file.");

        try
        {
            using var stream = new MemoryStream();
            await file.CopyToAsync(stream);
            stream.Position = 0;

            WorkBook workbook = WorkBook.Load(stream, "csv");
            WorkSheet ws = workbook.DefaultWorkSheet;
            var records = new List<Product>();

            // Skip header row, iterate through data rows
            for (int i = 1; i < ws.Rows.Count(); i++)
            {
                var row = ws.Rows[i];
                records.Add(new Product
                {
                    Id = row.Columns[0].IntValue,
                    Name = row.Columns[1].StringValue,
                    Price = row.Columns[2].DecimalValue,
                    Quantity = row.Columns[3].IntValue
                });
            }

            return Ok(new
            {
                message = "Import successful",
                count = records.Count,
                data = records
            });
        }
        catch (Exception ex)
        {
            return BadRequest($"Error processing file: {ex.Message}");
        }
    }
}

using IronXL;
using Microsoft.AspNetCore.Mvc;

[Route("api/[controller]")]
[ApiController]
public class CsvController : ControllerBase
{
    [HttpPost("upload")]
    public async Task<IActionResult> UploadCsv(IFormFile file)
    {
        if (file == null || file.Length == 0)
            return BadRequest("Please upload a valid CSV file.");

        try
        {
            using var stream = new MemoryStream();
            await file.CopyToAsync(stream);
            stream.Position = 0;

            WorkBook workbook = WorkBook.Load(stream, "csv");
            WorkSheet ws = workbook.DefaultWorkSheet;
            var records = new List<Product>();

            // Skip header row, iterate through data rows
            for (int i = 1; i < ws.Rows.Count(); i++)
            {
                var row = ws.Rows[i];
                records.Add(new Product
                {
                    Id = row.Columns[0].IntValue,
                    Name = row.Columns[1].StringValue,
                    Price = row.Columns[2].DecimalValue,
                    Quantity = row.Columns[3].IntValue
                });
            }

            return Ok(new
            {
                message = "Import successful",
                count = records.Count,
                data = records
            });
        }
        catch (Exception ex)
        {
            return BadRequest($"Error processing file: {ex.Message}");
        }
    }
}

var extension = Path.GetExtension(file.FileName).ToLowerInvariant();
if (extension != ".csv" && extension != ".txt")
    return BadRequest("Only CSV files are accepted.");

var extension = Path.GetExtension(file.FileName).ToLowerInvariant();
if (extension != ".csv" && extension != ".txt")
    return BadRequest("Only CSV files are accepted.");

CSV データをデータベースに保存するにはどうすればよいですか?

CSV ファイルを型付きオブジェクトに解析した後、通常はレコードをデータベースに保存します。 次の例では、一括挿入に Entity Framework Core の AddRangeAsync を使用して、サービス レイヤー パターンを拡張します。

using IronXL;

public class CsvImportService
{
    private readonly AppDbContext _context;

    public CsvImportService(AppDbContext context)
    {
        _context = context;
    }

    public async Task<int> ImportProductsAsync(Stream csvStream)
    {
        WorkBook workbook = WorkBook.LoadCSV(csvStream);
        WorkSheet ws = workbook.DefaultWorkSheet;
        var products = new List<Product>();

        foreach (var row in ws.Rows.Skip(1))
        {
            products.Add(new Product
            {
                Id = row.Columns[0].IntValue,
                Name = row.Columns[1].StringValue,
                Price = row.Columns[2].DecimalValue,
                Quantity = row.Columns[3].IntValue
            });
        }

        await _context.Products.AddRangeAsync(products);
        return await _context.SaveChangesAsync();
    }
}

using IronXL;

public class CsvImportService
{
    private readonly AppDbContext _context;

    public CsvImportService(AppDbContext context)
    {
        _context = context;
    }

    public async Task<int> ImportProductsAsync(Stream csvStream)
    {
        WorkBook workbook = WorkBook.LoadCSV(csvStream);
        WorkSheet ws = workbook.DefaultWorkSheet;
        var products = new List<Product>();

        foreach (var row in ws.Rows.Skip(1))
        {
            products.Add(new Product
            {
                Id = row.Columns[0].IntValue,
                Name = row.Columns[1].StringValue,
                Price = row.Columns[2].DecimalValue,
                Quantity = row.Columns[3].IntValue
            });
        }

        await _context.Products.AddRangeAsync(products);
        return await _context.SaveChangesAsync();
    }
}

builder.Services.AddScoped<CsvImportService>();

builder.Services.AddScoped<CsvImportService>();

IronXLを使用してデータを CSV にエクスポートするにはどうすればよいですか?

IronXL はCSV ファイルの読み取りだけでなく、書き込みも行えます。 SaveAsCsv メソッドは、任意のワークシートを CSV ファイルにエクスポートします。これは、レポートを生成したり、下流のシステムにデータを送信したりするのに役立ちます。

using IronXL;

WorkBook workbook = WorkBook.Create(ExcelFileFormat.XLS);
WorkSheet ws = workbook.DefaultWorkSheet;

// Write headers
ws["A1"].Value = "Id";
ws["B1"].Value = "Name";
ws["C1"].Value = "Price";

// Write data rows
ws["A2"].Value = 1;
ws["B2"].Value = "Widget A";
ws["C2"].Value = 9.99;

ws["A3"].Value = 2;
ws["B3"].Value = "Widget B";
ws["C3"].Value = 14.49;

// Save as CSV
workbook.SaveAsCsv("export.csv");
Console.WriteLine("CSV export complete.");

using IronXL;

WorkBook workbook = WorkBook.Create(ExcelFileFormat.XLS);
WorkSheet ws = workbook.DefaultWorkSheet;

// Write headers
ws["A1"].Value = "Id";
ws["B1"].Value = "Name";
ws["C1"].Value = "Price";

// Write data rows
ws["A2"].Value = 1;
ws["B2"].Value = "Widget A";
ws["C2"].Value = 9.99;

ws["A3"].Value = 2;
ws["B3"].Value = "Widget B";
ws["C3"].Value = 14.49;

// Save as CSV
workbook.SaveAsCsv("export.csv");
Console.WriteLine("CSV export complete.");

エクスポートされたファイルでは、デフォルトでコンマ区切り文字が使用されます。 ヨーロッパのロケールで一般的なセミコロンで区切られたファイルの場合は、明示的な区切り文字引数を使用して SaveAsCsv("export.csv", ";") を呼び出します。 また、MemoryStream に保存し、File(stream, "text/csv", "export.csv") を使用して API エンドポイントからファイルのダウンロードとして結果を返すこともできます。

エクスポート オプションの詳細なリファレンスについては、 IronXL の保存とエクスポートのドキュメントをご覧ください。

手動による CSV 解析よりもIronXL が優れている理由は何ですか?

手動による CSV 解析は、引用符で囲まれたコンマを含む値、セルに埋め込まれた改行、エスケープされた引用符、UTF-8 ファイルの先頭のバイト オーダー マークなどのエッジ ケースが発生するまでは、簡単に見えます。 これらすべてをカスタム StreamReader ループで正しく処理するには、相当のテストと継続的なメンテナンスが必要です。

IronXL はこれらすべてのケースを社内で対処します。 2 つのアプローチを比較すると、明らかな利点がわかります。

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

これで、 ASP.NET Coreでの CSV インポートの各段階 (ライブラリのインストール、ディスクまたはアップロードされたストリームからのファイルの読み込み、型指定されたモデル オブジェクトへの行のマッピング、Entity Framework Core を使用したデータベースへのレコードの永続化、必要に応じてデータを CSV にエクスポートする) で機能するパターンができました。

この基盤を構築するには、次のリソースを調べてください。

• IronXL NuGetパッケージ- NuGet.org のパッケージの詳細とバージョン履歴
• IronXLチュートリアルの概要- フィルタリング、数式の評価、チャート生成を網羅したガイド付きチュートリアル
• IronXL APIリファレンス- クラスとメソッドの完全なドキュメント
• IronXL GitHub の例- GitHubでダウンロード可能なサンプル プロジェクト
• IronXLライセンス オプション- 開発、ステージング、本番環境向けのライセンス レベル
• Microsoft CSV 解析ドキュメント- IronXLが構築する.NET IO モデルの背景
• ASP.NET Coreファイルアップロードドキュメント- IFormFile とマルチパートアップロード構成に関する公式ガイダンス
• IronXL による Excel の読み込みとインポートのチュートリアル- XLSX と CSV の読み込みについて説明します
• IronXL作成と書き込みチュートリアル- データの書き込みと複数の形式での保存について説明します
• IronXLデータのソートとフィルタリング- 読み込み後のインポートデータの操作

プロジェクトにIronXLを使用すると、CSV とともに XLSX アップロードのサポートを追加するために追加のコード変更は必要ありません。同じ WorkBook.Load 呼び出しで両方を処理できます。 この一貫性により、アプリケーションの要件の拡大に合わせて、インポート エンドポイントの機能セットを段階的に拡張できます。