IronXL 에서 .NET Core CSV 리더를 사용하는 방법: 실제 예제

왜 IronXL을 .NET Core CSV 리더로 선택해야 하는가?

.NET Core CSV 리더를 선택할 때, IronXL은 전통적인 CSV 구문 분석 라이브러리보다 여러 매력적인 이점을 제공합니다. IronXL은 .NET Core의 현대적인 아키텍처와 통합되며, .NET Framework 프로젝트와의 하위 호환성을 유지합니다. 이 솔루션은 CSV 파일 작업 시 개발자가 겪는 일반적인 고통점을 제거합니다:

• 국제 문자 세트를 위한 자동 인코딩 감지
• 수동 구성 없이 지능형 구분 기호 인식
• 킬로바이트에서 기가바이트에 이르는 파일에 대한 메모리 효율적인 처리
• 내장 데이터 유형 추론 및 변환
• 플랫폼 간 캐리지 리턴 및 줄 바꿈 처리
• CSV 데이터 작업 시에도 Excel 공식 지원
• 윈도우, 리눅스, macOS에서의 크로스 플랫폼 신뢰성

광범위한 구성 및 수동 구문 분석 논리가 필요한 기본 CSV 리더와 달리, IronXL은 구분 기호가 있는 인용 필드, 여러 줄 셀 값 및 특수 문자가 포함된 엣지 케이스를 자동으로 처리합니다. 라이브러리의 아키텍처는 레이지 로딩 및 스트리밍 기능을 통해 최적의 성능을 보장하여, 작은 구성 파일 및 대규모 데이터 처리 작업 모두에 적합합니다. IronXL은 필요할 때 헤더 행을 건너뛰고 복잡한 데이터 구조를 효율적으로 분할할 수 있습니다. IronXL 기능 개요에서 자세히 알아보십시오.

레거시 시스템에서 전환하는 개발자에게 IronXL은 익숙한 API를 제공하여 학습 곡선을 줄이는 동시에 반응형 응용 프로그램을 위한 현대적인 비동기/대기 패턴을 제공합니다. 이것은 데이터 처리 인프라를 현대화하는 팀에게 이상적인 선택입니다. API 참조와 구성 옵션에 대한 정보는 IronXL 문서를 참조하세요.

IronXL를 CSV 파일 읽기에 설치하는 방법?

IronXL를 .NET Core 프로젝트에 설치하는 데는 콘솔 애플리케이션, ASP.NET Core 웹 앱 또는 Windows Forms 애플리케이션을 빌드할 때 몇 초밖에 걸리지 않습니다. .NET Core에서 CSV 파일을 효율적으로 구문 분석하고 CSV 데이터를 읽기 시작하려면 Visual Studio의 패키지 관리자 콘솔을 열고 다음을 실행하세요:

Install-Package IronXl.Excel

Install-Package IronXl.Excel

또는 .NET CLI를 사용하세요:

dotnet add package IronXl.Excel

dotnet add package IronXl.Excel

또한, NuGet 패키지 관리자 UI를 사용하여 "IronXl.Excel"을 검색하고 설치를 클릭할 수 있습니다. 이 라이브러리는 .NET Core로 마이그레이션 중인 기존 .NET Framework 프로젝트와 통합됩니다. IronXL NuGet 페이지에서 직접 참조할 수도 있습니다.

설치 후 네임스페이스를 코드에 추가하세요:

using IronXL;

using IronXL;

이 설정은 Microsoft Office나 Interop 종속성이 필요 없이 강력한 CSV 읽기 기능을 제공하여 클라우드 배포 및 Docker 컨테이너에 이상적입니다. 자세한 설치 지침과 구성 설정은 IronXL 설치 가이드 문서를 참조하세요.

IronXL의 LoadCSV 메소드를 사용하여 CSV 파일을 읽는 방법?

IronXL은 CSV 파일 처리를 LoadCSV 메소드를 통해 간단하게 처리하며, CSV 헤더, CSV 열, CSV 행을 효율적으로 다룹니다. 아래 예제가 이를 보여줍니다:

// Load CSV file into a WorkBook object for .NET Core CSV reading
var workbook = WorkBook.LoadCSV("Budget.csv",
    fileFormat: ExcelFileFormat.XLSX,
    listDelimiter: ",");
// Access the default worksheet containing parsed CSV data
WorkSheet worksheet = workbook.DefaultWorkSheet;
// Read specific cell values with type-safe methods
string cellValue = worksheet["A1"].StringValue;
// Iterate through a range for bulk CSV data processing
foreach (var cell in worksheet["A1:C10"])
{
    Console.WriteLine($"Cell {cell.AddressString}: {cell.Text}");
}

