C# CSV 파서 (단계별) 튜토리얼

Visual Studio NuGet 패키지 관리자를 사용해야 하나요?

NuGet 패키지 관리자 UI는 Visual Studio에서 프로젝트에 패키지를 직접 설치할 수 있도록 제공합니다. 이 방법은 시각적 인터페이스를 선호하고 설치 전에 패키지 세부 정보를 확인하고 싶은 개발자에게 특히 유용합니다. 아래 스크린샷에서 열 수 있는 방법을 보여줍니다.

Access the NuGet Package Manager in Visual Studio by navigating to Tools > NuGet Package Manager > Manage NuGet Packages for Solution

패키지 관리자 UI는 NuGet 웹사이트에 있는 패키지 라이브러리 목록을 표시하는 탐색 기능을 제공합니다. IronXL 패키지를 찾으려면 아래 스크린샷에 표시된 대로 "IronXL"을 입력하십시오. IronXL가 제공하는 관련 Excel 조작 기능도 탐색할 수 있습니다.

NuGet 패키지 관리자가 .NET 애플리케이션에서 Excel 파일을 읽고, 생성하고, 편집할 수 있게 하는 IronXl.Excel 라이브러리를 Visual Studio에서 표시합니다. 이 패키지는 250,000회 다운로드되었고 설치할 준비가 된 버전 2022.9.9454를 보여줍니다

IronXl.Excel 패키지를 선택하고 설치 버튼을 클릭하여 프로젝트에 추가합니다. 설치 프로세스는 모든 종속성을 자동으로 처리하고 프로젝트를 Excel 파일 조작에 알맞게 구성합니다.

언제 Visual Studio 명령줄을 사용해야 하나요?

Visual Studio 메뉴에서 도구 > NuGet 패키지 관리자로 이동하여 패키지 관리자 콘솔을 클릭하십시오. 이 방법은 명령줄 인터페이스에 익숙하거나 빌드 스크립트에서 설치 프로세스를 자동화할 필요가 있는 개발자에게 선호됩니다.

CSV 파싱 라이브러리를 설치하기 위해 Visual Studio에서 NuGet 패키지 관리자 콘솔 열기

패키지 관리자 콘솔은 화면 하단에 나타납니다. 다음 명령어를 입력하고 엔터를 누르세요. IronXL이 설치됩니다. 이 메서드는 특정 버전을 설치해야 하거나 Azure용 배포 스크립트 또는 AWS 환경에서 작업할 때 특히 유용합니다.

Install-Package IronXl.Excel

패키지 관리자 콘솔은 NuGet 저장소에서 패키지 복원 프로세스와 다운로드 확인을 보여주는 IronXl.Excel 버전 2022.11.10251의 성공적인 설치를 표시합니다

XLSX 파일을 CSV로 어떻게 변환하나요?

Microsoft Excel을 열고 새 XLSX 파일을 만듭니다. 행과 열에 몇 가지 모의 데이터를 채웁니다. 프로덕션 시나리오에서는 IronXL을 사용하여 프로그램적으로 Excel 파일을 생성할 수 있습니다. 아래의 이미지는 이 튜토리얼에서 모든 변환에 사용된 파일을 보여줍니다.

그림 6: C#에서 CSV 파싱을 시연하기 위해 사용될 기본 인벤토리 구조를 보여주는 샘플 Excel 데이터

파일 준비가 완료되면 다음 샘플 코드를 작성하고 프로그램을 실행합니다. IronXL은 특별한 문자와 데이터 유형의 적절한 처리를 포함하여 모든 복잡한 구문 분석을 내부적으로 처리합니다:

using IronXL;

class Program
{
    static void Main()
    {
        // Load the XLSX file into a WorkBook object
        // The Load method automatically detects the file format
        WorkBook wb = WorkBook.Load("test.xlsx");

        // Save the WorkBook as a CSV file
        // This method handles all formatting and conversion automatically
        wb.SaveAsCsv("Parsed CSV.csv");

        // Optional: Save with custom delimiter
        // wb.SaveAsCsv("Parsed CSV.csv", delimiter: ";");
    }
}

using IronXL;

class Program
{
    static void Main()
    {
        // Load the XLSX file into a WorkBook object
        // The Load method automatically detects the file format
        WorkBook wb = WorkBook.Load("test.xlsx");

        // Save the WorkBook as a CSV file
        // This method handles all formatting and conversion automatically
        wb.SaveAsCsv("Parsed CSV.csv");

        // Optional: Save with custom delimiter
        // wb.SaveAsCsv("Parsed CSV.csv", delimiter: ";");
    }
}

실행이 완료되면 Parsed CSV.csv라는 새 파일이 생성됩니다. 원하는 편집기나 리더로 CSV 파일을 읽을 수 있습니다. 또한 CSV 데이터를 다시 Excel로 가져와 추가 조작할 수 있습니다. 아래의 이미지는 위 명령의 출력을 보여줍니다—생성된 CSV 데이터입니다. 출력 파일에서 큰따옴표는 굵은 값을 나타냅니다.

