IronXL 과 CsvHelper 비교

IronXL 기능 세트

• XLS/XLSX/CSV/TSV에서 데이터 로드, 읽기 및 편집
• XLS/XLSX/CSV/TSV/JSON으로 저장 및 내보내기
• 범위 — 사용하기 쉬운 WorkSheet["A1:B10"] 구문. 범위를 직관적으로 결합하고 생성.
• 정렬 — 범위, 열 및 행 정렬.
• 스타일링 — 셀 시각 스타일, 글꼴, 크기, 배경 패턴, 테두리, 정렬 및 숫자 형식.

CsvHelper 기능

• 빠름: 매우 빠른 성능을 위해 클래스가 즉석에서 컴파일됩니다
• 유연함: 쓸 때는 보수적이고, 읽을 때는 자유롭습니다
• 사용하기 쉬움: 읽기와 쓰기는 GetRecords<t>() 및 WriteRecords(records) 만큼 간단합니다.
• 고도로 구성 가능
• 리눅스 모드
• 낮은 메모리 사용량

2.1. NuGet 패키지를 사용하여 Visual Studio로 설치

Visual Studio는 프로젝트에 NuGet 패키지를 설치하기 위해 NuGet 패키지 관리자를 제공합니다. 프로젝트 메뉴에서 액세스하거나 솔루션 탐색기에서 프로젝트를 마우스 오른쪽 버튼으로 클릭하여 액세스할 수 있습니다.

*NuGet 패키지 관리 선택*

• 이제, 탐색 탭에서 -> IronXl.Excel 검색 -> 설치

*IronXL 검색*

• 그리고 우리는 끝났습니다.

2.2. NuGet 패키지를 직접 다운로드

NuGet 사이트에 직접 방문하여 패키지를 다운로드함으로써 이를 수행할 수 있습니다. 단계는 다음과 같습니다:

• https://www.nuget.org/packages/IronXl.Excel로 이동합니다
• '패키지 다운로드'를 선택하세요
• 다운로드된 패키지를 더블 클릭하세요
• 패키지가 설치됩니다
• Visual Studio 프로젝트를 다시 로드하고 사용을 시작합니다

2.3. DLL로 수동 설치

IronXL C# 라이브러리를 다운로드하고 설치하는 또 다른 방법은, 개발자 명령 프롬프트를 통해 IronXL NuGet 패키지를 설치하기 위해 다음 단계를 사용하는 것입니다.

• 개발자 명령 프롬프트를 여세요 — 일반적으로 Visual Studio 폴더에 있습니다.
• 다음 명령을 입력합니다: PM> Install-Package IronXl.Excel
• Enter 키를 누릅니다
• 이것은 패키지를 다운로드하고 설치할 것입니다
• Visual Studio 프로젝트를 다시 로드하고 사용을 시작합니다

2.4. 필요한 Using 지시문 추가

1. 솔루션 탐색기에서 Program.cs 파일을 마우스 오른쪽 버튼으로 클릭하고 코드 보기 클릭.
2. 코드 파일의 맨 위에 다음 using 지시문을 추가합니다.

using IronXL;

using IronXL;

모두 완료되었습니다! IronXL이 다운로드, 설치되었으며 사용할 준비가 되었습니다. 하지만 그 전에, CsvHelper를 설치해야 합니다.

3.1. NuGet 패키지 관리자 콘솔 사용하기

CsvHelper C# 라이브러리를 다운로드하고 설치하려면, 개발자 명령 프롬프트를 통해 NuGet 패키지를 설치하는 다음 단계를 사용하십시오.

• 개발자 명령 프롬프트를 여세요 — 일반적으로 Visual Studio 폴더에 있습니다.
• 다음 명령을 입력합니다: PM> Install-Package CsvHelper -Version 27.2.1
• Enter 키를 누릅니다
• 이것은 패키지를 다운로드하고 설치할 것입니다
• Visual Studio 프로젝트를 다시 로드하고 사용을 시작합니다

3.2. 직접 다운로드

NuGet 웹사이트에서 다운로드: https://www.nuget.org/packages/CsvHelper.

4.1. CSV 파일을 Excel 형식으로 변환하기

과정은 매우 간단하고 쉬운 편입니다. 일반적으로 한 줄의 코드로 수행됩니다.

CSV에서 Excel 형식으로:

// Load the CSV file and convert it to an Excel format
WorkBook workbook = WorkBook.LoadCSV("test.csv", fileFormat: ExcelFileFormat.XLSX, ListDelimiter: ",");
// Access the default worksheet
WorkSheet ws = workbook.DefaultWorkSheet;

