IRONSOFTWAREHOME
IRONXL 사용하여

C#에서 Excel 파일을 여는 방법

Curtis Chau
Curtis Chau
Updated: 2026년 6월 28일

IronXL은 C# 개발자가 Microsoft Office 설치 없이 Excel 파일을 열고, 읽고, 조작할 수 있게 합니다. 워크북을 WorkBook.Load()를 사용하여 간단히 로드하고, 워크시트에 접근하며, sheet["A1"] 같은 직관적인 문법으로 셀 값을 읽습니다.

이 튜토리얼은 C# 프로젝트에서 Excel 파일을 열고 읽는 IronXL의 사용 방법을 탐색하여, Excel 데이터 작업을 위한 포괄적인 예제와 모범 실무를 초급 개발자에게 제공합니다.

IronXL Excel 라이브러리란 무엇인가요?

IronXL은 사용의 용이성, 정확성, 속도를 우선시하는 .NET 라이브러리입니다. MS Office Interop을 필요로 하지 않고 Excel 파일을 효율적으로 열고, 읽고, 생성하고, 편집하는 데 도움을 줍니다. 이는 Interop 없이 Excel을 C#에서 작업하려는 개발자에게 실용적인 선택이 됩니다.

IronXL은 모든 .NET Framework와 Linux, macOS, Docker, Azure, AWS와 호환됩니다. Blazor.NET MAUI와 같은 현대 웹 앱용 콘솔, 웹, 데스크탑 애플리케이션을 만드는 데 사용할 수 있습니다. XLS 및 XLSX 파일, XSLT 및 XLSM, CSV, TSV와 같은 다른 워크북 형식을 지원합니다.

IronXL의 주요 기능은 무엇인가요?

Excel 파일을 C#에서 여는 방법은?

시작하기 전에 무엇이 필요하나요?

C# 애플리케이션에서 IronXL을 사용하려면, 로컬 컴퓨터에 다음 구성 요소를 설치하세요:

  1. Visual Studio - C# .NET 애플리케이션을 개발하기 위한 공식 IDE. Microsoft 웹사이트에서 Visual Studio를 다운로드하여 설치할 수 있습니다. JetBrains ReSharper & Rider도 사용할 수 있습니다. 시작 개요를 참조하여 추가 설정 지침을 확인하세요.
  2. IronXL - C#에서 Excel 시트 작업을 돕는 Excel 라이브러리. 사용하기 전에 C# 애플리케이션에 설치되어야 합니다. NuGet 웹사이트나 Visual Studio의 NuGet 패키지 관리를 통해 다운로드할 수 있습니다. .NET Excel DLL 파일을 직접 다운로드할 수도 있습니다. 라이센스 구현에 대해서는 라이센스 키 사용을 참조하세요.

어떤 네임스페이스를 가져와야 하나요?

Visual Studio와 IronXL 설치가 완료되면, 다음 줄을 C# 파일의 맨 위에 추가하여 필요한 IronXL 네임스페이스를 추가하세요:

// Add reference to the IronXL library
using IronXL;

특정 Excel 형식이나 고급 기능을 작업할 때는 다음도 필요할 수 있습니다:

using IronXL.Formatting;  // For cell styling
using IronXL.Drawing;     // For images and charts
using System.Data;        // For DataSet/DataTable operations

기존 Excel 파일을 로드하는 방법은?

Excel 파일은 워크북이라고도 하며, 각 워크시트에는 셀 값이 포함된 여러 워크시트로 구성됩니다. Excel 파일을 열고 읽으려면, WorkBook 클래스의 Load 메서드를 사용하여 로드합니다. 워크북 로드 기능은 다양한 형식을 지원합니다.

// Supported Excel spreadsheet formats for reading include: XLSX, XLS, CSV, and TSV
WorkBook workbook = WorkBook.Load("test.xlsx");

// You can also load from streams for web applications
// using (var stream = File.OpenRead("test.xlsx"))
// {
//     WorkBook workbook = WorkBook.Load(stream);
// }

이는 워크북을 WorkBook 인스턴스로 초기화합니다. 특정 WorkSheet을 열려면 WorkSheets 컬렉션에서 검색합니다. 워크시트 관리 가이드는 워크시트 작업에 대한 자세한 정보를 제공합니다:

// Access the first worksheet in the workbook
WorkSheet sheet = workbook.WorkSheets.First();

// Alternative ways to access worksheets
WorkSheet sheetByIndex = workbook.WorkSheets[0];  // By index
WorkSheet sheetByName = workbook.GetWorkSheet("Sheet1");  // By name

이는 Excel 파일의 첫 번째 시트를 읽고 쓰기 준비가 되어 있는 상태로 액세스합니다.

엑셀 스프레드시트가 이름, 직위, 급여 열이 있는 5명의 직원 데이터를 표시하며 서식이 지정된 헤더와 셀 테두리가 있습니다 Excel 파일

Excel 셀에서 데이터를 어떻게 읽나요?

