C# CSV 파일 리더: IronXL 사용하여 CSV 데이터를 구문 분석하고 처리합니다.

CSV 읽기를 위한 IronXL은 어떻게 설치하나요?

IronXL을 프로젝트에 포함시키는 데는 잠시밖에 걸리지 않습니다. Visual Studio의 NuGet 패키지 관리자나, .NET CLI 또는 PowerShell에서 NuGet 패키지 관리자 콘솔을 통해 명령줄로 설치할 수 있습니다. 두 방법 모두 동일한 패키지를 설치하며, 모든 .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은 구문 분석 중에 열 값과 데이터 유형을 보존합니다. -- 숫자 값은 숫자로 남고, 날짜는 DateTime 객체로 유지되며, 수식은 그 관계를 유지합니다.

형식이 일치하지 않는 파일의 경우, 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의 유형화된 값 속성 -- StringValue, DecimalValue, IntValue, DateTimeValue --는 안전하게 변환을 처리하여 잘못된 데이터에 대해 예외를 발생시키지 않고 기본값을 반환합니다. 이 방어적 접근 방식은 애플리케이션이 불완전한 데이터를 방해 없이 처리하도록 보장합니다. 이는 C# 9에 도입된 C# 레코드 타입과 자연스럽게 결합되며, 매핑된 CSV 행에 대한 간결하고 불변한 데이터 모델을 제공합니다.

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

CSV를 Excel 형식으로 C#에서 변환하는 방법은?

많은 비즈니스 워크플로는 고급 분석, 서식 지정 또는 배포를 위해 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 파일을 작성하고 처음부터 생성하는 방법도 배울 수 있습니다.

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 라이선스 페이지를 방문하십시오.

IronXL이 CSV 처리에 적합한 이유는?

IronXL은 C# CSV 파일을 읽는 작업을 번거로운 파싱 작업에서 간단한 작업으로 전환해줍니다. 이 라이브러리는 수동 파싱이 잘못 처리하는 일반적인 에지 케이스 -- 임베디드 컴마, 따옴표로 묶인 필드 내의 개행 문자, 일관되지 않은 구분 기호, 인코딩 변형 및 잘못된 행 --를 각 시나리오에 대한 사용자 정의 코드 없이 처리합니다. 한 번의 데이터 가져오기 필요가 있든, 아니면 매일 수천 개의 파일을 처리하는 프로덕션 파이프라인이 필요하든 간에, 동일한 API가 두 문맥 모두에 작동합니다.

매뉴얼 CSV 구문 분석은 string.Split 또는 StreamReader이 따옴표로 묶인 필드에 구분 문자나 줄 바꿈 문자가 나타날 때 빠르게 깨질 수 있습니다. IronXL은 따옴표로 묶인 필드 처리 및 이스케이프 시퀀스에 대한 CSV 규격을 따르므로 이것을 기본적으로 올바르게 처리합니다.

.NET 10에서 CSV 작업을 위한 IronXL의 주요 장점은 다음과 같습니다:

• Office 의존성 없음: 서버 및 클라우드 배포는 Microsoft Office나 어떤 COM 상호 운용도 설치 필요 없이 작동합니다
• 사용자 정의 구분자: list구분 기호 매개변수를 통해 어떤 구분 문자나 문자열도 지원됩니다.
• 타입 안전한 셀 접근: StringValue, DecimalValue, IntValue, 및 DateTimeValue 접근자는 잘못된 데이터에 대해 예외를 발생시키지 않고 안전한 기본값을 반환합니다.
• 범위 작업: 행별 반복 없이 범위를 통하여 데이터 집계 및 질의
• 형식 변환: 한 워크플로에서 CSV를 로드하고 XLSX, XLS, PDF, 또는 다른 형식으로 저장
• DataSet 통합: 로드된 워크북을 ADO.NET 및 데이터베이스 작업을 위해 DataSet / Data탭le로 변환
• 크로스 플랫폼: Windows, Linux, macOS, Docker 및 클라우드 환경에서 변경 없이 실행

IronXL 문서 및 셀 서식 가이드는 서식, 수식 지원 및 고급 워크북 작업에 대한 추가 정보를 제공합니다.

CSV 파일을 자신 있게 처리할 준비가 되셨습니까? 무료 체험을 시작하고 전체 IronXL 기능 세트를 탐색해 보세요.