C#에서 StreamReader를 사용하여 Excel 파일을 읽는 대안 - IronXL

StreamReader로 엑셀 파일을 읽을 수 없는 이유?

StreamReader는 플레인 텍스트 파일을 위해 설계되었으며, 지정된 인코딩을 사용하여 문자 데이터를 줄 단위로 읽습니다. Excel 파일은 스프레드시트의 외관에도 불구하고 실제로는 복잡한 바이너리 또는 ZIP 압축된 XML 구조이며, StreamReader가 해석할 수 없습니다.

static void Main(string[] args)
{
    // This code will NOT work - demonstrates the problem
    using (StreamReader reader = new StreamReader("ProductData.xlsx"))
    {
        string content = reader.ReadLine(); // read data
        Console.WriteLine(content); // Outputs garbled binary data
    }
}

static void Main(string[] args)
{
    // This code will NOT work - demonstrates the problem
    using (StreamReader reader = new StreamReader("ProductData.xlsx"))
    {
        string content = reader.ReadLine(); // read data
        Console.WriteLine(content); // Outputs garbled binary data
    }
}

이 클래스 프로그램 코드 조각을 실행하면 스프레드시트 데이터 대신 'PK♥♦'와 같은 바이너리 알 수 없는 데이터나 유사한 시스템 문자가 나타납니다. 이것은 XLSX 파일이 여러 XML 파일을 포함하는 ZIP 아카이브인 반면, XLS 파일은 독점 이진 포맷을 사용하기 때문에 발생합니다. StreamReader는 단순 텍스트를 기대하고 이러한 복잡한 구조를 문자로 해석하려고 하므로 무의미한 출력이 발생합니다.

IronXL로 Excel 파일을 읽는 방법?

IronXL은 C#에서 Excel 파일을 읽기 위한 직관적인 솔루션을 제공합니다. StreamReader와 달리, IronXL은 Excel의 내부 구조를 이해하고 데이터를 액세스하기 위한 직관적인 메서드를 제공합니다. 이 라이브러리는 Windows, Linux, macOS, Docker 컨테이너를 지원하여 현대적이고 크로스 플랫폼 애플리케이션에 이상적입니다.

먼저 NuGet 패키지 관리자를 통해 IronXL을 설치하세요:

Install-Package IronXl.Excel

Excel 파일을 올바르게 읽는 방법은 다음과 같습니다:

using IronXL;
// Load the Excel file
WorkBook workbook = WorkBook.Load("sample.xlsx");
WorkSheet worksheet = workbook.DefaultWorkSheet;
// Read specific cell values
string cellValue = worksheet["A1"].StringValue;
Console.WriteLine($"Cell A1 contains: {cellValue}");
// Read a range of cells
foreach (var cell in worksheet["A1:C5"])
{
    Console.WriteLine($"{cell.AddressString}: {cell.Text}");
}

using IronXL;
// Load the Excel file
WorkBook workbook = WorkBook.Load("sample.xlsx");
WorkSheet worksheet = workbook.DefaultWorkSheet;
// Read specific cell values
string cellValue = worksheet["A1"].StringValue;
Console.WriteLine($"Cell A1 contains: {cellValue}");
// Read a range of cells
foreach (var cell in worksheet["A1:C5"])
{
    Console.WriteLine($"{cell.AddressString}: {cell.Text}");
}

이 코드는 Excel 파일을 성공적으로 로드하고 셀 값에 깔끔하게 액세스할 수 있게 합니다. WorkBook.Load 메서드는 파일 형식(XLSX, XLS, XLSM, CSV)을 자동 감지하고 모든 복합 파싱을 내부적으로 처리합니다. 익숙한 Excel 표기법인 "A1" 또는 "A1:C5"와 같은 범위를 사용하여 셀에 액세스할 수 있으므로 Excel에 익숙한 사람에게는 직관적입니다.

메모리 스트림에서 Excel 파일을 읽는 방법?

실제 애플리케이션은 자주 디스크 파일이 아닌 스트림에서 Excel 파일을 처리해야 합니다. 일반적인 시나리오에는 웹 업로드 처리, 데이터베이스에서 파일 검색, 클라우드 스토리지에서 데이터 처리 등이 포함됩니다. IronXL은 이러한 상황을 우아하게 처리합니다:

