C#에서 Excel 데이터를 가져오고 읽고 조작하는 방법

StreamReader이 Excel 파일을 읽을 수 없는 이유는?

StreamReader은 일반 텍스트 파일에 대해 설계되었으며, 지정된 인코딩을 사용하여 문자를 한 줄씩 읽습니다. 스프레드시트 모양에도 불구하고 Excel 파일은 실제로는 StreamReader이 해석할 수 없는 복잡한 바이너리 또는 ZIP 압축 XML 구조입니다. 현대의 XLSX 파일은 Office Open XML 표준을 따르며, 이전 XLS 파일은 독점 바이너리 형식을 사용합니다.

static void Main(string[] args)
{
 // This code will NOT work - demonstrates the problem
 using (StreamReader reader = new StreamReader("ProductData.xlsx"))
 {
    string content = reader.ReadLine(); // Attempts to read Excel as text
    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(); // Attempts to read Excel as text
    Console.WriteLine(content); // Outputs garbled binary data
 }
}

이 코드 조각을 실행하면 스프레드시트 데이터 대신 "PK♥♦"와 같은 바이너리 데이터를 볼 것입니다. 이것은 XLSX 파일이 여러 XML 파일을 포함하는 ZIP 아카이브인 반면, XLS 파일은 독점 이진 포맷을 사용하기 때문에 발생합니다. StreamReader은 단순 텍스트를 예상하며 이러한 복잡한 구조를 문자로 해석하려고 하기 때문에 의미 없는 출력이 발생합니다. 컨테이너화된 애플리케이션에서 네이티브 Excel 라이브러리나 COM Interop을 사용하려고 하면 Microsoft Office를 컨테이너에 설치해야 하며, 이는 이미지 크기와 복잡성을 크게 증가시킵니다.

IronXL로 Excel 파일을 읽는 방법?

IronXL는 C#에서 Excel 파일을 읽기 위한 간단한 솔루션을 제공합니다. StreamReader와 달리, IronXL은 Excel의 내부 구조를 이해하고 데이터를 액세스하기 위한 직관적인 방법을 제공합니다. 이 라이브러리는 Windows, Linux, macOS 및 Docker 컨테이너를 지원하여 현대적이고 크로스 플랫폼 애플리케이션에 적합합니다. DevOps 팀에게 IronXL의 제로 종속성 아키텍처는 배포 중에 관리해야 할 기본 라이브러리나 COM 구성 요소가 없음을 의미합니다.

먼저 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'과 같은 Excel 표기법이나 'A1:C5'와 같은 범위를 사용할 수 있습니다.

컨테이너화된 배포를 위해 Excel 처리 기능을 검증하는 헬스 체크 엔드포인트를 쉽게 포함할 수 있습니다:

// Health check endpoint for containerized apps
public async Task<IActionResult> HealthCheck()
{
    try
    {
        // Test Excel functionality
        using var workbook = WorkBook.Create(ExcelFileFormat.XLSX);
        var sheet = workbook.CreateWorkSheet("HealthCheck");
        sheet["A1"].Value = DateTime.UtcNow;

        // Convert to byte array for validation
        var bytes = workbook.ToByteArray();
        return Ok(new { 
            status = "healthy", 
            excelSupport = true,
            timestamp = DateTime.UtcNow 
        });
    }
    catch (Exception ex)
    {
        return StatusCode(503, new { 
            status = "unhealthy", 
            error = ex.Message 
        });
    }
}

// Health check endpoint for containerized apps
public async Task<IActionResult> HealthCheck()
{
    try
    {
        // Test Excel functionality
        using var workbook = WorkBook.Create(ExcelFileFormat.XLSX);
        var sheet = workbook.CreateWorkSheet("HealthCheck");
        sheet["A1"].Value = DateTime.UtcNow;

        // Convert to byte array for validation
        var bytes = workbook.ToByteArray();
        return Ok(new { 
            status = "healthy", 
            excelSupport = true,
            timestamp = DateTime.UtcNow 
        });
    }
    catch (Exception ex)
    {
        return StatusCode(503, new { 
            status = "unhealthy", 
            error = ex.Message 
        });
    }
}

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