// Save the workbook as an Excel file
workbook.SaveAs("CsvToExcelConversion.xlsx");

// Load the CSV file and convert it to an Excel format
WorkBook workbook = WorkBook.LoadCSV("test.csv", fileFormat: ExcelFileFormat.XLSX, ListDelimiter: ",");
// Access the default worksheet
WorkSheet ws = workbook.DefaultWorkSheet;

// Save the workbook as an Excel file
workbook.SaveAs("CsvToExcelConversion.xlsx");

4.2. IronXL을 사용하여 변환된 CSV 파일 읽고 조작하기

IronXL WorkBook 클래스는 Excel 시트를 나타냅니다. C#를 사용하여 Excel 파일을 열기 위해, 우리는 WorkBook.Load를 사용하고 Excel 파일(.xlsx)의 경로를 지정합니다. 다음 한 줄의 코드는 파일을 읽기 위해 여는 데 사용됩니다:

// Load WorkBook
var workbook = WorkBook.Load(@"Spreadsheets/sample.xlsx");

// Load WorkBook
var workbook = WorkBook.Load(@"Spreadsheets/sample.xlsx");

각 WorkBook는 여러 WorkSheet 객체를 포함할 수 있습니다. 이들은 Excel 문서의 워크시트를 나타냅니다. 작업책에 워크시트가 포함되어 있는 경우, 다음과 같이 이름으로 검색하여 가져옵니다:

// Open the sheet for reading
var worksheet = workbook.GetWorkSheet("sheetnamegoeshere");

// Open the sheet for reading
var worksheet = workbook.GetWorkSheet("sheetnamegoeshere");

셀 값을 읽는 코드:

// Read from ranges of cells elegantly
foreach (var cell in worksheet["A2:A10"])
{
    Console.WriteLine("Cell {0} has value '{1}'", cell.AddressString, cell.Text);
}

// Read from ranges of cells elegantly
foreach (var cell in worksheet["A2:A10"])
{
    Console.WriteLine("Cell {0} has value '{1}'", cell.AddressString, cell.Text);
}

워크북과 워크시트를 로드하고 읽은 후, 다음 코드 샘플을 사용하여 수식을 변경하거나 특정 셀에 적용할 수 있습니다. 코드는 다음과 같습니다.

// Set formulas in specific cells
worksheet["A1"].Formula = "SUM(B8:C12)";
worksheet["B8"].Formula = "=C9/C11";
worksheet["G30"].Formula = "MAX(C3:C7)";

// Force recalculate all formula values in all sheets
workbook.EvaluateAll();

// Set formulas in specific cells
worksheet["A1"].Formula = "SUM(B8:C12)";
worksheet["B8"].Formula = "=C9/C11";
worksheet["G30"].Formula = "MAX(C3:C7)";

// Force recalculate all formula values in all sheets
workbook.EvaluateAll();

4.3. Excel 문서를 다시 CSV 파일로 저장하기

IronXL을 사용하면 CSV 파일 쓰기가 쉬운 과정입니다. 다음 코드는 SaveAsCsv 메서드를 사용하여 Excel 파일을 CSV 형식으로 단순히 저장합니다.

// Load the Excel Workbook
WorkBook wb = WorkBook.Load("Normal_Excel_File.xlsx");

// Save the workbook as a CSV file
wb.SaveAsCsv("SaveAsCSV.csv", ",");
// This will save as "SaveAsCSV.Sheet1.csv"

// Load the Excel Workbook
WorkBook wb = WorkBook.Load("Normal_Excel_File.xlsx");

// Save the workbook as a CSV file
wb.SaveAsCsv("SaveAsCSV.csv", ",");
// This will save as "SaveAsCSV.Sheet1.csv"

5.1. CsvHelper로 CSV 파일 읽기

이것은 샘플 CSV 파일이며, 세 개의 텍스트 열과 하나의 숫자 열을 포함합니다.

FirstName,LastName,Age,IsActive
Ali,Talal,30,Yes
Affan,Ahmad,31,No
Saad,Bhatti,31,Yes

우리는 각 행을 Person 유형의 객체로 매핑할 것입니다.

// Define the Person class to map CSV records
public class Person
{
    public string FirstName { get; set; }
    public string LastName { get; set; }
    public int? Age { get; set; }
    public string IsActive { get; set; }
}

// Define the Person class to map CSV records
public class Person
{
    public string FirstName { get; set; }
    public string LastName { get; set; }
    public int? Age { get; set; }
    public string IsActive { get; set; }
}

우리의 CSV 파일을 읽기 위한 코드는 아래에 있습니다.

// Define the path to the CSV file
var fileName = @"<path to our CSV file>";

