C# CSV 읽기/쓰기: IronXL 사용하여 CSV 파일 생성, 내보내기 및 변환

CSV 형식이란 무엇이며 왜 중요한가?

CSV는 (Comma Separated Values) 파일로서 서로 다른 애플리케이션 간 테이블 형식 데이터를 저장하고 교환하는 데 가장 널리 사용되는 형식 중 하나입니다. 가장 단순한 형태로 CSV 파일은 각 행에 콤마로 구분된 일련의 값들을 포함하는 텍스트 파일입니다. 이 단순한 구조 덕분에 CSV 데이터를 다양한 소프트웨어 시스템에서 쉽게 생성하고 읽고 처리할 수 있습니다.

CSV 형식은 가볍고 사람이 읽을 수 있어 보고서 내보내기, 데이터베이스 간 데이터 전송, 분석 도구와의 통합을 위한 인기 있는 선택입니다. CSV 파일의 각 행은 하나의 레코드를 나타내며, 해당 행 내의 각 값은 콤마로 구분됩니다. 파일의 첫 번째 행은 일반적으로 각 열의 이름을 나열하는 헤더로 사용됩니다. 모든 후속 행은 실제 데이터를 포함하며, 각 값은 헤더의 열에 해당합니다.

CSV 파일이 구조화되는 방식을 이해하면 구분자 선택, 문자 이스케이프, 인코딩 등의 결정에 도움이 되며, 이러한 요소는 다운스트림 시스템이 출력 결과를 신뢰할 수 없는지를 결정합니다. CSV 파일 형식은 RFC 4180에 의해 정의되며, 필드 내 포함된 쉼표, 줄 바꿈 문자, 인용 문자열 값과 같은 경계 상황 처리에 대한 지침을 제공합니다.

IronXL을 .NET 프로젝트에 설치하는 방법은 무엇입니까?

IronXL을 새로운 프로젝트에 추가하는 데는 NuGet, Microsoft의 .NET 패키지 관리자를 통해 몇 초밖에 걸리지 않습니다. Visual Studio를 열고, NuGet 패키지 관리자 콘솔에 액세스한 후 다음 명령을 실행하세요.

Install-Package IronXl.Excel

C# Save to CSV Using IronXL: Image 1 - Installation

또는 솔루션 탐색기에서 프로젝트를 오른쪽 클릭하여 "NuGet 패키지 관리"를 선택하고, 찾아보기 탭에서 "IronXL"을 검색한 후 설치를 클릭하세요. IronXL은 .NET Framework 4.6.2+, .NET Core, .NET 5/6/7/8/10를 지원하며 외부 종속성이나 COM 상호 운용 요구 사항 없이 모든 플랫폼에서 실행됩니다.

설치 후, using 문을 사용하여 코드 파일에 IronXL 네임스페이스를 추가하세요:

using IronXL;

using IronXL;

이 단일 네임스페이스는 스프레드시트 생성 및 CSV 내보내기 작업에 필요한 모든 클래스에 액세스를 제공합니다. CSV 파일을 수동으로 작성하는 데 StreamWriter 또는 StringBuilder에 의존하는 접근 방식과 달리, IronXL은 특수 문자 이스케이프, 데이터 유형 보존, 내보내기 전에 수식 평가를 포함하여 올바른 CSV 형식의 모든 복잡성을 자동으로 처리합니다.

IronXL 문서는 셀 스타일 지정, 수식 평가, 암호 보호, 차트 생성과 같은 고급 기능을 포함하여 전체 API 표면을 다룹니다. 빠른 참조를 위해 IronXL 예제 라이브러리는 수십 가지의 일반적인 스프레드시트 시나리오를 다루는 실행 가능한 코드 샘플을 제공합니다.

새로운 CSV 파일을 처음부터 어떻게 만드나요?

프로그래밍 방식으로 새로운 CSV 파일을 생성하려면 세 가지 단계가 필요합니다: 작업 책을 생성하고, 데이터를 채우고, CSV 형식으로 저장하는 것입니다. IronXL의 API는 익숙한 Excel 객체 모델을 반영하여 개발자가 콘솔 애플리케이션이나 .NET 프로젝트 유형에서 스프레드시트 개념을 사용한 코드를 쉽게 작성할 수 있습니다.

직원 기록 목록을 CSV로 내보낼 필요가 있는 시나리오를 고려해 보세요. 다음은 상위 수준 선언을 사용한 완전한 예제입니다:

using IronXL;

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