Excel 파일이 열리면, 데이터 읽기에 준비가 됩니다. C#에서 IronXL을 사용하여 Excel 파일에서 데이터를 읽는 것은 간단합니다. 셀 범위를 지정하여 셀 값을 읽을 수 있으며, 범위 선택 기능을 사용합니다.

다음 코드는 셀의 값을 가져옵니다:

// Select the cell using Excel notation and retrieve its integer value
int cellValue = sheet["C2"].IntValue;

// You can also retrieve values in different formats
string textValue = sheet["C2"].StringValue;
decimal decimalValue = sheet["C2"].DecimalValue;
DateTime dateValue = sheet["C2"].DateTimeValue;
bool boolValue = sheet["C2"].BoolValue;

// Display the value in the console
Console.WriteLine($"Cell C2 contains: {cellValue}");

// Check if cell is empty before reading
if (!sheet["C2"].IsEmpty)
{
    Console.WriteLine($"Cell value: {sheet["C2"].Value}");
}

출력 결과는 다음과 같습니다.

Microsoft Visual Studio 디버그 콘솔 창이 Excel 셀 C2에서 '100000' 값을 성공적으로 추출한 것을 보여주는 상황에 맞는 출력 메시지를 표시합니다 Excel 읽기

셀의 범위에서 데이터를 읽으려면, 지정된 범위를 반복하여 탐색하는 루프를 사용합니다. Excel 범위 선택 예시에서 더 많은 패턴을 제공합니다:

// Iterate through a range of cells and display their address and text content
foreach (var cell in sheet["A2:A6"])
{
    Console.WriteLine("Cell {0} has value '{1}'", cell.AddressString, cell.Text);
}

// Read an entire column
foreach (var cell in sheet.GetColumn(0))  // Column A
{
    if (!cell.IsEmpty)
    {
        Console.WriteLine($"Column A value: {cell.Text}");
    }
}

// Read an entire row
foreach (var cell in sheet.GetRow(1))  // Row 2
{
    Console.WriteLine($"Row 2 value: {cell.Text}");
}

셀 범위 A2:A6의 각 값이 접근되어 콘솔에 출력됩니다.

Microsoft Visual Studio 디버그 콘솔에서 Excel 범위 A2:A6을 읽고 직원 이름인 John, Sara, Peter, Method, Katherine을 표시하는 구문 강조가 있는 출력을 보여줍니다 셀 범위 읽기

더 자세한 읽기 및 쓰기 예시를 위해 C#에서 Excel 읽기 튜토리얼을 확인하세요. Excel 데이터를 DataTables로 변환하여 더 쉽게 조작할 수 있습니다:

// Convert worksheet to DataTable for easier data manipulation
DataTable dataTable = sheet.ToDataTable(true);  // true = first row contains headers

// Access data using DataTable methods
foreach (DataRow row in dataTable.Rows)
{
    Console.WriteLine($"Employee: {row["Name"]}, Salary: {row["Salary"]}");
}

새 Excel 파일을 어떻게 생성하나요?

IronXL은 또한 데이터 저장 및 검색을 위한 새 워크북 생성을 지원합니다. 스프레드시트 생성 가이드에서는 포괄적인 예시를 제공합니다.

한 줄의 코드로 새 Excel 파일을 생성할 수 있습니다:

// Create a new workbook with the XLSX format
WorkBook workBook = new WorkBook(ExcelFileFormat.XLSX);

// Alternative: Create with XLS format for compatibility
WorkBook xlsWorkBook = new WorkBook(ExcelFileFormat.XLS);

// Set workbook metadata
workBook.Metadata.Title = "Employee Data";
workBook.Metadata.Author = "Your Name";
workBook.Metadata.Keywords = "employees, salary, data";

다음으로, 워크시트를 생성하고 데이터를 추가하세요. 더 고급 생성 패턴은 새 Excel 파일 생성을 참조하세요.

워크북에 워크시트를 어떻게 추가하나요?

// Create a worksheet named "GDPByCountry" in the workbook
WorkSheet workSheet = workBook.CreateWorkSheet("GDPByCountry");

// Create multiple worksheets at once
WorkSheet sheet2 = workBook.CreateWorkSheet("PopulationData");
WorkSheet sheet3 = workBook.CreateWorkSheet("Summary");

// Copy an existing worksheet
WorkSheet copiedSheet = workSheet.CopySheet("GDPByCountryCopy");

이 코드는 워크북에 "GDPByCountry"라는 이름의 워크시트를 추가하여 셀 값을 추가할 수 있게 합니다. 워크시트 관리워크시트 복사에 대해 더 알아보세요.

특정 셀에 값을 설정하려면 아래 코드를 사용하세요:

// Set the value of cell A1 to "Example"
workSheet["A1"].Value = "Example";

// Add different types of data
workSheet["A2"].Value = 12345;  // Integer
workSheet["A3"].Value = 99.99m;  // Decimal
workSheet["A4"].Value = DateTime.Now;  // Date
workSheet["A5"].Value = true;  // Boolean

