Excel이 설치되어 있지 않은 상태에서 C#으로 Open Office Excel 파일을 읽는 방법

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

Install-Package IronXL
dotnet add package IronXL

Install-Package IronXL
dotnet add package IronXL

C#에서 OpenOffice 또는 Excel 파일을 어떻게 로드합니까?

IronXL은 WorkBook.Load 메소드를 통해 ODS, XLS, XLSX 및 CSV 파일을 동일하게 처리합니다. 절대 파일 경로나 상대 파일 경로를 전달하면, 라이브러리는 파일 확장자가 아닌 파일 헤더에서 형식을 감지합니다. 이는 파일이 .ods에서 .xlsx로 이름이 변경되어도 여전히 올바르게 읽힌다는 것을 의미합니다.

using IronXL;

// Load an OpenDocument Spreadsheet (.ods) produced by LibreOffice Calc or OpenOffice
WorkBook workbook = WorkBook.Load("quarterly_report.ods");

// Access the first worksheet by index
WorkSheet sheet = workbook.WorkSheets[0];

// Read a cell value
string companyName = sheet["A1"].StringValue;
int recordCount   = sheet["B1"].IntValue;

Console.WriteLine($"Company : {companyName}");
Console.WriteLine($"Records : {recordCount}");

using IronXL;

// Load an OpenDocument Spreadsheet (.ods) produced by LibreOffice Calc or OpenOffice
WorkBook workbook = WorkBook.Load("quarterly_report.ods");

// Access the first worksheet by index
WorkSheet sheet = workbook.WorkSheets[0];

// Read a cell value
string companyName = sheet["A1"].StringValue;
int recordCount   = sheet["B1"].IntValue;

Console.WriteLine($"Company : {companyName}");
Console.WriteLine($"Records : {recordCount}");

같은 호출이 XLSX 및 XLS 파일에서도 작동합니다 -- 경로만 변경하세요. WorkBook.Load는 소스 형식에 관계없이 동일한 강타입 객체를 반환하므로 파일이 Microsoft Excel, LibreOffice 또는 기타 ODF 호환 응용 프로그램에서 생성되었는지 여부에 관계없이 코드의 나머지 부분은 동일하게 유지됩니다.

워크시트에서 모든 행과 셀을 어떻게 읽습니까?

using IronXL;

WorkBook workbook  = WorkBook.Load("customers.xlsx");
WorkSheet worksheet = workbook.WorkSheets[0];

Console.WriteLine($"Total rows    : {worksheet.RowCount}");
Console.WriteLine($"Total columns : {worksheet.ColumnCount}");
Console.WriteLine();

foreach (var row in worksheet.Rows)
{
    foreach (var cell in row)
    {
        if (!cell.IsEmpty)
            Console.Write($"{cell.StringValue,-20}");
    }
    Console.WriteLine();
}

using IronXL;

WorkBook workbook  = WorkBook.Load("customers.xlsx");
WorkSheet worksheet = workbook.WorkSheets[0];

Console.WriteLine($"Total rows    : {worksheet.RowCount}");
Console.WriteLine($"Total columns : {worksheet.ColumnCount}");
Console.WriteLine();

foreach (var row in worksheet.Rows)
{
    foreach (var cell in row)
    {
        if (!cell.IsEmpty)
            Console.Write($"{cell.StringValue,-20}");
    }
    Console.WriteLine();
}

셀에서 형식화된 값을 어떻게 추출합니까?

using IronXL;

WorkBook workbook = WorkBook.Load("inventory.xlsx");
WorkSheet sheet   = workbook.GetWorkSheet("Products");

// Typed accessors handle conversion automatically
string  productName = sheet["A2"].StringValue;
int     quantity    = sheet["B2"].IntValue;
decimal unitPrice   = sheet["C2"].DecimalValue;
bool    inStock     = sheet["D2"].BoolValue;
DateTime? lastAudit = sheet["E2"].DateTimeValue;

Console.WriteLine($"Product  : {productName}");
Console.WriteLine($"Qty      : {quantity}");
Console.WriteLine($"Price    : {unitPrice:C}");
Console.WriteLine($"In Stock : {inStock}");
Console.WriteLine($"Audited  : {lastAudit?.ToString("d") ?? "Never"}");

using IronXL;

WorkBook workbook = WorkBook.Load("inventory.xlsx");
WorkSheet sheet   = workbook.GetWorkSheet("Products");

// Typed accessors handle conversion automatically
string  productName = sheet["A2"].StringValue;
int     quantity    = sheet["B2"].IntValue;
decimal unitPrice   = sheet["C2"].DecimalValue;
bool    inStock     = sheet["D2"].BoolValue;
DateTime? lastAudit = sheet["E2"].DateTimeValue;

Console.WriteLine($"Product  : {productName}");
Console.WriteLine($"Qty      : {quantity}");
Console.WriteLine($"Price    : {unitPrice:C}");
Console.WriteLine($"In Stock : {inStock}");
Console.WriteLine($"Audited  : {lastAudit?.ToString("d") ?? "Never"}");

