C#에서 `StreamReader`를 사용하여 Excel 파일을 읽는 방법

왜 StreamReader는 Excel 파일을 읽을 수 없나요?

StreamReader는 정해진 인코딩을 이용해 문자 데이터를 라인 별로 읽는 일반 텍스트 파일에 맞게 설계되었습니다. Excel 파일은 스프레드시트처럼 보이지만 실은 복잡한 이진 또는 ZIP 압축된 XML 구조체로, StreamReader가 해석할 수 없습니다. 이 근본적인 차이로 인해 StreamReader는 생산 환경에서 Excel 워크북 처리에 부적합합니다.

using System;
using System.IO;

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

using System;
using System.IO;

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

이 코드 스니펫을 실행하면 스프레드시트 데이터 대신 "PK♥♦"와 같은 바이너리 문자나 유사한 기호가 표시됩니다. 이는 XLSX 파일이 여러 XML 파일을 포함한 ZIP 아카이브인 반면, XLS 파일은 독점적인 바이너리 형식을 사용하기 때문에 발생합니다. StreamReader는 일반 텍스트를 예상하고 이러한 복잡한 구조를 문자로 해석하려 시도해 의미 없는 출력을 내놓습니다. 컨테이너화된 애플리케이션의 경우, 이 바이너리 데이터가 인코딩 문제와 예상치 못한 충돌을 일으킬 수 있습니다.

IronXL로 Excel 파일을 읽는 방법?

IronXL는 C#에서 Excel 파일을 읽는 데 있어 직관적인 솔루션을 제공합니다. StreamReader와 달리, IronXL은 Excel의 내부 구조를 이해하고 데이터를 접근하기 위한 직관적인 메소드를 제공합니다. 이 라이브러리는 Windows, Linux, macOS 및 Docker 컨테이너를 지원하여 현대적이고 크로스 플랫폼 애플리케이션에 이상적입니다. 가벼운 특성과 최소한의 종속성은 컨테이너화된 배포에 완벽합니다.

Install-Package IronXl.Excel

# Add to your Dockerfile
RUN dotnet add package IronXl.Excel --version 2024.12.5

using IronXL;
using System;
using System.Linq;

class ExcelReader
{
    public static void ReadExcelData(string filePath)
    {
        try
        {
            // Load the Excel file
            WorkBook workbook = WorkBook.Load(filePath);
            WorkSheet worksheet = workbook.DefaultWorkSheet;

            // Read specific cell values with null checking
            var cellA1 = worksheet["A1"];
            if (cellA1 != null)
            {
                string cellValue = cellA1.StringValue;
                Console.WriteLine($"Cell A1 contains: {cellValue}");
            }

            // Read a range of cells with LINQ
            var range = worksheet["A1:C5"];
            var nonEmptyCells = range.Where(cell => !cell.IsEmpty);

            foreach (var cell in nonEmptyCells)
            {
                Console.WriteLine($"{cell.AddressString}: {cell.Text}");
            }

            // Get row and column counts for validation
            int rowCount = worksheet.RowCount;
            int columnCount = worksheet.ColumnCount;
            Console.WriteLine($"Worksheet dimensions: {rowCount} rows × {columnCount} columns");
        }
        catch (Exception ex)
        {
            Console.WriteLine($"Error reading Excel file: {ex.Message}");
            // Log to your monitoring system
        }
    }
}

using IronXL;
using System;
using System.Linq;

class ExcelReader
{
    public static void ReadExcelData(string filePath)
    {
        try
        {
            // Load the Excel file
            WorkBook workbook = WorkBook.Load(filePath);
            WorkSheet worksheet = workbook.DefaultWorkSheet;

            // Read specific cell values with null checking
            var cellA1 = worksheet["A1"];
            if (cellA1 != null)
            {
                string cellValue = cellA1.StringValue;
                Console.WriteLine($"Cell A1 contains: {cellValue}");
            }

            // Read a range of cells with LINQ
            var range = worksheet["A1:C5"];
            var nonEmptyCells = range.Where(cell => !cell.IsEmpty);

            foreach (var cell in nonEmptyCells)
            {
                Console.WriteLine($"{cell.AddressString}: {cell.Text}");
            }

            // Get row and column counts for validation
            int rowCount = worksheet.RowCount;
            int columnCount = worksheet.ColumnCount;
            Console.WriteLine($"Worksheet dimensions: {rowCount} rows × {columnCount} columns");
        }
        catch (Exception ex)
        {
            Console.WriteLine($"Error reading Excel file: {ex.Message}");
            // Log to your monitoring system
        }
    }
}

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

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