// Load CSV file into a WorkBook object for .NET Core CSV reading
var workbook = WorkBook.LoadCSV("Budget.csv",
    fileFormat: ExcelFileFormat.XLSX,
    listDelimiter: ",");
// Access the default worksheet containing parsed CSV data
WorkSheet worksheet = workbook.DefaultWorkSheet;
// Read specific cell values with type-safe methods
string cellValue = worksheet["A1"].StringValue;
// Iterate through a range for bulk CSV data processing
foreach (var cell in worksheet["A1:C10"])
{
    Console.WriteLine($"Cell {cell.AddressString}: {cell.Text}");
}

LoadCSV 메소드는 최적화된 메모리 스트림 처리를 사용하여 메모리 내에서 CSV 데이터 구조를 나타내는 WorkBook 객체를 생성합니다. fileFormat 매개변수는 내부 처리 형식을 지정하고, listDelimiter 는 CSV 파일에서 사용되는 CSV 구분 기호를 정의하여 탭 구분 파일 및 파이프(|) 구분 형식을 지원합니다.

public record Customer(string Name, int Age, string City)
{
    public bool IsValid() => !string.IsNullOrEmpty(Name) && Age > 0;
}

// Parse CSV rows into typed objects
var customers = new List<Customer>();
for (int row = 2; row <= worksheet.RowCount; row++)
{
    var customer = new Customer(
        Name: worksheet[$"A{row}"].StringValue,
        Age:  worksheet[$"B{row}"].IntValue,
        City: worksheet[$"C{row}"].StringValue
    );
    if (customer.IsValid())
        customers.Add(customer);
}
// Output the records
foreach (var record in customers)
{
    Console.WriteLine($"Customer: {record.Name}, Age: {record.Age}, City: {record.City}");
}

public record Customer(string Name, int Age, string City)
{
    public bool IsValid() => !string.IsNullOrEmpty(Name) && Age > 0;
}

// Parse CSV rows into typed objects
var customers = new List<Customer>();
for (int row = 2; row <= worksheet.RowCount; row++)
{
    var customer = new Customer(
        Name: worksheet[$"A{row}"].StringValue,
        Age:  worksheet[$"B{row}"].IntValue,
        City: worksheet[$"C{row}"].StringValue
    );
    if (customer.IsValid())
        customers.Add(customer);
}
// Output the records
foreach (var record in customers)
{
    Console.WriteLine($"Customer: {record.Name}, Age: {record.Age}, City: {record.City}");
}

다양한 구분자를 처리하고 DataTable로 변환하는 방법?

실제 CSV 파일 형식은 쉼표 이외의 다양한 구분자를 사용하는 경우가 많아 유연한 처리가 필요합니다. IronXL는 자동 구분자 감지로 이를 우아하게 관리합니다:

// Load CSV with semicolon delimiter
WorkBook workbook = WorkBook.LoadCSV("products.csv",
    fileFormat: ExcelFileFormat.XLSX,
    listDelimiter: ";");
WorkSheet worksheet = workbook.DefaultWorkSheet;
// Convert to DataTable for database operations
DataTable dataTable = worksheet.ToDataTable(true);
// Process the DataTable
foreach (DataRow row in dataTable.Rows)
{
    Console.WriteLine($"Product: {row["ProductName"]}, Price: {row["Price"]}");
}

// Load CSV with semicolon delimiter
WorkBook workbook = WorkBook.LoadCSV("products.csv",
    fileFormat: ExcelFileFormat.XLSX,
    listDelimiter: ";");
WorkSheet worksheet = workbook.DefaultWorkSheet;
// Convert to DataTable for database operations
DataTable dataTable = worksheet.ToDataTable(true);
// Process the DataTable
foreach (DataRow row in dataTable.Rows)
{
    Console.WriteLine($"Product: {row["ProductName"]}, Price: {row["Price"]}");
}

ToDataTable 메소드는 워크시트 데이터를 .NET DataTable로 변환하며, 첫째 행을 열 헤더로 사용할지를 나타내는 부울 매개변수가 있습니다. 이 변환은 특히 데이터베이스 작업, ASP.NET Core 애플리케이션에서의 데이터 바인딩 또는 SQL Server 통합을 위한 기존 DataTable 처리 로직을 적용할 때 유용합니다. 결과 DataTable는 데이터 유형 및 스키마 정보를 유지하며, 효율적인 대량 삽입 작업을 위해 SqlBulkCopy와 직접 사용할 수 있습니다.

CSV를 DataTable로 가져오기 및 데이터베이스 통합에 대한 자세한 가이드를 참조하여 더 많은 정보를 얻으세요.

// Load a DataTable from your data source
DataTable exportTable = GetProcessedData(); // your data source method