여러 이름이 지정된 워크시트를 어떻게 작업합니까?

using IronXL;

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

// Option 1: access by name (throws if the sheet does not exist)
WorkSheet januarySheet = workbook.GetWorkSheet("January");

// Option 2: iterate all sheets in the workbook
foreach (WorkSheet ws in workbook.WorkSheets)
{
    Console.WriteLine($"Sheet: {ws.Name}  |  Rows: {ws.RowCount}");

    // Read the header row from each sheet
    string header = ws["A1"].StringValue;
    Console.WriteLine($"  Header: {header}");
}

// Option 3: access by zero-based index
WorkSheet lastSheet = workbook.WorkSheets[workbook.WorkSheets.Count - 1];
Console.WriteLine($"Last sheet: {lastSheet.Name}");

using IronXL;

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

// Option 1: access by name (throws if the sheet does not exist)
WorkSheet januarySheet = workbook.GetWorkSheet("January");

// Option 2: iterate all sheets in the workbook
foreach (WorkSheet ws in workbook.WorkSheets)
{
    Console.WriteLine($"Sheet: {ws.Name}  |  Rows: {ws.RowCount}");

    // Read the header row from each sheet
    string header = ws["A1"].StringValue;
    Console.WriteLine($"  Header: {header}");
}

// Option 3: access by zero-based index
WorkSheet lastSheet = workbook.WorkSheets[workbook.WorkSheets.Count - 1];
Console.WriteLine($"Last sheet: {lastSheet.Name}");

병합된 셀과 서식이 지정된 영역을 어떻게 처리하나요?

보고서와 대시보드는 종종 헤딩, 그룹화된 레이블, 요약 행을 위해 병합된 셀을 사용합니다. IronXL은 병합된 영역의 좌상단 셀 값을 읽는데 이는 엑셀이 표시하는 것과 정확히 같습니다:

using IronXL;

WorkBook workbook = WorkBook.Load("report_with_merges.xlsx");
WorkSheet sheet   = workbook.DefaultWorkSheet;

// The merged region A1:D1 stores its value in cell A1
string reportTitle = sheet["A1"].StringValue;
Console.WriteLine($"Report title : {reportTitle}");

// Read cell formatting metadata
var titleCell = sheet["A1"];
Console.WriteLine($"Bold         : {titleCell.Style.Font.Bold}");
Console.WriteLine($"Font size    : {titleCell.Style.Font.Height}");

// Scan an entire column for non-empty section headers
foreach (var cell in sheet["A1:A100"])
{
    if (!cell.IsEmpty && cell.Style.Font.Bold)
        Console.WriteLine($"Section header at {cell.AddressString}: {cell.StringValue}");
}

using IronXL;

WorkBook workbook = WorkBook.Load("report_with_merges.xlsx");
WorkSheet sheet   = workbook.DefaultWorkSheet;

// The merged region A1:D1 stores its value in cell A1
string reportTitle = sheet["A1"].StringValue;
Console.WriteLine($"Report title : {reportTitle}");

// Read cell formatting metadata
var titleCell = sheet["A1"];
Console.WriteLine($"Bold         : {titleCell.Style.Font.Bold}");
Console.WriteLine($"Font size    : {titleCell.Style.Font.Height}");

// Scan an entire column for non-empty section headers
foreach (var cell in sheet["A1:A100"])
{
    if (!cell.IsEmpty && cell.Style.Font.Bold)
        Console.WriteLine($"Section header at {cell.AddressString}: {cell.StringValue}");
}

Style 속성 트리는 OOXML SpreadsheetML 사양의 구조를 반영하므로, Open XML SDK와 작업한 경험이 있다면 속성 이름이 친숙하게 느껴질 것입니다. 하지만 IronXL은 모든 복잡성을 클린한 API로 감싸서, 여러분이 XML 조작을 하지 않아도 됩니다.

같은 API로 CSV 파일을 어떻게 가져오나요?

데이터베이스 내보내기, CRM 시스템 및 레거시 애플리케이션에서 생성된 CSV 파일은 동일한 WorkBook.Load 호출을 통해 읽을 수 있습니다. IronXL은 파일 내용에서 구분자를 추론합니다:

using IronXL;

// Load a comma-separated values file -- same method, same API
WorkBook csvWorkbook  = WorkBook.Load("export.csv");
WorkSheet csvSheet    = csvWorkbook.DefaultWorkSheet;

Console.WriteLine($"CSV rows loaded: {csvSheet.RowCount}");

// Process rows exactly like any other worksheet
foreach (var row in csvSheet.Rows)
{
    string id   = row[0].StringValue;
    string name = row[1].StringValue;
    Console.WriteLine($"{id,-10} {name}");
}

using IronXL;

// Load a comma-separated values file -- same method, same API
WorkBook csvWorkbook  = WorkBook.Load("export.csv");
WorkSheet csvSheet    = csvWorkbook.DefaultWorkSheet;