그림 7: Excel 데이터를 쉼표로 구분된 형식으로 변환하여 SaveAsCsv 메소드에 의해 생성된 CSV 출력

XLS 파일을 CSV로 변환하는 단계는 무엇입니까?

이 예에서는 XLS 파일을 CSV 형식으로 변환하는 방법을 살펴보겠습니다. 그 과정은 XLSX 변환과 동일하며, 다양한 Excel 파일 형식을 처리하는 IronXL의 다재다능함을 보여줍니다.

먼저 CSV 형식으로 변환할 수 있는 샘플 XLS 파일을 만듭니다. XLS는 오래된 Excel 형식이지만 IronXL은 현대 형식과 함께 매끄럽게 처리합니다:

그림 8: 자동 계산으로 인벤토리 데이터 구조를 보여주는 샘플 Excel 파일. C# CSV 라이브러리를 사용하여 파싱할 수 있습니다

다음으로, 샘플 XLS 파일을 CSV 파일로 변환하기 위해 아래 코드 블록을 실행합니다. IronXL은 수식과 계산을 포함하여 변환 중 데이터 무결성을 유지합니다:

using IronXL;

class Program
{
    static void Main()
    {
        // Load the XLS file into a WorkBook object
        // IronXL automatically handles the older XLS format
        WorkBook wb = WorkBook.Load("XLS.xls");

        // Save the WorkBook as a CSV file
        // All formulas are evaluated and results are exported
        wb.SaveAsCsv("Example2.csv");

        // Optional: Export specific worksheet
        // WorkSheet ws = wb.GetWorkSheet("Sheet1");
        // ws.SaveAsCsv("Example2.csv");
    }
}

using IronXL;

class Program
{
    static void Main()
    {
        // Load the XLS file into a WorkBook object
        // IronXL automatically handles the older XLS format
        WorkBook wb = WorkBook.Load("XLS.xls");

        // Save the WorkBook as a CSV file
        // All formulas are evaluated and results are exported
        wb.SaveAsCsv("Example2.csv");

        // Optional: Export specific worksheet
        // WorkSheet ws = wb.GetWorkSheet("Sheet1");
        // ws.SaveAsCsv("Example2.csv");
    }
}

위 코드가 실행된 후에는 새로 생성된 CSV 파일이 생깁니다. 더 복잡한 시나리오의 경우 특정 범위를 선택하거나 내보내기 전에 데이터를 정렬하고 싶을 수 있습니다.

적절하게 형식이 지정된 쉼표로 구분된 데이터가 헤더와 여러 제품 항목으로 표시된 예제 CSV 파일이 WordPad에서 열림

TSV 형식에서 CSV 파일을 어떻게 파싱하나요?

스프레드시트 애플리케이션은 데이터베이스 간의 데이터를 전송하기 위해 TSV 파일 또는 탭으로 구분된 값 파일을 자주 사용합니다. 데이터 열은 탭으로 구분하고 각 레코드는 다른 줄에 있는 데이터 테이블을 저장합니다. TSV 파일은 데이터에 쉼표가 포함되어 CSV 파싱에 방해가 될 수 있을 때 특히 유용합니다.

IronXL은 데이터 관리를 개선하기 위해 TSV 형식에서 CSV 파일을 파싱할 수 있는 CSV 파서를 제공합니다. 변환 과정은 간단하며 데이터 무결성을 유지합니다.

예제를 시작해봅시다. 먼저 학생 데이터를 포함한 TSV 파일을 만듭니다:

NAME, EMAIL, R-NO, Grade 열이 있는 TSV 파일의 구조를 보여주는 Microsoft Word에서 표시된 탭으로 구분된 학생 데이터의 예제

using IronXL;

class Program
{
    static void Main()
    {
        // Load the TSV file into a WorkBook object
        // IronXL automatically detects tab-separated format
        WorkBook wb = WorkBook.Load("TSV.tsv");

        // Save the WorkBook as a CSV file
        // Tabs are converted to commas automatically
        wb.SaveAsCsv("Example3.csv");

        // Alternative: Load with explicit delimiter specification
        // WorkBook wb = WorkBook.LoadCSV("TSV.tsv", delimiter: "\t");
    }
}

using IronXL;

class Program
{
    static void Main()
    {
        // Load the TSV file into a WorkBook object
        // IronXL automatically detects tab-separated format
        WorkBook wb = WorkBook.Load("TSV.tsv");

        // Save the WorkBook as a CSV file
        // Tabs are converted to commas automatically
        wb.SaveAsCsv("Example3.csv");

        // Alternative: Load with explicit delimiter specification
        // WorkBook wb = WorkBook.LoadCSV("TSV.tsv", delimiter: "\t");
    }
}

아래는 CSV 형식의 출력입니다. IronXL이 데이터를 제대로 유지하면서 탭으로 구분된 값을 쉼표로 구분된 값으로 잘 변환했음을 확인하세요:

쉼표로 구분된 필드로 이름, 이메일, 학번, 등급이 표시된 학생 레코드를 표시하는 WordPad에서 열린 예제 CSV 파일