// Add header row with column names
sheet["A1"].Value = "EmployeeID";
sheet["B1"].Value = "Name";
sheet["C1"].Value = "Department";
sheet["D1"].Value = "Salary";

// Add employee data rows
sheet["A2"].Value = 1001;
sheet["B2"].Value = "Sarah Johnson";
sheet["C2"].Value = "Engineering";
sheet["D2"].Value = 85000;

sheet["A3"].Value = 1002;
sheet["B3"].Value = "Michael Chen";
sheet["C3"].Value = "Marketing";
sheet["D3"].Value = 72000;

sheet["A4"].Value = 1003;
sheet["B4"].Value = "Emily Rodriguez";
sheet["C4"].Value = "Finance";
sheet["D4"].Value = 91000;

// Save as CSV file
workBook.SaveAsCsv("employees.csv", ",");

using IronXL;

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

// Add header row with column names
sheet["A1"].Value = "EmployeeID";
sheet["B1"].Value = "Name";
sheet["C1"].Value = "Department";
sheet["D1"].Value = "Salary";

// Add employee data rows
sheet["A2"].Value = 1001;
sheet["B2"].Value = "Sarah Johnson";
sheet["C2"].Value = "Engineering";
sheet["D2"].Value = 85000;

sheet["A3"].Value = 1002;
sheet["B3"].Value = "Michael Chen";
sheet["C3"].Value = "Marketing";
sheet["D3"].Value = 72000;

sheet["A4"].Value = 1003;
sheet["B4"].Value = "Emily Rodriguez";
sheet["C4"].Value = "Finance";
sheet["D4"].Value = 91000;

// Save as CSV file
workBook.SaveAsCsv("employees.csv", ",");

WorkBook.Create() 메서드는 메모리 전체에 새 스프레드시트를 초기화하여 최종 저장 작업까지 임시 파일이나 디스크 입출력이 필요하지 않습니다. CreateWorkSheet() 메서드는 통합 문서에 이름이 지정된 워크시트를 추가합니다. 이 이름은 여러 시트 통합 문서를 CSV로 내보낼 때 관련이 있습니다.

using IronXL;

// Define the Student class with public string properties
public class Student
{
    public string FirstName { get; set; }
    public string LastName { get; set; }
    public string Email { get; set; }
}

// Create sample data
var students = new List<Student>
{
    new Student { FirstName = "John", LastName = "Smith", Email = "john@example.com" },
    new Student { FirstName = "Jane", LastName = "Doe", Email = "jane@example.com" }
};

WorkBook workBook = WorkBook.Create();
WorkSheet sheet = workBook.DefaultWorkSheet;

// Add header row
sheet["A1"].Value = "FirstName";
sheet["B1"].Value = "LastName";
sheet["C1"].Value = "Email";

// Use foreach to iterate through the list and write each item
int row = 2;
foreach (var item in students)
{
    sheet[$"A{row}"].Value = item.FirstName;
    sheet[$"B{row}"].Value = item.LastName;
    sheet[$"C{row}"].Value = item.Email;
    row++;
}

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

using IronXL;

// Define the Student class with public string properties
public class Student
{
    public string FirstName { get; set; }
    public string LastName { get; set; }
    public string Email { get; set; }
}

// Create sample data
var students = new List<Student>
{
    new Student { FirstName = "John", LastName = "Smith", Email = "john@example.com" },
    new Student { FirstName = "Jane", LastName = "Doe", Email = "jane@example.com" }
};

WorkBook workBook = WorkBook.Create();
WorkSheet sheet = workBook.DefaultWorkSheet;

// Add header row
sheet["A1"].Value = "FirstName";
sheet["B1"].Value = "LastName";
sheet["C1"].Value = "Email";

// Use foreach to iterate through the list and write each item
int row = 2;
foreach (var item in students)
{
    sheet[$"A{row}"].Value = item.FirstName;
    sheet[$"B{row}"].Value = item.LastName;
    sheet[$"C{row}"].Value = item.Email;
    row++;
}

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

기존 Excel 파일을 CSV로 어떻게 변환하나요?

Excel 스프레드시트를 CSV 형식으로 변환하는 것은 레거시 시스템과 통합하거나 데이터베이스로의 데이터 준비 또는 사람이 작성한 보고서에서 기계 판독 가능한 출력 생성 시 일반적인 요구 사항입니다. IronXL은 최소한의 코드로 데이터 정확성을 유지하면서 이 변환을 처리합니다.

using IronXL;

// Load an existing Excel file
WorkBook workBook = WorkBook.Load("Monthly_Report_20251012.xlsx");