Console.WriteLine($"CSV rows loaded: {csvSheet.RowCount}");

// Process rows exactly like any other worksheet
foreach (var row in csvSheet.Rows)
{
    string id   = row[0].StringValue;
    string name = row[1].StringValue;
    Console.WriteLine($"{id,-10} {name}");
}

불러온 후, csvWorkbook.SaveAs("output.xlsx")을 사용하여 데이터를 XLSX로 저장할 수 있습니다. 이는 CSV-엑셀 변환 파이프라인의 일반적인 패턴입니다 -- CSV 파일을 받아 계산된 열 또는 형식으로 강화하고, 사용자에게 형식이 지정된 XLSX 보고서를 반환합니다.

탭으로 구분된 파일이나 사용자 정의 구분자를 위해, WorkBook.LoadCSV("file.tsv", file형식: ExcelFile형식.TSV)를 사용하여 형식을 명시적으로 지정하십시오.

IronXL과 Microsoft.Office.Interop.Excel은 어떻게 비교되나요?

Excel 처리를 Linux와 Docker에 어떻게 배포하나요?

서버 배포는 IronXL의 Excel 독립성이 가장 가치 있는 부분입니다. Windows에서 작성한 동일한 코드를 Ubuntu, Alpine Linux, 또는 macOS에서 변경 없이 실행할 수 있습니다. 컨테이너화된 배포의 경우, Dockerfile에 특별한 설정이 필요 없습니다:

# Standard .NET runtime image -- no Office packages needed
FROM mcr.microsoft.com/dotnet/runtime:10.0
WORKDIR /app
COPY --from=build /app/publish .
ENTRYPOINT ["dotnet", "ExcelProcessor.dll"]

# Standard .NET runtime image -- no Office packages needed
FROM mcr.microsoft.com/dotnet/runtime:10.0
WORKDIR /app
COPY --from=build /app/publish .
ENTRYPOINT ["dotnet", "ExcelProcessor.dll"]

Azure Functions 및 AWS Lambda의 경우, 추가 설정 없이 관리되는 런타임 내에서 IronXL이 작동합니다. 콜드 스타트 오버헤드는 COM 초기화 단계가 없으므로 최소화됩니다.

스레드 안전성이 내장되어 있습니다: 여러 스레드가 서로 조정 없이 서로 다른 WorkBook 인스턴스를 동시에 열 수 있습니다. 사용자 업로드 스프레드시트를 가져오는 백그라운드 작업 예시처럼 수천 개의 파일을 병렬로 처리해야 하는 경우, 손상 위험 없이 Parallel.ForEach 또는 Task.WhenAll을 여러 WorkBook 인스턴스에 걸쳐 사용할 수 있습니다.

IronXL은 요청된 워크시트만 메모리에 로드하므로 메모리 사용량이 예측 가능합니다. 초기화 시 전체 워크북을 메모리에 로드하지 않습니다. 매우 큰 파일의 경우, 이 구분이 중요합니다: 50MB 시트 10개로 구성된 워크북은 단일 시트를 읽는 데 500MB의 RAM이 필요하지 않습니다. IronXL 성능 문서에서는 대용량 파일 처리 시나리오를 처리하기 위한 추가 전략을 다룹니다.

다음 단계는 무엇입니까?

프로젝트에서 IronXL을 검증하는 가장 빠른 방법은 NuGet 패키지를 설치하고 이 가이드의 예제를 실제 환경의 파일에 대해서 실행하는 것입니다. 무료 체험판 라이선스는 코드 변경 없이 모든 기능을 잠금 해제하여 상용 제품 준비가 완료됩니다.

파일 읽기를 보완하는 관련 IronXL 기능탐색:

• C#에서 Excel 파일 작성 및 생성 -- 프로그램적으로 보고서 및 데이터 내보내기 작성
• 셀, 행 및 열 서식 지정 -- 코드에서 색상, 글꼴 및 테두리 적용
• C#에서 Excel 수식 작동 -- 수식 셀 읽기 및 쓰기
• .NET에서 Excel을 PDF로 변환 -- 스프레드시트 데이터로부터 PDF 보고서 생성
• IronXL API 문서 -- 모든 클래스 및 메소드에 대한 전체 참조
• IronXL 라이선스 및 가격 -- 개인 개발자 및 기업 팀을 위한 옵션
• IronXL NuGet 페이지 -- 모든 프로젝트 유형에 대한 설치 지침
• IronXL 튜토리얼 -- 일반적인 사용 사례를 위한 단계별 가이드
• IronXL과 EPPlus 비교 -- 기능 및 라이선스 비교
• IronXL 제품 홈 -- 기능 개요 및 시작 리소스

라이선스, 크로스 플랫폼 지원 또는 특정 파일 형식 요구 사항에 대한 질문은 IronXL 지원 팀이 라이브 채팅 및 이메일을 통해 가능합니다.

지금 바로 IronXL으로 시작하세요.

무료로 시작하세요