IronXL 사용하여 .NET 에서 CSV 파일을 작성하는 방법

왜 .NET 개발자들이 더 나은 CSV 솔루션이 필요한가요?

CSV 파일은 수많은 .NET 애플리케이션 전반에 걸쳐 데이터 교환을 가능하게 합니다 -- 그리고 표준 라이브러리 옵션은 실세계의 복잡성을 처리해야 할 때 종종 부족합니다. 금융 보고서에서 재고 시스템에 이르기까지, 몇 줄의 코드만으로 프로그래밍 방식으로 CSV 파일을 생성할 수 있습니다. CsvHelper와 같은 라이브러리는 기본적인 CSV 작업을 다루지만, 현대 개발자는 엑셀 워크북 변환, 내보내기 시 데이터 형식 보존, Enterprise 등급의 스프레드시트 워크플로우 처리와 같은 복잡한 시나리오에 직면합니다. IronXL은 신뢰할 수 있는 CSV 작성과 전체 Excel 기능을 통합한 단일, 종속성 없는 라이브러리를 제공함으로써 이러한 문제를 해결하며, RFC 4180 표준을 따릅니다.

이것은 여러 열, 행별 처리 로직, 자동으로 추론된 구분자를 지원하는 맞춤 .NET CSV 작성기 또는 .NET CSV 파서를 구축하는 개발자에게 이상적입니다. 이 튜토리얼은 IronXL의 CSV 기능을 통한 파일 생성의 기본부터 기업 규모의 데이터 내보내기에 이르기까지 안내합니다.

IronXL을 설치하고 설정하는 방법은?

IronXL은 NuGet 패키지 관리자를 통해 몇 초 만에 설치됩니다. 패키지 관리자 콘솔 또는 .NET CLI 중 하나를 사용할 수 있습니다:

Install-Package IronXL
dotnet add package IronXL

Install-Package IronXL
dotnet add package IronXL

설치 후, IronXL 네임스페이스를 추가하고 즉시 CSV 파일 작성을 시작하십시오. 다음 예제는 워크북을 생성하고 데이터를 채우고, .NET 10의 최상위 명령문을 사용하여 CSV로 내보내는 방법을 보여줍니다:

using IronXL;

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

// Add headers
workSheet["A1"].Value = "Product";
workSheet["B1"].Value = "Quantity";
workSheet["C1"].Value = "Price";

// Add data rows
workSheet["A2"].Value = "Widget";
workSheet["B2"].Value = 100;
workSheet["C2"].Value = 19.99;

workSheet["A3"].Value = "Gadget";
workSheet["B3"].Value = 250;
workSheet["C3"].Value = 34.50;

workSheet["A4"].Value = "Component";
workSheet["B4"].Value = 75;
workSheet["C4"].Value = 8.99;

// Save as CSV with comma delimiter
workBook.SaveAsCsv("inventory.csv", ",");

using IronXL;

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

// Add headers
workSheet["A1"].Value = "Product";
workSheet["B1"].Value = "Quantity";
workSheet["C1"].Value = "Price";

// Add data rows
workSheet["A2"].Value = "Widget";
workSheet["B2"].Value = 100;
workSheet["C2"].Value = 19.99;

workSheet["A3"].Value = "Gadget";
workSheet["B3"].Value = 250;
workSheet["C3"].Value = 34.50;

workSheet["A4"].Value = "Component";
workSheet["B4"].Value = 75;
workSheet["C4"].Value = 8.99;

// Save as CSV with comma delimiter
workBook.SaveAsCsv("inventory.csv", ",");

이 간단한 프로그램은 C# 코드에서 직접 CSV 내용을 작성하여 데이터를 보유하는 WorkBook 객체를 만드는 방법을 보여줍니다. SaveAsCsv 메서드는 콤마를 기본 구분자로 사용하지만 해당 구분자로 모든 문자를 지정할 수 있습니다 -- 쉼표나 탭이 표준 열 구분자인 지역별 시나리오에 유용합니다.

using IronXL;

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

workSheet["A1"].Value = "Region";
workSheet["B1"].Value = "Revenue";
workSheet["C1"].Value = "Units";

workSheet["A2"].Value = "Europe";
workSheet["B2"].Value = "1250000.50";
workSheet["C2"].Value = 3400;

workSheet["A3"].Value = "아니요rth America";
workSheet["B3"].Value = "2800000.00";
workSheet["C3"].Value = 7200;

// Semicolon delimiter for European locales
workBook.SaveAsCsv("sales_europe.csv", ";");

// Tab delimiter for TSV output
workBook.SaveAsCsv("sales_tsv.tsv", "\t");

using IronXL;

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

workSheet["A1"].Value = "Region";
workSheet["B1"].Value = "Revenue";
workSheet["C1"].Value = "Units";

