StreamReader 대신 C#에서 Excel 파일을 읽는 방법

스트림리더로 엑셀 파일을 읽을 수 없는 이유?

스트림리더는 텍스트 기반 리더입니다. 지정된 인코딩(UTF-8, ASCII 등)을 사용하여 문자 데이터를 줄 단위로 읽으며, 바이너리 구조나 압축된 아카이브에 대한 인식이 없습니다. 공식 .NET 스트림리더 문서에서는 이 클래스가 문자 인코딩 텍스트만을 위해 설계되었다고 확인합니다. Excel 파일은 간단한 스프레드시트처럼 보이지만, 사실 스트림리더이 해석할 수 없는 복잡한 바이너리 또는 ZIP-압축된 XML 구조입니다.

스트림리더으로 XLSX 파일을 열 때, 기본적으로 ZIP 아카이브를 일반 텍스트로 읽으려고 하는 것입니다. 그 결과는 스프레드시트 데이터가 아닌 바이너리 노이즈의 스트림입니다.

// This code will NOT work -- demonstrates the problem
using 스트림리더 reader = new 스트림리더("ProductData.xlsx");
string content = reader.ReadLine();
Console.WriteLine(content); // Outputs garbled binary data like "PK♥♦"

// This code will NOT work -- demonstrates the problem
using 스트림리더 reader = new 스트림리더("ProductData.xlsx");
string content = reader.ReadLine();
Console.WriteLine(content); // Outputs garbled binary data like "PK♥♦"

이 스니펫을 실행하면 스프레드시트 행 대신 PK♥♦ 같은 바이너리 문자나 유사한 잡음을 접하게 됩니다. 이는 다음과 같은 이유로 발생합니다:

• XLSX 파일은 여러 XML 파일로 구성된 ZIP 아카이브입니다: 워크시트, 스타일, 공유 문자열, 관계 등이 포함됩니다. Open XML SDK 문서는 이 구조에 대한 자세한 설명을 제공합니다.
• XLS 파일은 BIFF (Binary Interchange 파일 형식)라는 독점 바이너리 형식을 사용합니다.
• 스트림리더이 읽는 모든 바이트에 문자 인코딩을 적용하여 두 형식 모두에 대해 의미 없는 출력을 생성합니다.

IronXL을 .NET 프로젝트에 어떻게 설치합니까?

IronXL은 Microsoft Excel이 설치되지 않아도 엑셀 파일을 읽고, 작성하고, 생성할 수 있는 .NET 라이브러리입니다. XLSX, XLS, XLSM, CSV, TSV 형식을 지원하며, Windows, Linux, macOS, Docker 컨테이너에서 실행됩니다.

IronXL을 설치하려면 NuGet 패키지 관리자 콘솔 또는 .NET CLI를 사용합니다. 패키지는 NuGet.org에 IronXL로 게시되어 있습니다:

Install-Package IronXL
dotnet add package IronXL

Install-Package IronXL
dotnet add package IronXL

설치 후, 파일에 using IronXL; 지시문을 추가하면 Excel 문서 작업을 할 준비가 됩니다.

상세한 설치 단계 및 NuGet 구성 옵션은 IronXL NuGet 설치 가이드를 참조하세요. 무료 체험판 라이선스가 제공되므로 구매 전에 프로젝트에서 IronXL을 평가할 수 있습니다.

IronXL로 엑셀 파일을 어떻게 읽습니까?

IronXL은 C#에서 엑셀 파일을 읽기 위한 직관적인 API를 제공합니다. 스트림리더과 달리, IronXL은 Excel의 내부 구조를 이해하고 행, 열, 셀 값에 대한 깨끗한 접근을 제공합니다. IronXL 문서는 모든 지원 작업에 대한 전체 API 참조를 제공합니다.

다음은 top-level statements를 사용하여 IronXL로 엑셀 파일을 읽는 방법입니다:

using IronXL;

// Load the Excel file from disk
WorkBook workbook = WorkBook.Load("ProductData.xlsx");
WorkSheet worksheet = workbook.DefaultWorkSheet;

// Read a specific cell by address
string cellValue = worksheet["A1"].StringValue;
Console.WriteLine($"Cell A1 contains: {cellValue}");

// Iterate over a range of cells
foreach (var cell in worksheet["A1:C10"])
{
    Console.WriteLine($"{cell.AddressString}: {cell.Text}");
}

