C# CSV 라이브러리: IronXL 활용한 완벽 튜토리얼

C# 스프레드시트 라이브러리를 어떻게 설정하나요?

IronXL 설치는 NuGet을 통해 1분이 채 걸리지 않습니다. Visual Studio에서 패키지 관리자 콘솔을 열고 아래 명령을 실행하거나, 터미널에서 .NET CLI를 사용하세요:

Install-Package IronXL
dotnet add package IronXL

Install-Package IronXL
dotnet add package IronXL

Install-Package 후, 스프레드시트 데이터를 다루고자 하는 파일에 네임스페이스를 추가하세요:

using IronXL;

using IronXL;

IronXL은 .NET Framework 4.6.2+ 및 모든 현대 .NET 버전(코어, 5, 6, 7, 8, 9, 10)을 타겟으로 합니다. Windows, Linux, macOS에서 작동하여 데스크톱 도구와 컨테이너화된 서버 워크로드 모두에 적합합니다. IronXL 설치 가이드를 방문하여 패키지 소스 및 라이선스 활성화를 다루는 단계별 지침을 확인하세요.

C#에서 CSV 파일을 어떻게 읽나요?

IronXL로 CSV 파일을 읽는 것은 스프레드시트를 로드하는 것과 같은 패턴을 따릅니다. 파일 경로를 WorkBook.Load로 호출하면 IronXL이 확장자에서 형식을 추론합니다 -- 추가 설정이 필요하지 않습니다:

// Load a CSV file into a WorkBook
WorkBook workBook = WorkBook.Load("sales_data.csv");

// Access the default worksheet
WorkSheet workSheet = workBook.DefaultWorkSheet;

// Read individual cells by Excel-style address
string customerName = workSheet["A2"].StringValue;
decimal orderAmount = workSheet["B2"].DecimalValue;

// Iterate rows, starting at index 1 to skip the header
for (int i = 1; i < workSheet.Rows.Count(); i++)
{
    var row = workSheet.Rows[i];
    Console.WriteLine($"Customer: {row.Columns[0].Value}, Amount: {row.Columns[1].Value}");
}

// Load a CSV file into a WorkBook
WorkBook workBook = WorkBook.Load("sales_data.csv");

// Access the default worksheet
WorkSheet workSheet = workBook.DefaultWorkSheet;

// Read individual cells by Excel-style address
string customerName = workSheet["A2"].StringValue;
decimal orderAmount = workSheet["B2"].DecimalValue;

// Iterate rows, starting at index 1 to skip the header
for (int i = 1; i < workSheet.Rows.Count(); i++)
{
    var row = workSheet.Rows[i];
    Console.WriteLine($"Customer: {row.Columns[0].Value}, Amount: {row.Columns[1].Value}");
}

WorkBook 객체는 전체 스프레드시트 모델을 노출합니다. 셀에 접근할 때 "A2"와 같은 친숙한 Excel 표기법을 사용하며, StringValue, DecimalValue, IntValue, DateTimeValue 등의 내장 변환 속성이 타입 강제를 처리하기 때문에 문자열을 수동으로 파싱할 필요가 없습니다.

// Access a range and print each value
foreach (var cell in workSheet["A2:C10"])
{
    Console.WriteLine($"{cell.AddressString}: {cell.Value}");
}

// Access a range and print each value
foreach (var cell in workSheet["A2:C10"])
{
    Console.WriteLine($"{cell.AddressString}: {cell.Value}");
}

public record SalesRecord(string Customer, decimal Amount, DateTime OrderDate);

WorkBook workBook = WorkBook.Load("sales_data.csv");
WorkSheet workSheet = workBook.DefaultWorkSheet;

var records = new List<SalesRecord>();

// Start at row 1 to skip the header row (row 0)
for (int i = 1; i < workSheet.Rows.Count(); i++)
{
    var row = workSheet.Rows[i];
    records.Add(new SalesRecord(
        Customer: row.Columns[0].StringValue,
        Amount: row.Columns[1].DecimalValue,
        OrderDate: row.Columns[2].DateTimeValue
    ));
}

public record SalesRecord(string Customer, decimal Amount, DateTime OrderDate);

WorkBook workBook = WorkBook.Load("sales_data.csv");
WorkSheet workSheet = workBook.DefaultWorkSheet;