// Create a new workbook and populate it from the DataTable
WorkBook outputWorkbook = WorkBook.Create(ExcelFileFormat.XLSX);
WorkSheet outputSheet = outputWorkbook.DefaultWorkSheet;

// Write headers from DataTable columns
for (int col = 0; col < exportTable.Columns.Count; col++)
{
    outputSheet[0, col].Value = exportTable.Columns[col].ColumnName;
}

// Write rows
for (int row = 0; row < exportTable.Rows.Count; row++)
{
    for (int col = 0; col < exportTable.Columns.Count; col++)
    {
        outputSheet[row + 1, col].Value = exportTable.Rows[row][col]?.ToString();
    }
}

// Save as CSV
outputWorkbook.SaveAsCsv("output.csv", delimiter: ",");
Console.WriteLine("Export complete.");

// Load a DataTable from your data source
DataTable exportTable = GetProcessedData(); // your data source method

// Create a new workbook and populate it from the DataTable
WorkBook outputWorkbook = WorkBook.Create(ExcelFileFormat.XLSX);
WorkSheet outputSheet = outputWorkbook.DefaultWorkSheet;

// Write headers from DataTable columns
for (int col = 0; col < exportTable.Columns.Count; col++)
{
    outputSheet[0, col].Value = exportTable.Columns[col].ColumnName;
}

// Write rows
for (int row = 0; row < exportTable.Rows.Count; row++)
{
    for (int col = 0; col < exportTable.Columns.Count; col++)
    {
        outputSheet[row + 1, col].Value = exportTable.Rows[row][col]?.ToString();
    }
}

// Save as CSV
outputWorkbook.SaveAsCsv("output.csv", delimiter: ",");
Console.WriteLine("Export complete.");

CSV와 Excel 형식 간의 변환은 어떻게 합니까?

IronXL의 뛰어난 기능 중 하나는 CSV에서 Excel로의 변환과 Excel에서 CSV로의 변환이며, 데이터 마이그레이션 프로젝트에서 필수적입니다. 다음 예제는 이 기능을 보여줍니다:

// Load CSV and save as Excel
WorkBook csvWorkbook = WorkBook.LoadCSV("report.csv",
    fileFormat: ExcelFileFormat.XLSX,
    listDelimiter: ",");
// Save as Excel file
csvWorkbook.SaveAs("report.xlsx");
// Or load Excel and export to CSV
WorkBook excelWorkbook = WorkBook.Load("data.xlsx");
excelWorkbook.SaveAsCsv("exported_data.csv", delimiter: ",");

// Load CSV and save as Excel
WorkBook csvWorkbook = WorkBook.LoadCSV("report.csv",
    fileFormat: ExcelFileFormat.XLSX,
    listDelimiter: ",");
// Save as Excel file
csvWorkbook.SaveAs("report.xlsx");
// Or load Excel and export to CSV
WorkBook excelWorkbook = WorkBook.Load("data.xlsx");
excelWorkbook.SaveAsCsv("exported_data.csv", delimiter: ",");

이 양방향 변환은 데이터 무결성을 유지하면서 다양한 파일 변환 시나리오에 대한 형식 유연성을 제공합니다. SaveAs 메소드는 파일 확장자에서 원하는 형식을 자동으로 감지하여, XLSX, XLS 및 기타 Excel 형식을 지원하며 워크시트 관리 기능을 제공합니다. SaveAsCsv를 사용하여 CSV로 저장할 때, 사용자 지정 구분자 및 텍스트 인코딩을 지정하여 요구 사항에 맞출 수 있습니다.

이 기능은 특정 파일 형식을 데이터 교환을 위한 시스템과 통합하는 데 매우 유용합니다. 다른 라이브러리에서 마이그레이션하거나 수동 구문 분석 대안을 평가하는 개발자를 위해 Stack Overflow에서 논의된 인기 있는 대안과 .NET 커뮤니티의 성능 고려사항을 참조하세요. 더 많은 파일 형식 변환 패턴을 보려면 Excel 스프레드시트 변환 가이드를 방문하세요.

WorkBook workbook = WorkBook.LoadCSV("large-dataset.csv",
    fileFormat: ExcelFileFormat.XLSX,
    listDelimiter: ",");
WorkSheet worksheet = workbook.DefaultWorkSheet;

int batchSize = 1000;
int totalRows = worksheet.RowCount;

for (int start = 1; start <= totalRows; start += batchSize)
{
    int end = Math.Min(start + batchSize - 1, totalRows);
    for (int row = start; row <= end; row++)
    {
        string id   = worksheet[$"A{row}"].StringValue;
        string name = worksheet[$"B{row}"].StringValue;
        // Process each record here
        Console.WriteLine($"Row {row}: {id} - {name}");
    }
    Console.WriteLine($"Processed batch {start}-{end}");
}