// Read a numeric value
decimal price = worksheet["B2"].DecimalValue;
Console.WriteLine($"Price: {price:C}");

using IronXL;

// Load the Excel file from disk
WorkBook workbook = WorkBook.Load("ProductData.xlsx");
WorkSheet worksheet = workbook.DefaultWorkSheet;

// Read a specific cell by address
string cellValue = worksheet["A1"].StringValue;
Console.WriteLine($"Cell A1 contains: {cellValue}");

// Iterate over a range of cells
foreach (var cell in worksheet["A1:C10"])
{
    Console.WriteLine($"{cell.AddressString}: {cell.Text}");
}

// Read a numeric value
decimal price = worksheet["B2"].DecimalValue;
Console.WriteLine($"Price: {price:C}");

WorkBook.Load 메서드는 파일 형식(XLSX, XLS, XLSM, CSV)을 자동으로 감지하고 모든 복잡한 구문 분석을 처리합니다. 셀에 접근할 때 "A1" 또는 "A1:C10" 같은 범위를 사용하여 표준 Excel 표기법을 사용하므로, 스프레드시트에 익숙한 사람이라면 코드를 즉시 읽을 수 있습니다.

using IronXL;

WorkBook workbook = WorkBook.Load("MultiSheet.xlsx");

// List all worksheets
foreach (WorkSheet sheet in workbook.WorkSheets)
{
    Console.WriteLine($"Sheet: {sheet.Name}, Rows: {sheet.RowCount}");
}

// Access a sheet by name
WorkSheet summary = workbook.GetWorkSheet("Summary");
string totalRevenue = summary["B20"].StringValue;
Console.WriteLine($"Total Revenue: {totalRevenue}");

// Access a sheet by index
WorkSheet firstSheet = workbook.WorkSheets[0];
int lastRow = firstSheet.RowCount;
Console.WriteLine($"Last row in first sheet: {lastRow}");

using IronXL;

WorkBook workbook = WorkBook.Load("MultiSheet.xlsx");

// List all worksheets
foreach (WorkSheet sheet in workbook.WorkSheets)
{
    Console.WriteLine($"Sheet: {sheet.Name}, Rows: {sheet.RowCount}");
}

// Access a sheet by name
WorkSheet summary = workbook.GetWorkSheet("Summary");
string totalRevenue = summary["B20"].StringValue;
Console.WriteLine($"Total Revenue: {totalRevenue}");

// Access a sheet by index
WorkSheet firstSheet = workbook.WorkSheets[0];
int lastRow = firstSheet.RowCount;
Console.WriteLine($"Last row in first sheet: {lastRow}");

메모리 스트림에서 엑셀 데이터를 어떻게 읽습니까?

실제 애플리케이션은 자주 디스크 파일이 아닌 스트림에서 Excel 파일을 처리해야 합니다. 일반적인 시나리오에는 웹 양식에서 파일 업로드 처리, 데이터베이스 BLOB 열에서 워크북 검색, 또는 클라우드 저장소(Azure Blob Storage, AWS S3)에서 다운로드한 파일 처리 등이 포함됩니다. IronXL은 WorkBook.FromStream을 통해 이러한 시나리오를 처리합니다:

using IronXL;
using System.IO;

// Simulate reading file bytes (e.g., from a database or web upload)
byte[] fileBytes = File.ReadAllBytes("ProductData.xlsx");

using MemoryStream stream = new MemoryStream(fileBytes);
WorkBook workbook = WorkBook.FromStream(stream);
WorkSheet worksheet = workbook.DefaultWorkSheet;

// Get row and column counts
Console.WriteLine($"Rows: {worksheet.RowCount}, Columns: {worksheet.ColumnCount}");

// Convert to DataTable for database or grid binding
var dataTable = worksheet.ToDataTable(useHeaderRow: true);
Console.WriteLine($"Loaded {dataTable.Rows.Count} data rows");

foreach (System.Data.DataRow row in dataTable.Rows)
{
    string productName = row["ProductName"]?.ToString() ?? string.Empty;
    string sku = row["SKU"]?.ToString() ?? string.Empty;
    Console.WriteLine($"Product: {productName}, SKU: {sku}");
}

using IronXL;
using System.IO;