// Add formulas
workSheet["B1"].Formula = "=SUM(A2:A3)";

// Set multiple cells at once using a range
workSheet["C1:C5"].Value = "Bulk Value";

// Save the workbook
workBook.SaveAs("output.xlsx");

최종 출력은 다음과 같습니다:

셀 A1에 'Example' 텍스트가 C#을 사용하여 프로그래밍적으로 추가된 Excel 스프레드시트를 보여주며, GDPByCountry 워크시트 탭이 보이고 추가된 값을 보여주기 위한 셀 강조 표시가 있습니다 셀에 값 추가

다양한 Excel 형식 작업

IronXL은 여러 Excel 형식을 지원합니다. 다른 파일 유형을 처리하는 방법은 다음과 같습니다:

// Convert between formats
WorkBook workbook = WorkBook.Load("data.csv");
workbook.SaveAs("data.xlsx");  // Convert CSV to XLSX

// Export to different formats
workbook.SaveAsCsv("output.csv", ";");  // CSV with semicolon delimiter
workbook.SaveAsJson("output.json");     // Export as JSON
workbook.SaveAsXml("output.xml");       // Export as XML

스프레드시트 파일 형식 변환XLSX를 CSV, JSON, XML로 변환에 대해 알아보세요.

오류 처리 및 모범 사례

Excel 파일 작업 시, 적절한 오류 처리를 구현하세요:

try
{
    WorkBook workbook = WorkBook.Load("test.xlsx");
    WorkSheet sheet = workbook.GetWorkSheet("Sheet1");
    
    // Check if sheet exists
    if (sheet == null)
    {
        Console.WriteLine("Worksheet not found!");
        return;
    }
    
    // Process data
    var value = sheet["A1"].Value;
}
catch (Exception ex)
{
    Console.WriteLine($"Error reading Excel file: {ex.Message}");
}

프로덕션 응용 프로그램에서는 로깅 설정 및 적절한 오류 처리 패턴 구현을 고려하세요.

무엇을 배웠나요?

이 기사는 C#에서 IronXL을 사용하여 XLS 및 XLSX와 같은 Excel 파일을 열고 읽는 방법을 설명합니다. IronXL은 Excel 관련 작업에 대해 Microsoft Excel을 시스템에 설치할 필요가 없어, Docker 배포Azure Functions에 적합합니다.

IronXL은 수식 계산, 문자열 정렬, 트리밍, 찾기 및 바꾸기, 병합 및 해제, 파일 저장 등을 포함하여 Excel 관련 작업을 프로그래밍 방식으로 처리하기 위한 종합적인 솔루션을 제공합니다. 셀 데이터 형식을 설정할 수 있으며, 조건부 서식으로 작업하고 차트 생성이 가능합니다.

고급 기능을 위해 행 및 열 그룹화 및 해제하기, 이름 있는 범위, 하이퍼링크, Excel 파일 보호를 탐색하세요. 전체 API 참조는 모든 기능에 대한 자세한 문서를 제공합니다.

IronXL은 무료 30일 체험판을 사용할 수 있으며, 상업적 용도를 위해 라이선스가 가능합니다. IronXL의 Lite 패키지는 $999부터 시작합니다. 추가 리소스는 튜토리얼 섹션을 방문하거나 일반적인 시나리오에 대한 코드 예제를 탐색하세요.

Curtis Chau
기술 문서 작성자

커티스 차우는 칼턴 대학교에서 컴퓨터 과학 학사 학위를 취득했으며, Node.js, TypeScript, JavaScript, React를 전문으로 하는 프론트엔드 개발자입니다. 직관적이고 미적으로 뛰어난 사용자 인터페이스를 만드는 데 열정을 가진 그는 최신 프레임워크를 활용하고, 잘 구성되고 시각적으로 매력적인 매뉴얼을 제작하는 것을 즐깁니다.

...
더 읽어보기

관련 기사

Key in blue circle

무료 30일 체험 키를 즉시 받으세요.

Your trial license will be sent to your email address

제한 없음. 100% 무제한 이용. 신용카드 불필요.

bullet_checked신용카드나 계정 생성은 필요하지 않습니다.제한 없음. 100% 무제한 이용. 신용카드 불필요.
  • Logo Aetna
  • Logo NASA
  • Logo GE
  • Logo Porsche
  • Logo USDA
  • Logo Qatar
Join Millions of Engineers who’ve tried IronPDF
무료 라이브 데모를 예약하세요
Booking Badge

전 세계 수백만 엔지니어들이 신뢰하는 제품입니다.

Iron Software의 고객 로고
부담 없는 무료 상담을 받아보세요
아래 양식을 작성하시거나 sales@ironsoftware.com으로 이메일을 보내주세요.
고객님의 정보는 항상 비밀로 유지됩니다.
전 세계 수백만 엔지니어들이 신뢰하는 제품입니다.
Iron Software의 고객 로고
지금 바로 30일 무료 체험판 키를 받으세요.
신용카드나 계정 생성은 필요하지 않습니다.