C#에서 CSV 파일 가져오기 | ASP.NET Core 튜토리얼 | IronXL

IronXL을 .NET 프로젝트에 어떻게 설치합니까?

구문 분석 코드를 작성하기 전에 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 파일을 가져오기 위해 서버에서 파일 스트림을 읽고 각 행을 파싱하며 값을 모델 클래스에 매핑합니다. 일부 개발자는 수동 StreamReader 구현이나 타사 패키지를 선호하나, IronXL은 추가 구성 없이 Excel 형식과 함께 CSV 파일을 처리하는 단일 방법을 제공합니다.

다음 코드는 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;

웹 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 저장 및 내보내기 문서를 참조하십시오.

IronXL이 수동 CSV 파싱보다 더 나은 선택인 이유는 무엇입니까?

수동 CSV 파싱은 겉으로는 간단해 보이지만 문제의 여지를 만나기 전까지입니다: 인용부호로 둘러싸인 쉼표, 셀에 포함된 줄바꿈, 이스케이프 처리된 인용부호, UTF-8 파일 시작부의 바이트 오더 마크. 커스텀 StreamReader 루프에서 이를 모두 제대로 처리하려면 상당한 테스트와 지속적인 유지 관리가 필요합니다.

IronXL은 이 모든 경우를 내부적으로 처리합니다. 두 접근방식을 비교하면 명확한 이점이 드러납니다:

다음 단계는 무엇입니까?

이제 라이브러리 설치, 디스크 또는 업로드 스트림에서 파일을 로드하여, 행을 타입화된 모델 객체로 매핑하고 Entity Framework Core를 사용하여 기록을 데이터베이스에 영구 저장하고 필요 시 데이터를 다시 CSV로 내보내는 CSV 가져오기의 각 단계를 위한 작동 패턴을 갖고 있습니다.

기반을 기반으로 확장하려면 다음 리소스를 탐색하세요:

• IronXL NuGet 패키지 -- NuGet.org에서 패키지 세부 정보 및 버전 기록.
• IronXL 튜토리얼 개요 -- 필터링, 수식 평가, 차트 생성에 대한 안내식 튜토리얼.
• IronXL API 참조 -- 전체 클래스 및 메서드 문서화.
• IronXL GitHub 예제 -- GitHub에서 다운로드 가능한 샘플 프로젝트.
• IronXL 라이선스 옵션 -- 개발, 스테이징 및 프로덕션을 위한 라이선스 계층.
• Microsoft CSV 파싱 문서 -- IronXL이 기반으로 하는 .NET IO 모델의 백그라운드.
• ASP.NET Core 파일 업로드 문서 -- IFormFile 및 멀티파트 업로드 구성에 대한 공식 안내.
• IronXL 엑셀 읽기 및 가져오기 튜토리얼 -- CSV와 함께 XLSX 읽기를 다룸.
• IronXL 생성 및 쓰기 튜토리얼 -- 여러 형식으로 데이터를 쓰고 저장하는 것을 다룸.
• IronXL 데이터 정렬 및 필터링 -- 로딩 후 가져온 데이터를 조작하는 것.

프로젝트에서 IronXL을 사용하면 CSV와 함께 XLSX 업로드 지원을 추가하는데 추가 코드 변경이 필요 없습니다. 동일한 WorkBook.Load 호출이 둘 다 처리합니다. 일관성이 유지된다는 것은 애플리케이션 요구 사항이 증가함에 따라 가져오기 엔드포인트의 기능 세트를 점진적으로 확장할 수 있음을 의미합니다.