Microsoft Office 없이 C#에서 Excel 파일을 여는 방법

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

시작하는 데 몇 초밖에 걸리지 않습니다. 프로젝트를 열고 다음 패키지 관리자 중 하나를 사용하십시오:

Install-Package IronXL
dotnet add package IronXL

Install-Package IronXL
dotnet add package IronXL

또는 Visual Studio를 열고, 프로젝트를 우클릭하여 'NuGet 패키지 관리'를 선택하고, 'IronXL'을 검색하여 설치를 클릭하십시오. 설치 가이드는 Docker 및 Azure를 포함한 모든 지원 환경을 다룹니다.

설치가 완료되면 파일 상단에 네임스페이스를 추가하십시오:

using IronXL;

using IronXL;

그 한 줄이면 충분합니다. 복잡한 COM 참조가 없고, Office 종속성이 없으며, 특정 버전의 어셈블리도 필요 없습니다. 무료 평가 키를 얻으려면 IronXL 체험 라이선스 페이지를 방문하세요.

Excel 워크북을 열고 셀 값을 읽는 방법은?

핵심 API는 간단합니다. 워크북을 로드하고 워크시트를 선택하여 주소로나 반복을 통해 셀에 접근합니다.

using IronXL;

// Load any Excel file -- XLSX, XLS, CSV, or TSV
WorkBook workbook = WorkBook.Load("example.xlsx");

// Access the second worksheet (zero-indexed)
WorkSheet worksheet = workbook.WorkSheets[1];

// Read a specific cell value
데시멀 revenue = worksheet["E2"].DecimalValue;
Console.WriteLine($"Order Total: {revenue}");

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

using IronXL;

// Load any Excel file -- XLSX, XLS, CSV, or TSV
WorkBook workbook = WorkBook.Load("example.xlsx");

// Access the second worksheet (zero-indexed)
WorkSheet worksheet = workbook.WorkSheets[1];

// Read a specific cell value
데시멀 revenue = worksheet["E2"].DecimalValue;
Console.WriteLine($"Order Total: {revenue}");

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

WorkBook.Load()는 파일 형식을 자동으로 감지합니다. 파일이 XLS인지 XLSX인지 지정할 필요가 없습니다. workbook.GetWorkSheet("Sheet1")를 사용하여 인덱스 또는 이름으로 워크시트에 액세스합니다. 각 셀은 IntValue, DecimalValue, DateTimeValue, 및 Text와 같은 유형이 선언된 속성을 노출합니다.

파일 열기에 대한 자세한 옵션은 워크북 열기 사용법 가이드를 참조하세요.

using IronXL;

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

// Access worksheet by exact name
WorkSheet salesSheet = workbook.GetWorkSheet("Sales Data");
Console.WriteLine($"Sales sheet rows: {salesSheet.RowCount}");

// Iterate all worksheets in the workbook
foreach (WorkSheet sheet in workbook.WorkSheets)
{
    if (sheet.Name.Contains("Inventory"))
    {
        Console.WriteLine($"Found inventory sheet: {sheet.Name}");
    }
}

using IronXL;

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

// Access worksheet by exact name
WorkSheet salesSheet = workbook.GetWorkSheet("Sales Data");
Console.WriteLine($"Sales sheet rows: {salesSheet.RowCount}");

// Iterate all worksheets in the workbook
foreach (WorkSheet sheet in workbook.WorkSheets)
{
    if (sheet.Name.Contains("Inventory"))
    {
        Console.WriteLine($"Found inventory sheet: {sheet.Name}");
    }
}

Excel 셀에서 다양한 데이터 유형을 어떻게 읽나요?

IronXL은 모든 일반적인 Excel 데이터 유형에 대해 유형화된 접근자를 제공합니다. 수동 파싱 없이 문자열, 정수, 소수, 날짜, 부울, 수식 결과를 읽을 수 있습니다.

using IronXL;

WorkBook wb = WorkBook.Load(@"C:\Data\Inventory.xlsx");
WorkSheet ws = wb.GetWorkSheet("Products");

// Read different data types directly
끈 productName = ws["A2"].StringValue;
인트 quantity       = ws["B2"].IntValue;
데시멀 price      = ws["C2"].DecimalValue;
DateTime updated   = ws["D2"].DateTimeValue;