using IronXL;
using System.IO;
// Read Excel from a memory stream
byte[] fileBytes = File.ReadAllBytes("ProductData.xlsx");
using (MemoryStream stream = new MemoryStream(fileBytes))
{
    WorkBook workbook = WorkBook.FromStream(stream);
    WorkSheet worksheet = workbook.DefaultWorkSheet;
    // Process the data
    int rowCount = worksheet.RowCount;
    Console.WriteLine($"The worksheet has {rowCount} rows");
    // Read all data into a new DataTable, return dt
    var dataTable = worksheet.ToDataTable(false);
    // Return DataTable row count
    Console.WriteLine($"Loaded {dataTable.Rows.Count} data rows");
}

using IronXL;
using System.IO;
// Read Excel from a memory stream
byte[] fileBytes = File.ReadAllBytes("ProductData.xlsx");
using (MemoryStream stream = new MemoryStream(fileBytes))
{
    WorkBook workbook = WorkBook.FromStream(stream);
    WorkSheet worksheet = workbook.DefaultWorkSheet;
    // Process the data
    int rowCount = worksheet.RowCount;
    Console.WriteLine($"The worksheet has {rowCount} rows");
    // Read all data into a new DataTable, return dt
    var dataTable = worksheet.ToDataTable(false);
    // Return DataTable row count
    Console.WriteLine($"Loaded {dataTable.Rows.Count} data rows");
}

WorkBook.FromStream 메서드는 MemoryStream, FileStream 또는 네트워크 스트림을 포함하는 모든 스트림 유형을 허용합니다. 이 유연성 덕분에, Excel 파일을 다양한 소스에서 디스크에 먼저 저장하지 않고도 처리할 수 있습니다. 예시는 또한 워크시트 데이터를 DataTable로 변환하여 데이터베이스 및 데이터 바인딩 시나리오에 원활하게 통합되는 것을 보여줍니다.

Excel과 CSV 간 변환 방법

StreamReader는 CSV 파일을 처리할 수 있지만 Excel과 CSV 형식 간의 변환이 종종 필요합니다. IronXL은 이 변환을 간단하게 만듭니다:

using IronXL;
// Load an Excel file and save as CSV
WorkBook workbook = WorkBook.Load("data.xlsx");
workbook.SaveAsCsv("output.csv");
// Load a CSV file and save as Excel
WorkBook csvWorkbook = WorkBook.LoadCSV("input.csv");
csvWorkbook.SaveAs("output.xlsx");
// Export specific worksheet to CSV
WorkSheet worksheet = workbook.WorkSheets[0];
worksheet.SaveAsCsv("worksheet1.csv");

using IronXL;
// Load an Excel file and save as CSV
WorkBook workbook = WorkBook.Load("data.xlsx");
workbook.SaveAsCsv("output.csv");
// Load a CSV file and save as Excel
WorkBook csvWorkbook = WorkBook.LoadCSV("input.csv");
csvWorkbook.SaveAs("output.xlsx");
// Export specific worksheet to CSV
WorkSheet worksheet = workbook.WorkSheets[0];
worksheet.SaveAsCsv("worksheet1.csv");

이러한 변환은 데이터 형식을 변경하면서 데이터를 보존합니다. Excel을 CSV로 변환할 때 IronXL은 기본적으로 첫 번째 워크시트를 평면화하지만, 내보낼 워크시트를 지정할 수 있습니다. CSV에서 Excel로 변환하면 데이터 유형을 보존하고 미래의 서식 및 수식 추가가 가능한 적절한 형식의 스프레드시트를 생성합니다.

결론

StreamReader가 Excel 파일을 처리할 수 없는 이유는 플레인 텍스트와 Excel의 복잡한 파일 구조 간의 근본적인 차이에 기인합니다. StreamReader는 CSV 및 기타 텍스트 형식에는 완벽하게 작동하지만, 진정한 Excel 파일은 바이너리 및 XML 구조를 이해하는 IronXL과 같은 특화된 라이브러리가 필요합니다.

IronXL은 직관적인 API, 종합적인 형식 지원, 원활한 스트림 처리 기능을 갖춘 우아한 솔루션을 제공합니다. 웹 애플리케이션, 데스크톱 소프트웨어, 클라우드 서비스 등을 빌드할 때, IronXL은 모든 플랫폼에서 Excel 파일을 신뢰할 수 있게 처리합니다.

Excel 파일을 제대로 사용하기 시작할 준비가 되셨나요? IronXL의 무료 체험판 다운로드을 받고 C# 애플리케이션에서 번거로움 없이 Excel을 처리해보세요. 프로덕션 배포를 위해 프로젝트의 요구 사항에 가장 적합한 IronXL 라이선스 옵션을 고려하세요.