실제 애플리케이션은 자주 디스크 파일이 아닌 스트림에서 Excel 파일을 처리해야 합니다. 일반적인 시나리오로는 웹 업로드 처리, 데이터베이스에서 파일을 검색하거나 AWS S3 또는 Azure Blob Storage와 같은 클라우드 스토리지에서 데이터를 처리하는 것이 포함됩니다. 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 DataTable
    var dataTable = worksheet.ToDataTable(false);
    // Display 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 DataTable
    var dataTable = worksheet.ToDataTable(false);
    // Display DataTable row count 
    Console.WriteLine($"Loaded {dataTable.Rows.Count} data rows");
}

FromStream 메서드는 스트림 타입을 무엇이든 수용합니다(MemoryStream, FileStream 또는 네트워크 스트림). 이 유연한 방법은 먼저 디스크에 저장하지 않고 다양한 소스의 Excel 파일을 처리할 수 있도록 합니다. 예제는 또한 워크시트 데이터를 데이터 테이블로 변환하는 것을 보여주며, 이는 데이터베이스 및 데이터 바인딩 시나리오와 매끄럽게 통합됩니다. 마이크로서비스 아키텍처의 경우, 이 스트림 기반 접근 방식은 디스크 입출력을 최소화하고 성능을 향상시킵니다.

[HttpPost("upload")]
public async Task<IActionResult> ProcessExcelUpload(IFormFile file)
{
    if (file == null || file.Length == 0)
        return BadRequest("No file uploaded");

    using var stream = new MemoryStream();
    await file.CopyToAsync(stream);
    stream.Position = 0;

    var workbook = WorkBook.FromStream(stream);
    var worksheet = workbook.DefaultWorkSheet;

    // Process and return results
    var data = worksheet.ToDataSet();
    return Ok(new { 
        sheets = workbook.WorkSheets.Count,
        rows = worksheet.RowCount,
        processed = DateTime.UtcNow
    });
}

[HttpPost("upload")]
public async Task<IActionResult> ProcessExcelUpload(IFormFile file)
{
    if (file == null || file.Length == 0)
        return BadRequest("No file uploaded");

    using var stream = new MemoryStream();
    await file.CopyToAsync(stream);
    stream.Position = 0;

    var workbook = WorkBook.FromStream(stream);
    var worksheet = workbook.DefaultWorkSheet;

    // Process and return results
    var data = worksheet.ToDataSet();
    return Ok(new { 
        sheets = workbook.WorkSheets.Count,
        rows = worksheet.RowCount,
        processed = DateTime.UtcNow
    });
}

Excel과 CSV 간 변환 방법

StreamReader은 CSV 파일을 처리할 수 있지만, 종종 Excel과 CSV 형식 간 변환이 필요합니다. 엑셀 및 CSV 형식 변환. IronXL은 ETL 파이프라인 및 DevOps 워크플로에서 일반적인 데이터 통합 시나리오에 특히 유용하여 이 변환을 간단하게 만듭니다

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로 변환하는 것은 데이터 유형을 보존하고 미래의 형식지정 및 수식 추가를 가능하게 하는 제대로 포맷된 스프레드시트를 만듭니다.

자동화된 데이터 파이프라인을 위해 JSON 또는 XML 형식으로 내보내기할 수도 있습니다:

// Export Excel to multiple formats for data pipelines
var workbook = WorkBook.Load("report.xlsx");

// Export to JSON for API responses
string jsonData = workbook.ToJson();

// Export to HTML for web display
workbook.SaveAsHtml("report.html");

// Export to XML for integration systems
workbook.SaveAsXml("report.xml");

// Export specific range to DataTable for database insertion
var dataTable = workbook.DefaultWorkSheet["A1:D10"].ToDataTable();