// Use aggregate functions on ranges for performance
데시멀 totalStock = ws["B2:B100"].Sum();
데시멀 maxPrice   = ws["C2:C100"].Max();

Console.WriteLine($"Product: {productName}, Qty: {quantity}, Price: {price:C}");
Console.WriteLine($"Total stock units: {totalStock}, Highest price: {maxPrice:C}");

using IronXL;

WorkBook wb = WorkBook.Load(@"C:\Data\Inventory.xlsx");
WorkSheet ws = wb.GetWorkSheet("Products");

// Read different data types directly
끈 productName = ws["A2"].StringValue;
인트 quantity       = ws["B2"].IntValue;
데시멀 price      = ws["C2"].DecimalValue;
DateTime updated   = ws["D2"].DateTimeValue;

// Use aggregate functions on ranges for performance
데시멀 totalStock = ws["B2:B100"].Sum();
데시멀 maxPrice   = ws["C2:C100"].Max();

Console.WriteLine($"Product: {productName}, Qty: {quantity}, Price: {price:C}");
Console.WriteLine($"Total stock units: {totalStock}, Highest price: {maxPrice:C}");

아래 표는 사용 가능한 유형화된 접근자를 요약합니다:

셀 데이터 읽기 및 쓰기에 대한 자세한 내용은 셀 형식 가이드 및 데이터 가져오기 사용법을 참조하세요.

using IronXL;

WorkBook workbook = WorkBook.Load("data.xlsx");
WorkSheet ws = workbook.DefaultWorkSheet;

// Check if a cell is empty before reading
if (!ws["A1"].IsEmpty)
{
    Console.WriteLine(ws["A1"].StringValue);
}

// Provide a fallback value using a null-coalescing pattern
끈 cellText = ws["A1"].StringValue ?? "Default Value";

// Iterate a range and skip empty cells
foreach (var cell in ws["A1:A20"])
{
    if (!cell.IsEmpty)
    {
        Console.WriteLine(cell.Text);
    }
}

using IronXL;

WorkBook workbook = WorkBook.Load("data.xlsx");
WorkSheet ws = workbook.DefaultWorkSheet;

// Check if a cell is empty before reading
if (!ws["A1"].IsEmpty)
{
    Console.WriteLine(ws["A1"].StringValue);
}

// Provide a fallback value using a null-coalescing pattern
끈 cellText = ws["A1"].StringValue ?? "Default Value";

// Iterate a range and skip empty cells
foreach (var cell in ws["A1:A20"])
{
    if (!cell.IsEmpty)
    {
        Console.WriteLine(cell.Text);
    }
}

프로덕션 준비된 Excel 리더를 빌드하는 방법은?

실제 환경의 Excel 리더는 파일 유효성 검사, 오류 처리, 멀티 시트 지원 및 선택적 출력 생성을 필요로 합니다. 다음 예는 이 모든 패턴을 하나의 클래스에 시연합니다:

using IronXL;
using System.IO;

// Validate and load the file
static List<끈> CheckLowStock(끈 filePath)
{
    var lowStockItems = new List<끈>();

    if (!File.Exists(filePath))
    {
        Console.WriteLine($"File not found: {filePath}");
        return lowStockItems;
    }

    끈 ext = Path.GetExtension(filePath).ToLower();
    if (ext is not (".xlsx" or ".xls" or ".csv"))
    {
        Console.WriteLine($"Unsupported file type: {ext}");
        return lowStockItems;
    }

    try
    {
        WorkBook workbook = WorkBook.Load(filePath);

        foreach (WorkSheet sheet in workbook.WorkSheets)
        {
            Console.WriteLine($"Checking sheet: {sheet.Name}");

            for (인트 row = 2; row <= sheet.RowCount; row++)
            {
                끈 itemName  = sheet[$"A{row}"].StringValue;
                인트 stockLevel   = sheet[$"B{row}"].IntValue;

                if (stockLevel < 10 && !끈.IsNullOrEmpty(itemName))
                {
                    lowStockItems.Add($"{itemName} -- {stockLevel} units ({sheet.Name})");
                }
            }
        }
    }
    catch (Exception ex)
    {
        Console.WriteLine($"Error reading Excel file: {ex.Message}");
    }

    return lowStockItems;
}