var records = new List<SalesRecord>();

// Start at row 1 to skip the header row (row 0)
for (int i = 1; i < workSheet.Rows.Count(); i++)
{
    var row = workSheet.Rows[i];
    records.Add(new SalesRecord(
        Customer: row.Columns[0].StringValue,
        Amount: row.Columns[1].DecimalValue,
        OrderDate: row.Columns[2].DateTimeValue
    ));
}

C#에서 CSV 파일을 어떻게 쓰나요?

CSV 파일을 처음부터 생성하려면 WorkBook 생성을 포함한 세 단계가 필요합니다, WorkSheet을 채우고, SaveAsCsv를 호출합니다. 이 과정은 스프레드시트를 생성하는 방식과 마찬가지로 모든 출력 형식에 대해 API를 일관되게 유지합니다:

// Create a new workbook and worksheet
WorkBook workBook = WorkBook.Create();
WorkSheet workSheet = workBook.CreateWorkSheet("inventory");

// Write header row
workSheet["A1"].Value = "Product";
workSheet["B1"].Value = "Quantity";
workSheet["C1"].Value = "Price";

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

workSheet["A3"].Value = "Gadget B";
workSheet["B3"].Value = 120;
workSheet["C3"].Value = 24.50;

// Export to CSV
workBook.SaveAsCsv("inventory.csv");

// Create a new workbook and worksheet
WorkBook workBook = WorkBook.Create();
WorkSheet workSheet = workBook.CreateWorkSheet("inventory");

// Write header row
workSheet["A1"].Value = "Product";
workSheet["B1"].Value = "Quantity";
workSheet["C1"].Value = "Price";

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

workSheet["A3"].Value = "Gadget B";
workSheet["B3"].Value = 120;
workSheet["C3"].Value = 24.50;

// Export to CSV
workBook.SaveAsCsv("inventory.csv");

SaveAsCsv는 구분자 배치, 콤마가 포함된 필드의 인용, 그리고 새 줄 정규화를 처리합니다. 이 모든 것을 수동으로 관리할 필요가 없습니다. IronXL은 내보내기 중에 숫자 타입을 보존하여 Excel이나 pandas와 같은 다운스트림 도구가 숫자를 숫자로 읽고, 인용된 텍스트 문자열로 읽지 않도록 합니다.

DataTable dataTable = GetProductsFromDatabase();

WorkBook workBook = WorkBook.Create();
WorkSheet workSheet = workBook.CreateWorkSheet("products");

workSheet.InsertDataTable(dataTable, "A1");

workBook.SaveAsCsv("products.csv");

DataTable dataTable = GetProductsFromDatabase();

WorkBook workBook = WorkBook.Create();
WorkSheet workSheet = workBook.CreateWorkSheet("products");

workSheet.InsertDataTable(dataTable, "A1");

workBook.SaveAsCsv("products.csv");

C#에서 CSV와 Excel 간의 변환 방법은 무엇입니까?

IronXL이 제공하는 가장 가치 있는 기능 중 하나는 CSV와 Excel 형식 간의 양방향 변환입니다. API는 대칭적입니다 -- Load는 모든 지원 형식을 읽고 Save 메서드 그룹은 대상 형식으로 작성합니다:

// Convert CSV to Excel
WorkBook csvWorkBook = WorkBook.Load("data.csv");
csvWorkBook.SaveAs("data.xlsx");

// Convert Excel back to CSV
WorkBook xlsxWorkBook = WorkBook.Load("report.xlsx");
xlsxWorkBook.SaveAsCsv("report.csv");

// Convert CSV to Excel
WorkBook csvWorkBook = WorkBook.Load("data.csv");
csvWorkBook.SaveAs("data.xlsx");

// Convert Excel back to CSV
WorkBook xlsxWorkBook = WorkBook.Load("report.xlsx");
xlsxWorkBook.SaveAsCsv("report.csv");

이러한 변환은 데이터 무결성을 유지합니다. 숫자 값은 숫자로 유지되며, 날짜 필드는 그들의 유형을 유지하며, 수식 결과는 작성 전에 계산된 값으로 평가됩니다. IronXL이 엑셀 파일을 CSV로 변환할 때, 각 워크시트에 대해 별도의 CSV 파일을 자동으로 생성합니다:

WorkBook multiSheetWorkBook = WorkBook.Load("quarterly_report.xlsx");

// Produces: quarterly_report.Sheet1.csv, quarterly_report.Sheet2.csv, etc.
multiSheetWorkBook.SaveAsCsv("quarterly_report.csv");

WorkBook multiSheetWorkBook = WorkBook.Load("quarterly_report.xlsx");

// Produces: quarterly_report.Sheet1.csv, quarterly_report.Sheet2.csv, etc.
multiSheetWorkBook.SaveAsCsv("quarterly_report.csv");

이 동작은 하류 소비자가 파일당 한 주제를 기대하는 보고 파이프라인에 특히 유용합니다. CSV 쓰기 튜토리얼은 구분 문자 지정 및 내보낼 시트 선택과 같은 추가 옵션을 다룹니다.

지금 바로 IronXL으로 시작하세요.

무료로 시작하세요

CSV 전용 라이브러리가 실제 프로젝트에서 왜 부족합니까?

많은 C# 개발자들은 CsvHelper 또는 Microsoft.VisualBasic의 텍스트필드파서를 시작으로 사용합니다. 둘 다 CSV 전용 워크플로우에 적합한 도구입니다. 요구 사항이 확장될 때 격차가 나타납니다: 이해관계자가 잘못된 CSV 대신 Excel 다운로드를 요청하거나, 금융 부문에서 수식을 유지해야 하며, 보안 정책이 암호로 보호된 파일을 요구합니다. 그 시점에서, CSV 전용 라이브러리는 두 번째 종속성을 추가하고 두 가지 별도의 통합 경로를 유지해야 합니다. 통합 스프레드시트 라이브러리는 처음부터 이러한 분할을 제거합니다.

다음 단계는 무엇입니까?

IronXL은 모든 .NET 10 응용 프로그램에서 CSV 및 Excel 파일을 읽고, 쓰고, 변환하기 위한 단일, 일관된 API를 제공합니다. 주요 이점은 명확합니다: Office 종속성 없음, 크로스 플랫폼 지원, 셀 값에 대한 강력한 타입 지정, 및 요구 사항이 변경될 때 CSV 전용 프로젝트에서 전체 스프레드시트 기능으로 직접 경로를 제공합니다.

더 깊이 들어갈 준비가 되면, 현재 프로젝트와 가장 관련 있는 주제부터 시작하십시오. CSV 가져오기 파이프라인을 주로 다루는 경우 위에서 설명된 읽기 및 매핑 패턴이 실제 시나리오의 대부분을 처리합니다. 출력 요구 사항이 다양할 경우, 즉 다운스트림 스크립트용 CSV, 최종 사용자용 XLSX와 같이 형식 변환 섹션은 단일 코드베이스로 두 가지를 모두 제공하는 방법을 보여줍니다.

보고 시스템을 구축하거나 데이터베이스에서 결과를 내보내는 팀의 경우, InsertDataTable 접근 방식은 확장에 적합하며 행별 셀 할당의 성능 부하를 피할 수 있습니다. 셀 스타일링과 결합하여 사용자가 Excel에서 직접 열 수 있는 보고서를 생성합니다.

다음 단계를 따르십시오:

1. Install-Package IronXL 또는 dotnet add package IronXL을 사용하여 NuGet을 통해 라이브러리 설치를 진행합니다.
2. IronXL 시작 가이드의 퀵스타트를 따라 첫 번째 CSV 파일을 로드합니다.
3. 동일 프로젝트에서 두 형식이 모두 필요할 때 CSV에서 Excel로 튜토리얼을 통해 형식 변환을 탐색합니다.
4. 고급 셀 작업, 수식 지원, 스타일링에 대한 IronXL 객체 참조에서 API 참조를 검토하세요.
5. IronXL 체험판 라이선스 페이지에서 무료 체험을 시작하세요 -- 신용카드 불필요, 기술 지원 포함.

Iron Software의 다른 도구와 함께 옵션을 평가하는 경우, IronSoftware 제품군은 IronPDF를 통한 PDF 생성, 바코드 읽기, OCR 등 다양한 기능을 포함합니다 -- 모든 제품이 동일한 라이선스 모델과 지원 채널을 공유합니다.