using IronXL;
using System.IO;
using System.Data;
using System.Threading.Tasks;

public class StreamProcessor
{
    // Async method for container health checks
    public async Task<bool> ProcessExcelStreamAsync(byte[] fileBytes)
    {
        try
        {
            using (MemoryStream stream = new MemoryStream(fileBytes))
            {
                // Load from stream asynchronously
                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 DataTable for database operations
                var dataTable = worksheet.ToDataTable(true); // true = use first row as headers

                // Validate data integrity
                if (dataTable.Rows.Count == 0)
                {
                    Console.WriteLine("Warning: No data rows found");
                    return false;
                }

                Console.WriteLine($"Loaded {dataTable.Rows.Count} data rows");
                Console.WriteLine($"Columns: {string.Join(", ", dataTable.Columns.Cast<DataColumn>().Select(c => c.ColumnName))}");

                // Example: Process data for container metrics
                foreach (DataRow row in dataTable.Rows)
                {
                    // Your processing logic here
                    await ProcessRowAsync(row);
                }

                return true;
            }
        }
        catch (Exception ex)
        {
            Console.WriteLine($"Stream processing error: {ex.Message}");
            return false;
        }
    }

    private async Task ProcessRowAsync(DataRow row)
    {
        // Simulate async processing
        await Task.Delay(10);
    }
}

using IronXL;
using System.IO;
using System.Data;
using System.Threading.Tasks;

public class StreamProcessor
{
    // Async method for container health checks
    public async Task<bool> ProcessExcelStreamAsync(byte[] fileBytes)
    {
        try
        {
            using (MemoryStream stream = new MemoryStream(fileBytes))
            {
                // Load from stream asynchronously
                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 DataTable for database operations
                var dataTable = worksheet.ToDataTable(true); // true = use first row as headers

                // Validate data integrity
                if (dataTable.Rows.Count == 0)
                {
                    Console.WriteLine("Warning: No data rows found");
                    return false;
                }

                Console.WriteLine($"Loaded {dataTable.Rows.Count} data rows");
                Console.WriteLine($"Columns: {string.Join(", ", dataTable.Columns.Cast<DataColumn>().Select(c => c.ColumnName))}");

                // Example: Process data for container metrics
                foreach (DataRow row in dataTable.Rows)
                {
                    // Your processing logic here
                    await ProcessRowAsync(row);
                }

                return true;
            }
        }
        catch (Exception ex)
        {
            Console.WriteLine($"Stream processing error: {ex.Message}");
            return false;
        }
    }

    private async Task ProcessRowAsync(DataRow row)
    {
        // Simulate async processing
        await Task.Delay(10);
    }
}

WorkBook.FromStream 메소드는 MemoryStream, FileStream, 또는 네트워크 스트림과 같은 어떠한 스트림 유형도 수용합니다. 이 유연성 덕분에 디스크에 저장하지 않아도 다양한 소스에서 Excel 파일을 처리할 수 있으며, 이 예제는 워크시트 데이터를 DataTable로 변환하여 데이터베이스 및 데이터 결합 시나리오와 원활하게 통합되는 모습을 보여줍니다. 여기에서 표시된 비동기 패턴은 컨테이너 상태 점검 및 준비 상태 프로브에 이상적입니다.

Excel과 CSV 간 변환 방법

StreamReader는 CSV 파일을 처리할 수 있지만, 종종 Excel과 CSV 형식을 변환해야 할 필요가 있습니다. IronXL은 프로덕션 환경에 최적화된 내장 메서드로 이 변환을 간단하게 만듭니다:

using IronXL;
using System;
using System.IO;