// Export results to a new workbook
static void ExportReport(List<끈> items, 끈 outputPath)
{
    WorkBook report     = WorkBook.Create();
    WorkSheet sheet     = report.CreateWorkSheet("Low Stock Report");

    sheet["A1"].Value   = "Item Description";
    sheet["B1"].Value   = "Source Sheet";

    sheet["A1:B1"].Style.Font.Bold        = true;
    sheet["A1:B1"].Style.BackgroundColor  = "#4472C4";
    sheet["A1:B1"].Style.Font.Color       = "#FFFFFF";

    인트 rowIndex = 2;
    foreach (끈 item in items)
    {
        sheet[$"A{rowIndex}"].Value = item;
        rowIndex++;
    }

    report.SaveAs(outputPath);
    Console.WriteLine($"Report saved to: {outputPath}");
}

// Run
var lowStockItems = CheckLowStock("inventory.xlsx");
ExportReport(lowStockItems, "low-stock-report.xlsx");

using IronXL;
using System.IO;

// Validate and load the file
static List<끈> CheckLowStock(끈 filePath)
{
    var lowStockItems = new List<끈>();

    if (!File.Exists(filePath))
    {
        Console.WriteLine($"File not found: {filePath}");
        return lowStockItems;
    }

    끈 ext = Path.GetExtension(filePath).ToLower();
    if (ext is not (".xlsx" or ".xls" or ".csv"))
    {
        Console.WriteLine($"Unsupported file type: {ext}");
        return lowStockItems;
    }

    try
    {
        WorkBook workbook = WorkBook.Load(filePath);

        foreach (WorkSheet sheet in workbook.WorkSheets)
        {
            Console.WriteLine($"Checking sheet: {sheet.Name}");

            for (인트 row = 2; row <= sheet.RowCount; row++)
            {
                끈 itemName  = sheet[$"A{row}"].StringValue;
                인트 stockLevel   = sheet[$"B{row}"].IntValue;

                if (stockLevel < 10 && !끈.IsNullOrEmpty(itemName))
                {
                    lowStockItems.Add($"{itemName} -- {stockLevel} units ({sheet.Name})");
                }
            }
        }
    }
    catch (Exception ex)
    {
        Console.WriteLine($"Error reading Excel file: {ex.Message}");
    }

    return lowStockItems;
}

// Export results to a new workbook
static void ExportReport(List<끈> items, 끈 outputPath)
{
    WorkBook report     = WorkBook.Create();
    WorkSheet sheet     = report.CreateWorkSheet("Low Stock Report");

    sheet["A1"].Value   = "Item Description";
    sheet["B1"].Value   = "Source Sheet";

    sheet["A1:B1"].Style.Font.Bold        = true;
    sheet["A1:B1"].Style.BackgroundColor  = "#4472C4";
    sheet["A1:B1"].Style.Font.Color       = "#FFFFFF";

    인트 rowIndex = 2;
    foreach (끈 item in items)
    {
        sheet[$"A{rowIndex}"].Value = item;
        rowIndex++;
    }

    report.SaveAs(outputPath);
    Console.WriteLine($"Report saved to: {outputPath}");
}

// Run
var lowStockItems = CheckLowStock("inventory.xlsx");
ExportReport(lowStockItems, "low-stock-report.xlsx");

이 예는 최상위 문장을 사용하며 전체 워크플로우를 다룹니다: 파일 경로 및 확장자를 유효성 검사하고, 워크북을 로드하며, 모든 워크시트를 반복하고, 비즈니스 로직을 적용하고, 결과를 새 파일에 씁니다. 워크북 작성 및 저장에 대한 자세한 내용은 Excel 파일 쓰기 가이드 및 Excel 내보내기 사용법을 참조하세요.

ExportReport 메서드가 원본 파일을 수정하는 대신 WorkBook.Create()로 새 워크북을 생성한다는 것을 주목하십시오. 원본 파일과 출력 파일을 분리하는 것은 감사 추적을 위한 좋은 관행이며, 다른 프로세스가 의존하는 데이터를 실수로 덮어쓰는 것을 피할 수 있습니다. 대신 기존 워크북에 데이터를 추가해야 하는 경우 WorkBook.Load()로 로드하고 해당 워크시트에 행을 추가한 후 새 경로에 SaveAs()를 호출하거나 자리에 덮어쓰십시오.