// Convert and save as CSV format
workBook.SaveAsCsv("Monthly_Report_20251012.csv");

using IronXL;

// Load an existing Excel file
WorkBook workBook = WorkBook.Load("Monthly_Report_20251012.xlsx");

// Convert and save as CSV format
workBook.SaveAsCsv("Monthly_Report_20251012.csv");

Load() 메서드는 XLSX, XLS, XLSM을 비롯하여 기존 CSV 또는 TSV 파일을 포함한 다양한 형식의 Excel 파일을 엽니다. 이 유연성을 통해 원본 형식에 관계없이 입력 파일을 수용하는 표준화된 내보내기 파이프라인을 구축할 수 있습니다. IronXL 문서에서 지원되는 Excel 형식의 전체 목록을 확인해 보세요.

using IronXL;

// Load a multi-sheet workbook (e.g., annual sales by region)
WorkBook workBook = WorkBook.Load("annual_sales.xlsx");

// Export all sheets to CSV -- creates separate files for each sheet
workBook.SaveAsCsv("sales_export.csv");
// Output: sales_export.North.csv, sales_export.South.csv, sales_export.East.csv, etc.

// Or export a specific worksheet
WorkSheet northRegion = workBook.GetWorkSheet("North");
northRegion.SaveAsCsv("north_region_sales.csv");

using IronXL;

// Load a multi-sheet workbook (e.g., annual sales by region)
WorkBook workBook = WorkBook.Load("annual_sales.xlsx");

// Export all sheets to CSV -- creates separate files for each sheet
workBook.SaveAsCsv("sales_export.csv");
// Output: sales_export.North.csv, sales_export.South.csv, sales_export.East.csv, etc.

// Or export a specific worksheet
WorkSheet northRegion = workBook.GetWorkSheet("North");
northRegion.SaveAsCsv("north_region_sales.csv");

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

Enterprise 응용 프로그램은 종종 데이터베이스 쿼리, API 응답 또는 메모리 내 데이터 처리에서 수집된 DataTable 객체를 사용하여 작동합니다. IronXL은 이러한 .NET 데이터 구조와 파일 내보내기 간의 차이점을 연결하며, 애플리케이션 메모리에서 공유 가능한 CSV 파일로의 신뢰할 수 있는 경로를 제공합니다. 이 방법은 StreamWriter으로 CSV 파일을 수동으로 작성하는 것보다 더 신뢰할 수 있습니다. IronXL은 문자 이스케이핑, 구분 기호 관리, 인코딩을 자동으로 처리합니다.

using IronXL;
using System.Data;

// Create and populate a DataTable with columns
DataTable products = new DataTable();
products.Columns.Add("SKU", typeof(string));
products.Columns.Add("ProductName", typeof(string));
products.Columns.Add("Price", typeof(decimal));
products.Columns.Add("InStock", typeof(int));

// Add rows of data
products.Rows.Add("SKU-001", "Wireless Mouse", 29.99m, 150);
products.Rows.Add("SKU-002", "Mechanical Keyboard", 89.99m, 75);
products.Rows.Add("SKU-003", "USB-C Hub", 45.99m, 200);

// Create workbook and transfer DataTable contents
WorkBook workBook = WorkBook.Create();
WorkSheet sheet = workBook.DefaultWorkSheet;

// Add header row from column names
for (int col = 0; col < products.Columns.Count; col++)
{
    sheet.SetCellValue(0, col, products.Columns[col].ColumnName);
}

// Add data rows using nested loops
for (int row = 0; row < products.Rows.Count; row++)
{
    for (int col = 0; col < products.Columns.Count; col++)
    {
        sheet.SetCellValue(row + 1, col, products.Rows[row][col].ToString());
    }
}

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

using IronXL;
using System.Data;

// Create and populate a DataTable with columns
DataTable products = new DataTable();
products.Columns.Add("SKU", typeof(string));
products.Columns.Add("ProductName", typeof(string));
products.Columns.Add("Price", typeof(decimal));
products.Columns.Add("InStock", typeof(int));

// Add rows of data
products.Rows.Add("SKU-001", "Wireless Mouse", 29.99m, 150);
products.Rows.Add("SKU-002", "Mechanical Keyboard", 89.99m, 75);
products.Rows.Add("SKU-003", "USB-C Hub", 45.99m, 200);

// Create workbook and transfer DataTable contents
WorkBook workBook = WorkBook.Create();
WorkSheet sheet = workBook.DefaultWorkSheet;