workSheet["A2"].Value = "Europe";
workSheet["B2"].Value = "1250000.50";
workSheet["C2"].Value = 3400;

workSheet["A3"].Value = "아니요rth America";
workSheet["B3"].Value = "2800000.00";
workSheet["C3"].Value = 7200;

// Semicolon delimiter for European locales
workBook.SaveAsCsv("sales_europe.csv", ";");

// Tab delimiter for TSV output
workBook.SaveAsCsv("sales_tsv.tsv", "\t");

Excel 워크북을 CSV로 변환하는 방법은?

using IronXL;

// Load an Excel file with formulas and formatting
WorkBook workBook = WorkBook.Load("financial_report.xlsx");

// Evaluate all formulas before export so calculated values appear in CSV
workBook.EvaluateAll();

// Export to CSV -- each worksheet creates a separate CSV file
// Creates: report.Sheet1.csv, report.Sheet2.csv, etc.
workBook.SaveAsCsv("report.csv", ",");

using IronXL;

// Load an Excel file with formulas and formatting
WorkBook workBook = WorkBook.Load("financial_report.xlsx");

// Evaluate all formulas before export so calculated values appear in CSV
workBook.EvaluateAll();

// Export to CSV -- each worksheet creates a separate CSV file
// Creates: report.Sheet1.csv, report.Sheet2.csv, etc.
workBook.SaveAsCsv("report.csv", ",");

DataTable을 CSV로 어떻게 내보내나요?

데이터베이스 기반 애플리케이션의 경우 IronXL은 DataTable 내보내기를 간단하게 만듭니다. 다음 예는 모의 데이터 소스에서 DataTable을 읽어 세미콜론 구분자를 사용하여 CSV로 작성합니다:

using System.Data;
using IronXL;

// Simulate a DataTable from a database query
DataTable dataTable = GetSalesData();

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

// Write column headers from DataTable schema
for (int col = 0; col < dataTable.Columns.Count; col++)
{
    workSheet.SetCellValue(0, col, dataTable.Columns[col].ColumnName);
}

// Write data rows
int row = 1;
foreach (DataRow dataRow in dataTable.Rows)
{
    for (int col = 0; col < dataTable.Columns.Count; col++)
    {
        workSheet.SetCellValue(row, col, dataRow[col]?.ToString() ?? string.Empty);
    }
    row++;
}

// Export with semicolon delimiter for European compatibility
workBook.SaveAsCsv("sales_data.csv", ";");

using System.Data;
using IronXL;

// Simulate a DataTable from a database query
DataTable dataTable = GetSalesData();

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

// Write column headers from DataTable schema
for (int col = 0; col < dataTable.Columns.Count; col++)
{
    workSheet.SetCellValue(0, col, dataTable.Columns[col].ColumnName);
}

// Write data rows
int row = 1;
foreach (DataRow dataRow in dataTable.Rows)
{
    for (int col = 0; col < dataTable.Columns.Count; col++)
    {
        workSheet.SetCellValue(row, col, dataRow[col]?.ToString() ?? string.Empty);
    }
    row++;
}

// Export with semicolon delimiter for European compatibility
workBook.SaveAsCsv("sales_data.csv", ";");

$vbLabelText   $csharpLabel

DataTable에서 가져올 때, dataTable.Rows 컬렉션의 각 행이 워크시트의 새 행이 됩니다. IronXL은 변환 중 데이터 유형을 보존합니다 -- 숫자는 숫자 그대로 유지되고, 날짜는 포맷을 유지하며, 텍스트는 특별 문자를 추가 구성 없이 처리합니다.

산출

여기에서 모의 데이터 소스가 출력 CSV 파일 옆에 있는 것을 볼 수 있습니다:

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

무료로 시작하세요

IronXL과 CsvHelper를 비교하여 CSV 파일을 작성하는 방법은?

두 라이브러리를 통한 CSV 작성 워크플로우를 보여주는 이 직원 데이터 내보내기 시나리오를 고려해보세요.

CsvHelper 구현:

using System.Globalization;
using System.IO;
using CsvHelper;

using var writer = new StreamWriter("employees.csv");
using var csv = new CsvWriter(writer, CultureInfo.InvariantCulture);
csv.WriteRecords(employees);

using System.Globalization;
using System.IO;
using CsvHelper;

using var writer = new StreamWriter("employees.csv");
using var csv = new CsvWriter(writer, CultureInfo.InvariantCulture);
csv.WriteRecords(employees);

IronXL 구현:

using IronXL;

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

int rowIndex = 1;
foreach (var emp in employees)
{
    workSheet[$"A{rowIndex}"].Value = emp.Name;
    workSheet[$"B{rowIndex}"].Value = emp.Salary;
    workSheet[$"C{rowIndex}"].Value = emp.StartDate;
    rowIndex++;
}