using IronXL;

WorkBook workbook = WorkBook.Load("large-dataset.xlsx");
WorkSheet ws      = workbook.DefaultWorkSheet;

// Fast: aggregate functions operate on the range directly
데시멀 total   = ws["B2:B5000"].Sum();
데시멀 average = ws["B2:B5000"].Avg();
인트 count       = ws["B2:B5000"].Count();

Console.WriteLine($"Total: {total:C}, Average: {average:C}, Rows: {count}");

// Export the worksheet to a DataSet for LINQ or database operations
var dataSet = workbook.ToDataSet();
Console.WriteLine($"DataSet tables: {dataSet.Tables.Count}");

using IronXL;

WorkBook workbook = WorkBook.Load("large-dataset.xlsx");
WorkSheet ws      = workbook.DefaultWorkSheet;

// Fast: aggregate functions operate on the range directly
데시멀 total   = ws["B2:B5000"].Sum();
데시멀 average = ws["B2:B5000"].Avg();
인트 count       = ws["B2:B5000"].Count();

Console.WriteLine($"Total: {total:C}, Average: {average:C}, Rows: {count}");

// Export the worksheet to a DataSet for LINQ or database operations
var dataSet = workbook.ToDataSet();
Console.WriteLine($"DataSet tables: {dataSet.Tables.Count}");

라이센스를 취득하고 운영 환경에 배포하는 방법은 무엇인가요?

IronXL은 개발 및 테스트 동안 전체 기능을 사용할 수 있는 무료 체험판을 제공하는 상용 라이브러리입니다. 운영 환경에 배포하려면 유효한 라이센스 키가 필요합니다. 개발자, 팀, 그리고 Enterprise 옵션을 포함하여 라이센스 계층에 대한 자세한 사항은 IronXL 라이센스 페이지에 있습니다.

라이센스 키를 적용하려면 모든 IronXL 호출 이전에 설정하세요:

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

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

IronXL 기능 개요는 파일을 읽고 쓰기부터 차트 생성, 조건부 서식 적용, 명명된 범위 작업까지의 모든 기능을 요약합니다. Excel 파일 생성 가이드와 셀 병합 방법은 새로운 워크북 작성에 유용한 시작점입니다.

C# Excel 자동화에 관한 커뮤니티 토론 및 질문은 Microsoft Q&A 포럼과 Stack Overflow 가 좋은 리소스입니다. 공식 NuGet 패키지 페이지는 버전 기록과 다운로드 통계를 제공합니다.

C#에서 Excel 파일을 여는 데 있어 중요한 핵심 사항은 무엇인가요?

IronXL은 Microsoft Office 의존성을 완전히 제거하여 서버, 컨테이너, 클라우드 함수에서 Excel 파일을 처리할 수 있게 합니다. API는 간단한 패턴을 따릅니다: 워크북을 로드하고, 이름이나 인덱스로 워크시트를 액세스하며 유형화된 접근자를 사용하여 셀을 읽습니다. Sum(), Avg() 및 Max()와 같은 집계 함수는 수동 반복의 오버헤드 없이 대규모 데이터 세트를 처리합니다.

이 라이브러리는 XLSX, XLS, CSV, TSV 형식을 지원하며 .NET 10 및 모든 최신 .NET 버전에서 실행되며, 크로스 플랫폼에서 작동합니다. IronXL은 표준 .NET 예외를 던지기 때문에 오류 처리가 간단합니다. 친숙한 try/catch 패턴으로 캐치할 수 있습니다. 디코딩해야 하는 COM 인트erop 오류 코드가 없습니다. 모든 사용 가능한 옵션을 탐색하려면 IronXL 문서 홈을 시작점으로 하세요 또는 워크북 여는 방법을 참조하면 단계별 참조가 됩니다.

무료 IronXL 체험판 시작하여 귀하의 프로젝트에서 라이브러리를 평가하십시오.

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

무료로 시작하세요