// Simulate reading file bytes (e.g., from a database or web upload)
byte[] fileBytes = File.ReadAllBytes("ProductData.xlsx");

using MemoryStream stream = new MemoryStream(fileBytes);
WorkBook workbook = WorkBook.FromStream(stream);
WorkSheet worksheet = workbook.DefaultWorkSheet;

// Get row and column counts
Console.WriteLine($"Rows: {worksheet.RowCount}, Columns: {worksheet.ColumnCount}");

// Convert to DataTable for database or grid binding
var dataTable = worksheet.ToDataTable(useHeaderRow: true);
Console.WriteLine($"Loaded {dataTable.Rows.Count} data rows");

foreach (System.Data.DataRow row in dataTable.Rows)
{
    string productName = row["ProductName"]?.ToString() ?? string.Empty;
    string sku = row["SKU"]?.ToString() ?? string.Empty;
    Console.WriteLine($"Product: {productName}, SKU: {sku}");
}

WorkBook.FromStream은(는) Stream, MemoryStream, FileStream 또는 네트워크 스트림을 허용합니다. 이러한 유연성 덕분에 엑셀 데이터를 읽기 위해 디스크에 임시 파일을 작성할 필요가 없습니다. 어디서든 DataTable으로 변환하여 SqlBulkCopy, 데이터 바인딩 컨트롤, 보고 프레임워크와 직접 통합할 수 있습니다.

Excel과 CSV 형식 간에 어떻게 변환합니까?

스트림리더이(가) CSV 파일을 처리할 수 있지만, 생산 환경에서는 종종 Excel과 CSV 간의 데이터 이동이 필요합니다. IronXL은 형식 변환을 간편하게 만듭니다. 몇 줄의 코드로 Excel 데이터를 CSV로 내보내거나, CSV 데이터를 워크북에 가져올 수 있습니다:

using IronXL;

// Load an Excel file and save as CSV
WorkBook workbook = WorkBook.Load("SalesData.xlsx");
workbook.SaveAsCsv("output.csv");

// Load a CSV file and save as Excel
WorkBook csvWorkbook = WorkBook.LoadCSV("legacy-report.csv");
csvWorkbook.SaveAs("converted.xlsx");

// Export a specific worksheet to CSV
WorkSheet worksheet = workbook.WorkSheets[0];
worksheet.SaveAsCsv("sheet1-export.csv");

using IronXL;

// Load an Excel file and save as CSV
WorkBook workbook = WorkBook.Load("SalesData.xlsx");
workbook.SaveAsCsv("output.csv");

// Load a CSV file and save as Excel
WorkBook csvWorkbook = WorkBook.LoadCSV("legacy-report.csv");
csvWorkbook.SaveAs("converted.xlsx");

// Export a specific worksheet to CSV
WorkSheet worksheet = workbook.WorkSheets[0];
worksheet.SaveAsCsv("sheet1-export.csv");

이러한 변환은 컨테이너 형식을 변경하면서 데이터는 그대로 보존합니다. Excel을 CSV로 변환할 때 IronXL은 기본적으로 첫 번째 워크시트를 내보냅니다; 원하는 시트를 지정할 수 있습니다. CSV를 Excel로 변환하면, 올바르게 구조화된 워크북이 생성되며, 이후 서식을 지정하거나 공식을 추가하고 추가 데이터를 작성할 수 있습니다.

IronXL로 Excel 파일을 생성하고 서식 지정하는 방법은 무엇인가요?

Excel 데이터를 읽는 것은 워크플로우의 일부에 불과합니다. 많은 애플리케이션이 새 Excel 파일을 생성하고 서식을 적용해야 합니다. IronXL은 글꼴, 색상, 테두리, 숫자 형식, 및 셀 병합을 포함한 셀 서식 지정을 지원합니다:

using IronXL;

// Create a new workbook and worksheet
WorkBook workbook = WorkBook.Create(ExcelFileFormat.XLSX);
WorkSheet sheet = workbook.CreateWorkSheet("Report");

// Write headers with formatting
sheet["A1"].Value = "Product";
sheet["B1"].Value = "Units Sold";
sheet["C1"].Value = "Revenue";

// Apply bold formatting to header row
sheet["A1:C1"].Style.Font.Bold = true;
sheet["A1:C1"].Style.SetBackgroundColor("#4472C4");
sheet["A1:C1"].Style.Font.Color = "#FFFFFF";