// Export Excel to multiple formats for data pipelines
var workbook = WorkBook.Load("report.xlsx");

// Export to JSON for API responses
string jsonData = workbook.ToJson();

// Export to HTML for web display
workbook.SaveAsHtml("report.html");

// Export to XML for integration systems
workbook.SaveAsXml("report.xml");

// Export specific range to DataTable for database insertion
var dataTable = workbook.DefaultWorkSheet["A1:D10"].ToDataTable();

컨테이너 배포 모범 사례

Excel 처리 애플리케이션을 배포하는 DevOps 엔지니어에게 IronXL은 여러 가지 이점을 제공합니다. 다음은 Excel 처리를 최적화한 프로덕션 준비 완료 Dockerfile입니다:

FROM mcr.microsoft.com/dotnet/aspnet:8.0 AS base
WORKDIR /app
EXPOSE 80
EXPOSE 443

# Install any required system fonts for Excel rendering
RUN apt-get update && apt-get install -y \
    fontconfig \
    libfreetype6 \
    && rm -rf /var/lib/apt/lists/*

FROM mcr.microsoft.com/dotnet/sdk:8.0 AS build
WORKDIR /src
COPY ["YourApp.csproj", "."]
RUN dotnet restore
COPY . .
RUN dotnet build -c Release -o /app/build

FROM build AS publish
RUN dotnet publish -c Release -o /app/publish

FROM base AS final
WORKDIR /app
COPY --from=publish /app/publish .

# Set environment variables for IronXL
ENV IRONXL_LICENSE_KEY=${IRONXL_LICENSE_KEY}
ENV DOTNET_SYSTEM_GLOBALIZATION_INVARIANT=false

ENTRYPOINT ["dotnet", "YourApp.dll"]

이 Dockerfile은 최소한의 종속성으로 컨테이너에서 엑셀 처리 애플리케이션이 원활하게 실행되도록 보장합니다. 라이센싱은 환경 변수를 통해 처리되며, 다양한 배포 환경 간에 쉽게 관리할 수 있습니다.

C#에서 Excel 처리를 위한 다음 단계는 무엇인가요?

StreamReader이 Excel 파일을 처리하지 못하는 이유는 일반 텍스트 및 Excel의 복잡한 파일 구조 간의 근본적인 차이에서 비롯됩니다. StreamReader은 CSV 및 기타 텍스트 형식에는 완벽하게 작동하지만, 진정한 Excel 파일은 내부의 바이너리와 XML 구조를 이해하는 IronXL과 같은 전문 라이브러리가 필요합니다.

IronXL은 직관적인 API, 광범위한 형식 지원, 그리고 원활한 스트림 처리 기능으로 종합적인 솔루션을 제공합니다. 웹 애플리케이션, 데스크톱 소프트웨어 또는 클라우드 서비스를 구축하든 간에, IronXL은 모든 플랫폼에서 Excel 파일을 신뢰할 수 있게 처리합니다. 라이브러리의 조건부 서식, 차트, 수식, 및 고급 Excel 기능 지원은 Enterprise 애플리케이션을 위한 완전한 솔루션을 제공합니다.

DevOps 팀에게 IronXL의 컨테이너 친화적 아키텍처, 최소 시스템 종속성 및 견고한 성능 특징은 현대 클라우드 네이티브 애플리케이션에 이상적인 선택입니다. 라이브러리는 수평 확장을 지원하고, Kubernetes pods에서 원활하게 작동하며, CI/CD 파이프라인과 잘 통합됩니다.

Excel 파일을 제대로 사용하기 시작할 준비가 되셨나요? 귀하의 프로젝트에 가장 적합한 IronXL의 무료 체험판을 다운로드하세요. 이 라이브러리는 개발, 스테이징 및 프로덕션 배포를 포함한 유연한 라이센스 옵션을 제공하며, 컨테이너화된 환경 및 클라우드 네이티브 애플리케이션을 위한 옵션도 포함하고 있습니다.