workBook.SaveAsCsv("employees.csv", ",");

using IronXL;

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

int rowIndex = 1;
foreach (var emp in employees)
{
    workSheet[$"A{rowIndex}"].Value = emp.Name;
    workSheet[$"B{rowIndex}"].Value = emp.Salary;
    workSheet[$"C{rowIndex}"].Value = emp.StartDate;
    rowIndex++;
}

workBook.SaveAsCsv("employees.csv", ",");

CsvHelper는 POCO 객체의 직렬화를 효율적으로 처리합니다. IronXL은 기존 Excel 파일을 로드하거나, 내보내기 전에 수식을 평가하거나, 워크시트 범위를 세밀하게 제어해야 할 때 추가 기능을 제공합니다. 워크플로우에 비즈니스 사용자로부터 .xlsx 파일을 받아 다운스트림 시스템을 위해 CSV로 변환하는 것이 포함될 경우, IronXL은 파이프라인에서 전체 변환 단계를 제거합니다.

CSV 내보내기를 위해 IronXL이 제공하는 Enterprise 기능은 무엇인가요?

IronXL의 SaveAsCsv 메서드는 여러 프로덕션 준비 기능을 함께 제공합니다:

CSV 출력에 숫자, 통화 및 날짜가 어떻게 표시되는지를 제어하기 위해 셀 데이터 서식을 적용할 수 있습니다. 대량의 데이터 세트를 처리할 때 워크시트 범위 연산을 사용하여 데이터를 청크에서 처리하여 메모리 사용량을 예측할 수 있게 합니다.

크로스 플랫폼 지원은 IronXL 기반 CSV 생성기를 Kubernetes나 Azure App Service의 Linux 컨테이너에 코드 변경 없이 배포할 수 있음을 의미합니다. 라이브러리는 관리되지 않는 종속성을 포함하지 않으므로 운영 체제에서 동일하게 실행됩니다. IronXL 플랫폼 호환성 가이드에서 지원되는 런타임에 대한 전체 세부 사항을 참조하십시오.

일반적인 CSV 내보내기 문제를 어떻게 처리하나요?

대규모로 CSV 내보내기를 할 때 몇 가지 예측 가능한 문제가 발생합니다. 여기에서는 각각을 해결하는 방법을 소개합니다:

데이터 내 특수 문자: IronXL은 셀 값 내의 따옴표, 쉼표 및 개행 문자를 자동으로 이스케이프합니다. 문자열을 사전 처리하거나 사용자 정의 이스케이프 로직을 작성할 필요가 없습니다. 라이브러리는 RFC 4180 인용 규칙을 내부적으로 처리합니다.

대용량 파일 처리: 수만 개의 행이 있는 워크북의 경우 워크시트 범위를 사용하여 데이터를 배치로 처리하세요. 최종 내보내기 전에 중간 시트에 쓰는 것은 메모리 할당을 제어할 수 있게 해줍니다.

인코딩 문제: 셀 값에서 국제 문자, 아시아어 스크립트 혹은 이모지를 처리할 때는 UTF-8 인코딩을 명시적으로 지정하세요. IronXL은 기본적으로 UTF-8 및 UTF-16 인코딩을 지원하므로 타사 인코딩 라이브러리가 필요하지 않습니다.

누락되거나 오타가 있는 데이터: IronXL은 기본적으로 숫자 및 날짜 포맷을 보존합니다. 셀에 누락된 데이터를 참조하는 수식이 포함된 경우, EvaluateAll()는 빈 텍스트를 조용히 출력하는 대신 오류 값으로 해결되어, 데이터 품질 문제를 파이프라인 초기에 드러냅니다.

구분자 충돌: 사용 중인 구분자가 데이터에 포함된 경우(예: 구분자로 쉼표를 사용할 때 $1,200.00를 포함하는 가격 필드), IronXL은 자동으로 RFC 4180 규칙에 따라 값을 큰따옴표로 감쌉니다.

자세한 안내를 원하시면 IronXL CSV 문서, API 참고 문서, 지원 리소스를 방문하세요.

IronXL로 CSV 파일을 어떻게 읽고 구문 분석합니까?

CSV 쓰기는 이야기의 절반에 불과합니다. IronXL은 또한 CSV 읽기 및 구문 분석을 처리하여 쉼표로 구분된 데이터를 쿼리, 필터링 및 변환할 수 있는 워크북 구조에 로드한 후 필요한 형식으로 내보낼 수 있습니다.

using IronXL;

// Load an existing CSV file into a workbook
WorkBook workBook = WorkBook.Load("sales_data.csv");
WorkSheet workSheet = workBook.DefaultWorkSheet;