WorkBook workbook = WorkBook.LoadCSV("large-dataset.csv",
    fileFormat: ExcelFileFormat.XLSX,
    listDelimiter: ",");
WorkSheet worksheet = workbook.DefaultWorkSheet;

int batchSize = 1000;
int totalRows = worksheet.RowCount;

for (int start = 1; start <= totalRows; start += batchSize)
{
    int end = Math.Min(start + batchSize - 1, totalRows);
    for (int row = start; row <= end; row++)
    {
        string id   = worksheet[$"A{row}"].StringValue;
        string name = worksheet[$"B{row}"].StringValue;
        // Process each record here
        Console.WriteLine($"Row {row}: {id} - {name}");
    }
    Console.WriteLine($"Processed batch {start}-{end}");
}

IronXL은 Enterprise CSV 처리에 대해 어떤 고급 기능을 제공하나요?

IronXL은 단위 테스트 지원 및 디버깅 도구를 포함하여 기본 CSV 파서와 차별화되는 Enterprise급 기능을 제공합니다. 이 라이브러리는 Windows, Linux, macOS 및 Docker 컨테이너에서 실행할 수 있는 크로스 플랫폼 호환성을 제공하여 현대적인 .NET Core 배포 및 마이크로서비스 아키텍처에 필수적입니다. Microsoft의 문서에 따르면, 크로스 플랫폼 지원은 클라우드 네이티브 애플리케이션과 Azure 배포에 필수적입니다.

기술적 기능을 넘어, IronXL은 최신 .NET 버전 및 보안 패치와의 호환성을 보장하는 모든 라이선스와 함께 전문 지원 및 정기 업데이트를 포함합니다. 이 상업적 지원은 운영 환경에서 오픈 소스 라이브러리가 부족할 수 있는 미션 크리티컬 애플리케이션의 신뢰성을 보장합니다. 이 라이브러리는 최적화된 메모리 관리를 통해 대용량 데이터 세트를 효율적으로 처리하며 다음과 같은 고급 시나리오를 지원합니다:

확장성과 부하 분산이 필요한 생산 배포를 위해 IronXL의 라이선스 모델은 단일 프로젝트, 팀, 기업 전체 사용에 대한 유연성을 제공합니다. 이 모든 옵션은 소스 코드 접근과 로열티 없는 재배포 권한을 포함합니다. 라이선스를 구입하세요 전체 기능을 워터마크 없이 사용할 수 있습니다.

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

// Then proceed with CSV reading as normal
WorkBook workbook = WorkBook.LoadCSV("data.csv",
    fileFormat: ExcelFileFormat.XLSX,
    listDelimiter: ",");
WorkSheet worksheet = workbook.DefaultWorkSheet;
Console.WriteLine($"Loaded {worksheet.RowCount} rows from CSV.");

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

// Then proceed with CSV reading as normal
WorkBook workbook = WorkBook.LoadCSV("data.csv",
    fileFormat: ExcelFileFormat.XLSX,
    listDelimiter: ",");
WorkSheet worksheet = workbook.DefaultWorkSheet;
Console.WriteLine($"Loaded {worksheet.RowCount} rows from CSV.");

무료 체험판으로 시작하는 방법은?

IronXL은 .NET Core 응용 프로그램에서 CSV 읽기 및 쓰기 작업을 단순화하면서 데이터 분석, 보고서 작성 및 자동화 작업을 포함한 복잡한 시나리오를 처리할 수 있는 유연성을 제공합니다. 직관적인 API와 Excel 형식 지원, 기업 기능이 결합되어 있어 스레드 안전성 및 동시 액세스 지원이 필요한 개발자들에게 검증된 CSV 처리 기능을 제공하는 신뢰할 수 있는 선택입니다. 이 라이브러리는 형식 간 변환, 다양한 구분자 처리, 데이터 정리 수행 및 기존 .NET 데이터 구조와 통합할 수 있는 기능을 제공하여 개발 시간을 크게 줄이면서도 코드의 유지 보수성을 유지합니다.

CSV 파일 처리를 시작할 준비가 되셨습니까? IronXL의 무료 체험판을 오늘 다운로드하여 라이브러리가 전문 등급의 CSV 구문 분석 기능으로 데이터 처리 워크플로우를 어떻게 변환하는지 경험해보세요. 프로덕션 사용을 위해 귀하의 .NET 프로젝트에 대해 전문 지원, 문서화 및 지속적인 업데이트가 포함된 라이센스 옵션을 탐색하세요.

추가 읽기 자료:

• C# 콘솔 애플리케이션에서 Excel 파일을 읽는 방법
• C# CSV 파일 생성 튜토리얼
• C#에서 DataTable을 Excel로 내보내기
• IronXL 객체 참조 API
• Linux, macOS, Docker, AWS에서 시작하기