// Add header row from column names
for (int col = 0; col < products.Columns.Count; col++)
{
    sheet.SetCellValue(0, col, products.Columns[col].ColumnName);
}

// Add data rows using nested loops
for (int row = 0; row < products.Rows.Count; row++)
{
    for (int col = 0; col < products.Columns.Count; col++)
    {
        sheet.SetCellValue(row + 1, col, products.Rows[row][col].ToString());
    }
}

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

이 패턴은 DataTable 구조를 통해 반복하여 먼저 열 헤더를 전달한 다음 각 데이터 행을 체계적으로 채웁니다. DefaultWorkSheet 속성은 새로 생성된 통합 문서에서 첫 번째 워크시트에 빠르게 접근할 수 있어 간단한 시나리오에서 명시적인 워크시트 생성의 필요성을 없애줍니다.

CSV 파일에서 사용자 정의 구분자를 어떻게 처리하나요?

다양한 시스템 및 지역 표준에서는 다양한 구분 문자 문자가 필요합니다. 콤마는 많은 국가에서 표준 구분자지만, 유럽 지역에서는 숫자 값에 콤마가 십진 구분자로 사용되기 때문에 세미콜론이 자주 선호됩니다. 소스 데이터에 필드 값 내에 콤마가 포함된 경우 Tab-separated 파일(TSV)은 인기가 있습니다. IronXL의 SaveAsCsv() 메서드는 각 라인의 출력을 처리하기 위한 추가 코드 없이 이러한 모든 시나리오를 수용합니다.

using IronXL;

WorkBook workBook = WorkBook.Load("data.xlsx");

// Standard comma delimiter (default format)
workBook.SaveAsCsv("output_comma.csv", ",");

// Semicolon delimiter (common in European systems)
workBook.SaveAsCsv("output_semicolon.csv", ";");

// Tab delimiter (TSV format)
workBook.SaveAsCsv("output_tab.tsv", "\t");

// Pipe delimiter (used in some data interchange formats)
workBook.SaveAsCsv("output_pipe.csv", "|");

using IronXL;

WorkBook workBook = WorkBook.Load("data.xlsx");

// Standard comma delimiter (default format)
workBook.SaveAsCsv("output_comma.csv", ",");

// Semicolon delimiter (common in European systems)
workBook.SaveAsCsv("output_semicolon.csv", ";");

// Tab delimiter (TSV format)
workBook.SaveAsCsv("output_tab.tsv", "\t");

// Pipe delimiter (used in some data interchange formats)
workBook.SaveAsCsv("output_pipe.csv", "|");

SaveAsCsv()의 두 번째 매개변수는 구분 기호로 사용될 문자열을 수락하여 다양한 시스템과 지역 요구사항에 맞는 완전한 유연성을 제공합니다. 국제 배포용 파일을 생성할 때, 유럽 금융 시스템은 종종 세미콜론 구분을 기대하는 반면, 북미 시스템은 일반적으로 쉼표를 기본으로 사용하기 때문에 대상 시스템의 로케일 기대를 고려하십시오. CSV에 대한 RFC 4180 표준은 구분 기호가 포함된 값을 인용하여 구문 분석 오류를 방지하는 방법을 설명합니다.

CSV 파일을 C#에서 생성할 때의 모범 사례는 무엇입니까?

C#에서 CSV 파일을 작업할 때, 정립된 관행을 따름으로써 데이터의 정확성, 가독성, 다른 시스템과의 호환성을 유지할 수 있습니다. 다음 표는 가장 중요한 고려 사항을 요약한 것입니다:

기본을 넘어서 국제 청중을 목표로 할 때 인코딩을 명시적으로 고려하십시오. Microsoft Excel에서 CSV 파일을 열 때 비ASCII 문자를 올바르게 표시하려면 UTF-8 BOM이 자주 필요합니다. 수백만 행이 포함된 고용량 내보내기를 위해 데이터를 단일 대형 CSV 파일로 작성하는 대신 여러 파일로 조각화하는 것을 고려하십시오. 이는 파일 크기 관리를 용이하게 하며 생성 및 소비 중 메모리 압박을 줄입니다.

데이터 파이프라인을 구축하는 팀은 IronXL 비동기 및 스트리밍 문서에서 전체 워크북을 메모리에 로드하지 않고 큰 데이터를 처리하는 패턴을 확인할 수 있습니다. IronXL 예제 라이브러리는 일괄 처리, 예약된 내보내기 작업, Entity Framework와 같은 인기 있는 ORM 프레임워크와의 통합을 위한 추가 패턴을 포함합니다.