public class FormatConverter
{
    public static void ConvertExcelFormats()
    {
        try
        {
            // Load an Excel file and save as CSV with options
            WorkBook workbook = WorkBook.Load("data.xlsx");

            // Save with UTF-8 encoding for international character support
            workbook.SaveAsCsv("output.csv", ";"); // Use semicolon as delimiter

            // Load a CSV file with custom settings
            WorkBook csvWorkbook = WorkBook.LoadCSV("input.csv", ",", "UTF-8");
            csvWorkbook.SaveAs("output.xlsx", FileFormat.XLSX);

            // Export specific worksheet to CSV
            if (workbook.WorkSheets.Count > 0)
            {
                WorkSheet worksheet = workbook.WorkSheets[0];
                worksheet.SaveAsCsv("worksheet1.csv");

                // Advanced: Export only specific range
                var dataRange = worksheet["A1:D100"];
                // Process range data before export
                foreach (var cell in dataRange)
                {
                    if (cell.IsNumeric)
                    {
                        // Apply formatting for CSV output
                        cell.FormatString = "0.00";
                    }
                }
            }

            Console.WriteLine("Conversion completed successfully");
        }
        catch (Exception ex)
        {
            Console.WriteLine($"Conversion error: {ex.Message}");
            throw; // Re-throw for container orchestrator handling
        }
    }
}

using IronXL;
using System;
using System.IO;

public class FormatConverter
{
    public static void ConvertExcelFormats()
    {
        try
        {
            // Load an Excel file and save as CSV with options
            WorkBook workbook = WorkBook.Load("data.xlsx");

            // Save with UTF-8 encoding for international character support
            workbook.SaveAsCsv("output.csv", ";"); // Use semicolon as delimiter

            // Load a CSV file with custom settings
            WorkBook csvWorkbook = WorkBook.LoadCSV("input.csv", ",", "UTF-8");
            csvWorkbook.SaveAs("output.xlsx", FileFormat.XLSX);

            // Export specific worksheet to CSV
            if (workbook.WorkSheets.Count > 0)
            {
                WorkSheet worksheet = workbook.WorkSheets[0];
                worksheet.SaveAsCsv("worksheet1.csv");

                // Advanced: Export only specific range
                var dataRange = worksheet["A1:D100"];
                // Process range data before export
                foreach (var cell in dataRange)
                {
                    if (cell.IsNumeric)
                    {
                        // Apply formatting for CSV output
                        cell.FormatString = "0.00";
                    }
                }
            }

            Console.WriteLine("Conversion completed successfully");
        }
        catch (Exception ex)
        {
            Console.WriteLine($"Conversion error: {ex.Message}");
            throw; // Re-throw for container orchestrator handling
        }
    }
}

이러한 변환은 데이터 형식을 변경하면서 데이터를 보존합니다. Excel을 CSV로 변환할 때 IronXL은 기본적으로 첫 번째 워크시트만 평면화하지만, 내보낼 워크시트를 지정할 수 있습니다. CSV를 Excel로 변환하면 적절히 포맷된 스프레드시트가 만들어져 데이터 형식을 유지하고 향후 포맷 및 수식 추가를 가능하게 합니다.

결론

StreamReader가 Excel 파일을 처리하지 못하는 이유는 간단한 텍스트와 Excel의 복잡한 파일 구조의 근본적인 차이에서 비롯됩니다. StreamReader는 CSV 및 다른 텍스트 형식에 완벽하게 작동하지만, 진정한 Excel 파일은 내부의 이진 및 XML 구조를 이해하는 IronXL 같은 특수한 라이브러리가 필요합니다. DevOps 팀이 컨테이너화된 애플리케이션을 관리할 때, 적절한 라이브러리를 선택하는 것이 안정적인 배포 파이프라인을 유지하는 데 중요합니다.

IronXL은 직관적인 API, 포괄적인 형식 지원 및 매끄러운 스트림 처리 기능으로 우아한 솔루션을 제공합니다. 웹 애플리케이션, 데스크톱 소프트웨어 또는 클라우드 서비스를 구축하든, IronXL은 모든 플랫폼에서 Excel 파일을 확실하게 처리합니다. 그 컨테이너 친화적 설계, 최소한의 종속성, 뛰어난 성능 특성 덕분에 현대 DevOps 워크플로우에 이상적인 선택입니다.

Excel 파일을 제대로 사용하기 시작할 준비가 되셨나요? IronXL의 무료 체험판을 다운로드하여 환경에서 그 기능을 탐색하세요. 라이브러리는 포괄적인 문서, 코드 예제 및 컨테이너화된 환경을 위한 배포 가이드를 포함합니다.