// Write data rows
string[] products = { "Widget A", "Widget B", "Widget C" };
int[] units = { 120, 85, 210 };
decimal[] revenues = { 2400.00m, 1700.00m, 4200.00m };

for (int i = 0; i < products.Length; i++)
{
    sheet[$"A{i + 2}"].Value = products[i];
    sheet[$"B{i + 2}"].Value = units[i];
    sheet[$"C{i + 2}"].Value = revenues[i];
    sheet[$"C{i + 2}"].FormatString = "$#,##0.00";
}

// Save the workbook
workbook.SaveAs("FormattedReport.xlsx");
Console.WriteLine("Report created successfully.");

using IronXL;

// Create a new workbook and worksheet
WorkBook workbook = WorkBook.Create(ExcelFileFormat.XLSX);
WorkSheet sheet = workbook.CreateWorkSheet("Report");

// Write headers with formatting
sheet["A1"].Value = "Product";
sheet["B1"].Value = "Units Sold";
sheet["C1"].Value = "Revenue";

// Apply bold formatting to header row
sheet["A1:C1"].Style.Font.Bold = true;
sheet["A1:C1"].Style.SetBackgroundColor("#4472C4");
sheet["A1:C1"].Style.Font.Color = "#FFFFFF";

// Write data rows
string[] products = { "Widget A", "Widget B", "Widget C" };
int[] units = { 120, 85, 210 };
decimal[] revenues = { 2400.00m, 1700.00m, 4200.00m };

for (int i = 0; i < products.Length; i++)
{
    sheet[$"A{i + 2}"].Value = products[i];
    sheet[$"B{i + 2}"].Value = units[i];
    sheet[$"C{i + 2}"].Value = revenues[i];
    sheet[$"C{i + 2}"].FormatString = "$#,##0.00";
}

// Save the workbook
workbook.SaveAs("FormattedReport.xlsx");
Console.WriteLine("Report created successfully.");

기존의 워크북을 읽고 새로 서식이 지정된 파일을 생성할 수 있는 이 기능은 IronXL을 .NET 애플리케이션을 위한 완전한 Excel 솔루션으로 만듭니다. IronXL 기능 페이지에서 지원되는 작업의 자세한 내역을 검토하십시오.

IronXL을 프로덕션에서 어떻게 라이선스하고 배포합니까?

IronXL은 개발 및 테스트 용도로 무료입니다. 프로덕션 애플리케이션에서는 라이선스가 필요합니다. 제품 페이지에서 IronXL 라이선스 옵션을 탐색할 수 있으며, 이는 개발자, 팀 및 조직 계층을 커버하며 배포 요구 사항에 따라 다릅니다.

구매 후 모든 IronXL 호출 전에 코드에 라이선스 키를 적용하십시오:

IronXl.License.LicenseKey = "YOUR-LICENSE-KEY-HERE";

IronXl.License.LicenseKey = "YOUR-LICENSE-KEY-HERE";

또는 배포 환경에서 IRONXL_LICENSE_KEY 환경 변수를 설정하면 IronXL이 자동으로 이를 가져옵니다. 이는 키를 하드코딩할 수 없는 컨테이너화된 배포(Docker, Kubernetes) 및 클라우드 환경에서 선호되는 접근 방식입니다.

평가 목적을 위해 무료 체험판 라이선스는 특정 작업 부하에 대해 IronXL을 검증할 수 있도록 전체 기능을 제공합니다. 체험판은 신용 카드 없이 사용할 수 있으며 즉시 활성화됩니다.

Microsoft.Office.Interop.Excel 등과 같은 대안과 비교했을 때, IronXL은 여러 배포 이점을 가지고 있습니다:

• 서버에 Microsoft Excel 설치 필요 없음
• 클라우드 네이티브 애플리케이션에 중요함 -- 리눅스 및 Docker와 호환
• COM 객체 수명 주기 관리 또는 아파트 스레딩 문제 없음
• 서버 환경에서 더 빠른 시작 및 더 낮은 메모리 사용량
• 모든 지원 플랫폼에서 일관된 동작

이러한 특성 덕분에 IronXL은 Excel 파일을 처리해야 하는 .NET 애플리케이션에 있어, 온프레미스든 클라우드에 있든지 간에 실용적인 선택이 됩니다.