// Configure CsvHelper
var configuration = new CsvConfiguration(CultureInfo.InvariantCulture)
{
    Encoding = Encoding.UTF8,
    Delimiter = ","
};

// Read CSV file
using (var fs = File.Open(fileName, FileMode.Open, FileAccess.Read, FileShare.Read))
{
    using (var textReader = new StreamReader(fs, Encoding.UTF8))
    using (var csv = new CsvReader(textReader, configuration))
    {
        var data = csv.GetRecords<Person>();

        // Iterate over each person record
        foreach (var person in data)
        {
            // Process each Person object
        }
    }
}

// Define the path to the CSV file
var fileName = @"<path to our CSV file>";

// Configure CsvHelper
var configuration = new CsvConfiguration(CultureInfo.InvariantCulture)
{
    Encoding = Encoding.UTF8,
    Delimiter = ","
};

// Read CSV file
using (var fs = File.Open(fileName, FileMode.Open, FileAccess.Read, FileShare.Read))
{
    using (var textReader = new StreamReader(fs, Encoding.UTF8))
    using (var csv = new CsvReader(textReader, configuration))
    {
        var data = csv.GetRecords<Person>();

        // Iterate over each person record
        foreach (var person in data)
        {
            // Process each Person object
        }
    }
}

data의 유형은 IEnumerable<Person>입니다. CsvHelper는 각 열을 같은 이름의 속성에 자동으로 매핑합니다. 예를 들어, FirstName 열의 값은 Person.FirstName로 매핑될 것입니다. 그런 다음 우리는 data를 반복하여 각 행의 값을 액세스할 수 있습니다.

5.2. CSV 파일의 데이터를 한 유형에서 다른 유형으로 변환하기

CSV 파일은 주로 텍스트 데이터를 포함합니다. 예를 들어, 연령 열은 정수 값이고 CSV 파일은 텍스트만 포함합니다. CsvHelper는 문자열에서 표준 .NET 유형(부울, Int32, Int64, 열거형)으로 데이터를 변환할 수 있습니다. 우리의 경우, 우리는 IsActive bool 데이터 유형을 가지고 있으며, 이는 True/False만 가질 수 있고 비표준 값을 포함합니다. 사용자 지정 변환기를 생성하여 변환할 수 있습니다. 코드 스타일은 다음과 같습니다:

// Custom Boolean Converter for CsvHelper
public class CustomBooleanConverter : DefaultTypeConverter
{
    public override object ConvertFromString(string text, IReaderRow row, MemberMapData memberMapData)
    {
        // Convert "Yes" to true and anything else to false
        return text.Equals("Yes", StringComparison.OrdinalIgnoreCase);
    }
}

// Custom Boolean Converter for CsvHelper
public class CustomBooleanConverter : DefaultTypeConverter
{
    public override object ConvertFromString(string text, IReaderRow row, MemberMapData memberMapData)
    {
        // Convert "Yes" to true and anything else to false
        return text.Equals("Yes", StringComparison.OrdinalIgnoreCase);
    }
}

비록 bool가 표준 .NET 타입일지라도, 기본 변환기는 True/False 값만 처리할 수 있으며, 우리의 CSV 파일에는 Yes/No가 있습니다. 여기서 우리는 DefaultTypeConverter을 서브클래스화한 다음 ConvertFromString 메서드를 오버라이드할 필요가 있습니다.

요약

IronXL은 Excel 파일을 조작할 수 있게 하는 모든 것을 제공하는 완전한 라이브러리입니다. 사용하기 쉽고 다양한 형식을 XLSX로 변환하는 기능을 제공하며, XLSX에서 CSV와 같은 다른 형식으로 변환할 수도 있습니다. 이러한 상호 변환은 사용자가 다양한 파일 형식을 쉽게 작업할 수 있도록 유연성을 제공합니다.

반면, CsvHelper는 CSV 파일 형식에 특화되어 설계되었으며, CSV 파일만 처리할 수 있습니다. 모든 코드 샘플은 CsvHelper 문서 파일에 있습니다. 문서에서는 CsvHelper를 프로젝트에서 사용하는 방법에 대한 지침을 제공합니다.

결론

IronXL은 여러 형식을 지원한다는 점에서 CsvHelper보다 분명한 이점을 가지고 있습니다. 게다가, 사용자는 선택에 따라 수식과 스타일을 적용할 수 있지만, CsvHelper는 제한된 옵션으로 CSV 파일 읽기 및 쓰기만 허용합니다. 또한, 기존의 CSV 파일에 새 레코드를 추가할 수 없으며, 이전 항목을 단순히 덮어씁니다.