// Iterate over rows and process data
foreach (var row in workSheet.Rows)
{
    string product = row["A"].ToString();
    int quantity = row["B"].IntValue;
    decimal price = (decimal)row["C"].DoubleValue;

    Console.WriteLine($"Product: {product}, Qty: {quantity}, Price: {price:C}");
}

// Apply a filter and re-export to a new CSV
workBook.SaveAsCsv("filtered_output.csv", ",");

using IronXL;

// Load an existing CSV file into a workbook
WorkBook workBook = WorkBook.Load("sales_data.csv");
WorkSheet workSheet = workBook.DefaultWorkSheet;

// Iterate over rows and process data
foreach (var row in workSheet.Rows)
{
    string product = row["A"].ToString();
    int quantity = row["B"].IntValue;
    decimal price = (decimal)row["C"].DoubleValue;

    Console.WriteLine($"Product: {product}, Qty: {quantity}, Price: {price:C}");
}

// Apply a filter and re-export to a new CSV
workBook.SaveAsCsv("filtered_output.csv", ",");

IronXL을 통해 CSV 파일을 로드하면 워크시트 API에 전체 접근할 수 있으며, 여기에는 정렬, 필터링 및 수식 평가가 포함됩니다. 로드된 데이터를 Excel 파일로 저장할 수도 있으며, SaveAs를 사용하여 CSV를 한 번의 메서드 호출로 XLSX로 변환할 수 있습니다. 이는 보고서 생성 서비스를 구축할 때 일반적으로 필요합니다.

using IronXL;

WorkBook workBook = WorkBook.Load("input.xlsx");
WorkSheet workSheet = workBook.DefaultWorkSheet;

var errors = new List<string>();

for (int rowIdx = 1; rowIdx <= workSheet.RowCount; rowIdx++)
{
    string productName = workSheet[$"A{rowIdx}"].StringValue;
    double price = workSheet[$"C{rowIdx}"].DoubleValue;

    if (string.IsNullOrWhiteSpace(productName))
        errors.Add($"Row {rowIdx}: Product name is empty.");

    if (price <= 0)
        errors.Add($"Row {rowIdx}: Price must be greater than zero (found {price}).");
}

if (errors.Count == 0)
{
    workBook.SaveAsCsv("validated_output.csv", ",");
    Console.WriteLine("Export complete.");
}
else
{
    foreach (var error in errors)
        Console.WriteLine(error);
}

using IronXL;

WorkBook workBook = WorkBook.Load("input.xlsx");
WorkSheet workSheet = workBook.DefaultWorkSheet;

var errors = new List<string>();

for (int rowIdx = 1; rowIdx <= workSheet.RowCount; rowIdx++)
{
    string productName = workSheet[$"A{rowIdx}"].StringValue;
    double price = workSheet[$"C{rowIdx}"].DoubleValue;

    if (string.IsNullOrWhiteSpace(productName))
        errors.Add($"Row {rowIdx}: Product name is empty.");

    if (price <= 0)
        errors.Add($"Row {rowIdx}: Price must be greater than zero (found {price}).");
}

if (errors.Count == 0)
{
    workBook.SaveAsCsv("validated_output.csv", ",");
    Console.WriteLine("Export complete.");
}
else
{
    foreach (var error in errors)
        Console.WriteLine(error);
}

IronXL로 CSV 쓰기를 시작하려면 어떻게 해야 합니까?

IronXL은 CSV 읽기를 구문 분석의 난제로부터 직접적인 작업으로 변환합니다. CSV 기능을 Excel 워크북 지원, 수식 평가, 자동 타입 처리와 결합함으로써 여러 라이브러리를 관리하거나 수동으로 데이터를 변환하는 복잡성을 제거합니다.

무료 체험판에서는 모든 기능을 완전하게 사용할 수 있으며, 개발 중에는 라이선스 키가 필요하지 않습니다. 멀티시트 내보내기, 수식 평가 및 크로스 플랫폼 배포가 포함됩니다. 프로덕션 단계로 이동할 준비가 되면 라이선싱은 상용 사용을 커버하는 단일 개발자 계층에서 시작됩니다.

시작하기 위한 주요 자료:

• IronXL 문서 -- 전체 API 참고 및 사용 방법 가이드
• CSV에서 Excel로 변환 가이드 -- 형식 변환에 대한 자세한 안내
• DataTable 내보내기 튜토리얼 -- 데이터베이스 기반 내보내기 패턴
• 워크시트 범위 작업 -- 대용량 데이터 세트를 효율적으로 처리
• 문제 해결 가이드 -- 일반적인 통합 문제에 대한 해결책

프로덕션 준비가 된 CSV 워크플로우를 구축할 준비가 되셨습니까? 무료 체험판을 시작하여 5분 이내에 첫 번째 CSV 내보내기를 실행하세요.