.NET 생태계의 CSV 처리 도구를 다룰 때, IronXL이 하위 수준 접근 방식과 어떻게 맞물리는지 이해하면 각 시나리오에 적합한 도구를 선택하는 데 도움이 됩니다. Excel 관여 없이 순수 CSV 생성에는 수동 인용 로직을 사용한 StreamWriter이 충분할 수 있습니다. Excel 형식 호환성, 수식 평가 또는 리치 포맷과 관련된 모든 것에 대해 IronXL은 더욱 신뢰할 수 있는 기반을 제공합니다.

IronXL을 사용하여 기존 CSV 파일을 어떻게 읽습니까?

CSV 데이터를 애플리케이션에 다시 읽어들이는 것은 다른 스프레드시트 형식을 로드하는 것과 동일한 패턴을 따릅니다. IronXL의 Load() 메서드는 CSV 파일을 인식하고 이를 표준 통합 문서/워크시트 모델로 구문 분석하여 Excel 파일에 사용되는 동일한 API를 사용하여 개별 셀과 범위에 접근할 수 있도록 합니다.

using IronXL;

// Load an existing CSV file
WorkBook workBook = WorkBook.Load("employees.csv");
WorkSheet sheet = workBook.DefaultWorkSheet;

// Access specific cells by reference
string firstHeader = sheet["A1"].StringValue;

// Iterate through all rows
foreach (var row in sheet.Rows)
{
    foreach (var cell in row)
    {
        Console.Write(cell.StringValue + "\t");
    }
    Console.WriteLine();
}

// Access a range of cells
var nameColumn = sheet["B2:B100"];
foreach (var cell in nameColumn)
{
    Console.WriteLine(cell.StringValue);
}

using IronXL;

// Load an existing CSV file
WorkBook workBook = WorkBook.Load("employees.csv");
WorkSheet sheet = workBook.DefaultWorkSheet;

// Access specific cells by reference
string firstHeader = sheet["A1"].StringValue;

// Iterate through all rows
foreach (var row in sheet.Rows)
{
    foreach (var cell in row)
    {
        Console.Write(cell.StringValue + "\t");
    }
    Console.WriteLine();
}

// Access a range of cells
var nameColumn = sheet["B2:B100"];
foreach (var cell in nameColumn)
{
    Console.WriteLine(cell.StringValue);
}

읽기 및 쓰기 작업 간의 이러한 일관성은 모든 스프레드시트 관련 작업에 대해 단일 API만 학습하면 된다는 것을 의미합니다. CSV 파일을 여는 동일한 WorkBook.Load() 메서드는 XLSX, XLS 및 XLSM 형식도 처리합니다. 여러 형식의 입력을 수용하는 파이프라인을 구축할 때 유용합니다. IronXL로 CSV 파일 읽기에 대한 자세한 내용은 문서에서 확인하십시오.

다음 단계는 무엇입니까?

이 가이드는 IronXL을 사용하여 C#에서 CSV 파일 생성 및 관리를 위한 기본 패턴을 다루었습니다:

• 메모리에서 새 스프레드시트 초기화를 위한 WorkBook.Create()
• 기존 Excel 및 CSV 파일을 지원되는 모든 형식으로 열기 위한 WorkBook.Load()
• 커스터마이징 가능한 구분 기호로 데이터를 내보내기 위한 SaveAsCsv()
• 타겟 변환을 위한 개별 워크시트 내보내기 GetWorkSheet()
• 데이터베이스에서 CSV로 워크플로우를 위한 DataTable 반복 패턴
• foreach 루프를 사용한 객체 목록 내보내기
• 전체 범위 액세스로 애플리케이션에 CSV 데이터를 다시 읽어들이기

이러한 기술을 실무에 적용하려면, IronXL 무료 체험판을 시작하여 테스트에 시간 제한 없이 전체 스프레드시트 기능을 탐색하세요. 배포 준비가 되면, IronXL 라이선스 옵션을 검토하여 팀의 규모와 사용 요구 사항에 맞는 계획을 찾으세요.

셀 스타일링, 수식 생성, 차트 생성 및 비밀번호 보호와 같은 고급 시나리오를 다룬 추가 예제를 위해 IronXL 문서와 완전한 코드 예제 라이브러리를 탐색하세요. IronXL 튜토리얼 시리즈는 DataTable 내보내기, 형식 변환, CSV 파일로 쓰기를 포함하여 더 복잡한 통합 시나리오를 안내합니다.