업데이트됨 2026년 6월 28일
Microsoft Office Interop Excel C#을 사용하여 Excel 파일 읽기: Office 없이 Excel 파일을 만드는 더 빠른 방법
C#에서 Microsoft Office Interop Excel을 사용하여 Excel 파일을 읽은 다음, IronXL로 전환하여 Office 종속성 없이 서버에 안전한 크로스 플랫폼 Excel 파일을 생성하세요.
더 읽어보기
IRONXL 사용하여
IronXL 사용하여 C#에서 Excel 파일을 읽는 방법
Curtis Chau
Updated: 2026년 6월 28일
C# 응용 프로그램에서 Excel 파일을 읽는 것은 비즈니스 소프트웨어, 데이터 처리 파이프라인 및 보고 시스템에 반복적인 요구 사항입니다. Microsoft Office Interop을 사용한 전통적인 접근 방식은 모든 서버나 워크스테이션에 Excel이 설치되어야 하며, 이는 배포 및 라이센스를 복잡하게 만드는 취약한 종속성을 생성합니다. IronXL은 환경 어디에도 Office가 설치되지 않은 상태에서 XLSX, XLS, CSV 및 다른 스프레드시트 형식을 읽을 수 있도록 완전히 그 종속성을 제거합니다.
이 자습서에서는 라이브러리 설치, 워크북 로드, 유형화된 셀 값 추출, 행과 열 순회, 집계 계산 실행, 완전한 직원 데이터 리더 구축을 안내합니다. 모든 예제는 .NET 10을 목표로 하는 최상위 문장이 포함된 C#을 사용합니다.
Excel 처리를 위해 IronXL을 어떻게 설치하나요?
Visual Studio에서 NuGet 패키지 관리자 콘솔을 열고 다음 명령을 실행하여 프로젝트에 IronXL을 추가하세요. 대안으로, 터미널에서 작업하는 것을 선호한다면 두 번째 줄에 표시된 .NET CLI 명령을 사용하세요:
패키지는 몇 초 만에 설치되며 프로젝트에 하나의 관리된 어셈블리 참조만 추가합니다. COM 등록, Office 기본 상호 운용 어셈블리, 버전 특정 Excel 종속성을 관리할 필요가 없습니다.
설치 후에는 스프레드시트 데이터를 처리하는 각 파일의 맨 위에 using 지시문을 추가하세요:
using IronXL;Imports IronXL하나의 네임스페이스를 사용하면 WorkBook, WorkSheet, 셀 범위, 유형 값 속성, 집계 함수, 그리고 모든 다른 IronXL 유형에 접근할 수 있습니다. IronXL.Excel의 NuGet 갤러리 페이지에는 모든 사용 가능한 릴리스와 전체 의존성 트리가 목록화되어 있습니다.
IronXL이 지원하는 Excel 파일 형식은 무엇인가요?
응용 프로그램이 처리해야 하는 형식을 이해하는 것은 당신이 호출해야 할 API와 프로젝트가 채택하는 저장소 결정을 형성합니다.
XLSX -- Excel 2007 이후 기본 형식은 XML 파일의 ZIP 아카이브입니다. 이는 백만 개 이상의 행, 풍부한 서식, 피벗 테이블 및 명명된 범위를 지원합니다. 대부분의 현대 데이터 파이프라인은 XLSX 출력을 생성하므로 이는 가장 자주 접하는 형식입니다.
XLS는 Excel 2003 및 이전에 사용되던 레거시 이진 형식입니다. 일부 Enterprise 시스템은 여전히 XLS를 내보내므로, 오래된 인프라와의 통합 시 이 형식에 대한 신뢰할 수 있는 지원이 중요합니다. IronXL은 사용자가 특별한 구성을 하지 않아도 XLS 파일을 읽습니다.
XLSM은 매크로 지원을 통해 XLSX를 확장합니다. IronXL은 내장된 VBA 코드를 실행하지 않아도 XLSM 파일에서 스프레드시트 데이터를 읽으며, 이는 서버 측 데이터 추출에 적합한 동작입니다.
CSV 및 TSV는 시스템 간 데이터 교환에 널리 사용되는 평문 테이블 형식입니다. WorkBook.LoadCSV는 쉼표로 구분된 파일을 처리하며, IronXL은 이미 기능에 익숙한 WorkBook 객체를 반환하여 소스 형식에 관계없이 데이터 읽기 논리를 균일하게 유지합니다.
IronXL은 파일 확장자를 통해 파일 형식을 자동으로 감지하며 WorkBook.Load를 호출할 때 이를 감지합니다. 대부분의 경우 명시적으로 형식을 지정할 필요가 없으며, 이는 여러 소스에서 오는 입력을 처리해야 하는 코드를 단순화합니다.
| 형식 | 확장자 | 로드 메소드 | 노트 |
|---|---|---|---|
| Open XML 워크북 | .xlsx | WorkBook.Load | 기본 현대 형식 |
| 이전 바이너리 | .xls | WorkBook.Load | 엑셀 2003 및 이전 버전 |
| 매크로 활성화 | .xlsm | WorkBook.Load | 데이터 읽기; 매크로 실행 안 함 |
| 쉼표로 구분 | .csv | WorkBook.LoadCSV | 최적화된 CSV 파서 |
| 탭으로 구분 | .tsv | WorkBook.Load | 탭 구분자 변형 |
엑셀 워크북을 어떻게 로드하고 읽습니까?
WorkBook.Load 메서드는 모든 파일 기반 작업의 진입점입니다. 파일 경로를 전달하면 IronXL은 즉시 쿼리할 수 있는 완전한 작업 책 객체를 반환합니다:
using IronXL;
// Load the workbook; format is detected automatically
WorkBook workbook = WorkBook.Load("Employees.xlsx");
// Access the first worksheet
WorkSheet sheet = workbook.DefaultWorkSheet;
// Read a single cell by A1 address
string companyName = sheet["A1"].StringValue;
Console.WriteLine($"Company: {companyName}");
// Access sheets by name or by zero-based index
WorkSheet byName = workbook.GetWorkSheet("Sales");
WorkSheet byIndex = workbook.WorkSheets[1];
// Load a password-protected file
WorkBook secured = WorkBook.Load("Confidential.xlsx", "p@ssw0rd");Imports IronXL
' Load the workbook; format is detected automatically
Dim workbook As WorkBook = WorkBook.Load("Employees.xlsx")
' Access the first worksheet
Dim sheet As WorkSheet = workbook.DefaultWorkSheet
' Read a single cell by A1 address
Dim companyName As String = sheet("A1").StringValue
Console.WriteLine($"Company: {companyName}")
' Access sheets by name or by zero-based index
Dim byName As WorkSheet = workbook.GetWorkSheet("Sales")
Dim byIndex As WorkSheet = workbook.WorkSheets(1)
' Load a password-protected file
Dim secured As WorkBook = WorkBook.Load("Confidential.xlsx", "p@ssw0rd")DefaultWorkSheet 속성은 첫 번째 시트를 반환하며, 대부분의 단일 시트 파일을 다룹니다. 파일에 여러 시트가 포함된 경우 GetWorkSheet는 이름으로 가져오고 WorkSheets[n]는 0부터 시작하는 인덱스로 가져옵니다. 작업 책 API 참조는 작업 책 객체의 모든 오버로드와 속성을 문서화합니다.
입력
산출
엑셀에서 입력된 셀 값을 어떻게 읽나요?
IronXL의 모든 셀은 필요로 하는 정확한 데이터 유형으로 값을 반환하는 유형화된 속성을 노출합니다 -- 수동 파싱이나 캐스팅이 필요 없습니다. 유형화된 속성은 기본 셀 표현에서 자동으로 변환을 처리합니다:
using IronXL;
WorkBook workbook = WorkBook.Load("Employees.xlsx");
WorkSheet sheet = workbook.DefaultWorkSheet;
// Extract typed values from row 2
int employeeId = sheet["A2"].IntValue;
string name = sheet["B2"].StringValue;
string department = sheet["C2"].StringValue;
decimal salary = sheet["D2"].DecimalValue;
DateTime hireDate = sheet["E2"].DateTimeValue;
Console.WriteLine($"ID: {employeeId}");
Console.WriteLine($"Name: {name}");
Console.WriteLine($"Department: {department}");
Console.WriteLine($"Salary: {salary:C}");
Console.WriteLine($"Hired: {hireDate:d}");
// Use the Text property for the formatted display value
string formattedSalary = sheet["D2"].Text; // "$75,000.00"
string formattedDate = sheet["E2"].Text; // "28/02/2026"
// Guard against empty cells before reading
if (!sheet["B3"].IsEmpty)
{
string value = sheet["B3"].StringValue;
}Imports IronXL
Dim workbook As WorkBook = WorkBook.Load("Employees.xlsx")
Dim sheet As WorkSheet = workbook.DefaultWorkSheet
' Extract typed values from row 2
Dim employeeId As Integer = sheet("A2").IntValue
Dim name As String = sheet("B2").StringValue
Dim department As String = sheet("C2").StringValue
Dim salary As Decimal = sheet("D2").DecimalValue
Dim hireDate As DateTime = sheet("E2").DateTimeValue
Console.WriteLine($"ID: {employeeId}")
Console.WriteLine($"Name: {name}")
Console.WriteLine($"Department: {department}")
Console.WriteLine($"Salary: {salary:C}")
Console.WriteLine($"Hired: {hireDate:d}")
' Use the Text property for the formatted display value
Dim formattedSalary As String = sheet("D2").Text ' "$75,000.00"
Dim formattedDate As String = sheet("E2").Text ' "28/02/2026"
' Guard against empty cells before reading
If Not sheet("B3").IsEmpty Then
Dim value As String = sheet("B3").StringValue
End IfText 속성은 Excel에 포맷된 대로 그대로 표시된 값을 반환합니다 -- 포맷된 숫자 문자열이 필요한 경우 유용합니다. 엑셀 수식을 포함하는 셀의 경우, IronXL은 표현식을 평가하고 동일한 유형화된 속성을 통해 계산된 결과를 반환합니다. 추가 값 속성 -- BoolValue, DoubleValue, FloatValue -- 셀 값 레퍼런스에 나타납니다.
엑셀 행과 열을 어떻게 반복합니까?
데이터 세트의 모든 레코드를 처리하려면 행과 열을 반복해야 합니다. IronXL의 범위 구문은 Excel의 A1 표기법에 직접 매핑되어 있으므로 셀 블록을 선택하는 것은 스프레드시트 수식을 작성한 사람에게 익숙합니다:
using IronXL;
WorkBook workbook = WorkBook.Load("Employees.xlsx");
WorkSheet sheet = workbook.DefaultWorkSheet;
// Iterate a single column range
Console.WriteLine("Employee List:");
foreach (var cell in sheet["B2:B100"])
{
if (!string.IsNullOrEmpty(cell.Text))
Console.WriteLine($" - {cell.Text}");
}
// Iterate all rows and all columns using the Rows property
foreach (var row in sheet.Rows)
{
foreach (var cell in row)
Console.Write(cell.Text.PadRight(15));
Console.WriteLine();
}Imports IronXL
Dim workbook As WorkBook = WorkBook.Load("Employees.xlsx")
Dim sheet As WorkSheet = workbook.DefaultWorkSheet
' Iterate a single column range
Console.WriteLine("Employee List:")
For Each cell In sheet("B2:B100")
If Not String.IsNullOrEmpty(cell.Text) Then
Console.WriteLine($" - {cell.Text}")
End If
Next
' Iterate all rows and all columns using the Rows property
For Each row In sheet.Rows
For Each cell In row
Console.Write(cell.Text.PadRight(15))
Next
Console.WriteLine()
Next범위 sheet["B2:B100"]는 셀 객체의 나열 가능한 컬렉션을 반환합니다. string.IsNullOrEmpty을 확인하면 빈 행을 우아하게 건너뜁니다. Rows 속성은 시트 데이터 범위 가이드에 설명되어 있으며, 시트를 한 행씩 걸으며 열 수를 미리 알 필요 없이 각 행의 셀에 접근할 수 있습니다.
산출
엑셀 데이터에 대해 집계 계산을 어떻게 수행합니까?
IronXL은 셀 범위에서 직접 결과를 계산하는 기본 집계 함수를 포함하고 있습니다 -- 수동 누적 루프가 필요 없습니다:
using IronXL;
WorkBook workbook = WorkBook.Load("Employees.xlsx");
WorkSheet sheet = workbook.DefaultWorkSheet;
// Built-in aggregate methods work on any named range
decimal total = sheet["D2:D200"].Sum();
decimal highest = sheet["D2:D200"].Max();
decimal lowest = sheet["D2:D200"].Min();
decimal average = sheet["D2:D200"].Avg();
Console.WriteLine($"Total Payroll: {total:C}");
Console.WriteLine($"Highest Salary: {highest:C}");
Console.WriteLine($"Lowest Salary: {lowest:C}");
Console.WriteLine($"Average Salary: {average:C}");
// Combine with LINQ for filtered aggregation
decimal itTotal = sheet["D2:D200"]
.Where(c => sheet[$"C{c.RowIndex}"].StringValue == "IT")
.Sum(c => c.DecimalValue);
Console.WriteLine($"IT Department Total: {itTotal:C}");Imports IronXL
Dim workbook As WorkBook = WorkBook.Load("Employees.xlsx")
Dim sheet As WorkSheet = workbook.DefaultWorkSheet
' Built-in aggregate methods work on any named range
Dim total As Decimal = sheet("D2:D200").Sum()
Dim highest As Decimal = sheet("D2:D200").Max()
Dim lowest As Decimal = sheet("D2:D200").Min()
Dim average As Decimal = sheet("D2:D200").Avg()
Console.WriteLine($"Total Payroll: {total:C}")
Console.WriteLine($"Highest Salary: {highest:C}")
Console.WriteLine($"Lowest Salary: {lowest:C}")
Console.WriteLine($"Average Salary: {average:C}")
' Combine with LINQ for filtered aggregation
Dim itTotal As Decimal = sheet("D2:D200") _
.Where(Function(c) sheet($"C{c.RowIndex}").StringValue = "IT") _
.Sum(Function(c) c.DecimalValue)
Console.WriteLine($"IT Department Total: {itTotal:C}")Sum, Min, Max, Avg는 자동으로 빈 셀을 건너뛰고 백그라운드에서 숫자 변환을 처리합니다. 범위에 LINQ 쿼리를 체인하면 필터링된 집계 -- 부서 소계, 날짜 범위 합계, 조건부 계산 -- 를 IronXL API 내에서 수행할 수 있습니다.
완전한 직원 데이터 읽기기를 어떻게 구축합니까?
다음 예제는 직원 스프레드시트를 로드하고 각 레코드를 형식화하고 급여 총계를 누적하고 쓰기를 처리하고 오류를 유연하게 처리하는 프로덕션 준비가 된 콘솔 애플리케이션에 지금까지 다룬 모든 것을 조립합니다:
using IronXL;
try
{
WorkBook workbook = WorkBook.Load("Employees.xlsx");
WorkSheet sheet = workbook.DefaultWorkSheet;
Console.WriteLine("=== Employee Data Report ===\n");
int rowNumber = 2;
decimal totalSalary = 0m;
int employeeCount = 0;
while (!string.IsNullOrEmpty(sheet[$"A{rowNumber}"].StringValue))
{
int id = sheet[$"A{rowNumber}"].IntValue;
string name = sheet[$"B{rowNumber}"].StringValue;
string department = sheet[$"C{rowNumber}"].StringValue;
decimal salary = sheet[$"D{rowNumber}"].DecimalValue;
Console.WriteLine($"{id,4} {name,-20} {department,-15} {salary,10:C}");
totalSalary += salary;
employeeCount += 1;
rowNumber += 1;
}
Console.WriteLine($"\nTotal Employees: {employeeCount}");
Console.WriteLine($"Total Payroll: {totalSalary:C}");
// Write a new record back to the sheet and save
sheet["A10"].Value = 1010;
sheet["B10"].Value = "Jane Doe";
sheet["C10"].Value = "Finance";
sheet["D10"].Value = 75000;
workbook.SaveAs("Employees-Updated.xlsx");
}
catch (Exception ex)
{
Console.WriteLine($"Error reading Excel file: {ex.Message}");
}Imports IronXL
Try
Dim workbook As WorkBook = WorkBook.Load("Employees.xlsx")
Dim sheet As WorkSheet = workbook.DefaultWorkSheet
Console.WriteLine("=== Employee Data Report ===" & vbCrLf)
Dim rowNumber As Integer = 2
Dim totalSalary As Decimal = 0D
Dim employeeCount As Integer = 0
While Not String.IsNullOrEmpty(sheet($"A{rowNumber}").StringValue)
Dim id As Integer = sheet($"A{rowNumber}").IntValue
Dim name As String = sheet($"B{rowNumber}").StringValue
Dim department As String = sheet($"C{rowNumber}").StringValue
Dim salary As Decimal = sheet($"D{rowNumber}").DecimalValue
Console.WriteLine($"{id,4} {name,-20} {department,-15} {salary,10:C}")
totalSalary += salary
employeeCount += 1
rowNumber += 1
End While
Console.WriteLine(vbCrLf & $"Total Employees: {employeeCount}")
Console.WriteLine($"Total Payroll: {totalSalary:C}")
' Write a new record back to the sheet and save
sheet("A10").Value = 1010
sheet("B10").Value = "Jane Doe"
sheet("C10").Value = "Finance"
sheet("D10").Value = 75000
workbook.SaveAs("Employees-Updated.xlsx")
Catch ex As Exception
Console.WriteLine($"Error reading Excel file: {ex.Message}")
End Trywhile 루프는 열 A가 비어 있을 때 종료되며, 이를 통해 하드코딩된 행 수 없이도 다양한 길이의 스프레드시트에 적응할 수 있게 합니다. 값을 다시 쓰는 것은 읽기와 동일한 셀 주소 구문을 따르며, SaveAs는 변경 사항을 새 파일에 저장하여 원본을 변경하지 않고 그대로 남깁니다. try/catch 블록은 누락된 파일, 잠긴 워크북 및 손상된 데이터를 처리하며, 외부 소스에서 입력 파일이 도착하는 생산 환경에서 발생하는 모든 시나리오를 처리합니다.
산출
스프레드시트를 만드는 방법 가이드와 XLSX를 CSV로 변환하는 가이드는 끝-끝 워크플로우에서 읽기와 쓰기를 결합하는 방법을 보여줍니다. 셀 스타일링 가이드는 형식화된 출력이 요구될 때 글꼴 크기, 색상 및 테두리를 다룹니다.
고급 읽기 시나리오는 어떻게 처리합니까?
실제 프로젝트에서는 몇 가지 드문 경우가 발생합니다. 이름 있는 범위, 워크시트 검색, CSV 로드는 각 API 지원을 받습니다.
이름 있는 범위는 셀 주소가 아닌 논리적 레이블로 데이터를 참조할 수 있게 합니다. 워크북 작성자가 SalaryTable라는 이름 범위를 정의한 경우, GetRangeByName을 통해 직접 접근할 수 있습니다:
var range = workbook.GetRangeByName("SalaryTable");
decimal total = range.Sum();
Console.WriteLine($"Named range total: {total:C}");Dim range = workbook.GetRangeByName("SalaryTable")
Dim total As Decimal = range.Sum()
Console.WriteLine($"Named range total: {total:C}")워크시트 검색은 워크북의 모든 시트를 열거합니다, 이는 여러 탭이 있는 파일을 처리할 때 유용합니다:
foreach (WorkSheet ws in workbook.WorkSheets)
Console.WriteLine($"Sheet: {ws.Name}, Rows: {ws.RowCount}");For Each ws As WorkSheet In workbook.WorkSheets
Console.WriteLine($"Sheet: {ws.Name}, Rows: {ws.RowCount}")
NextCSV 로딩은 단순 텍스트 파일에 최적화된 전용 메서드를 사용하며, 동일한 범위 API를 사용하여 탐색할 수 있는 WorkSheet을 반환합니다:
WorkBook csv = WorkBook.LoadCSV("data.csv");
WorkSheet first = csv.DefaultWorkSheet;
Console.WriteLine(first["A1"].StringValue);Dim csv As WorkBook = WorkBook.LoadCSV("data.csv")
Dim first As WorkSheet = csv.DefaultWorkSheet
Console.WriteLine(first("A1").StringValue)이 패턴들은 데이터 마이그레이션 프로젝트, ETL 파이프라인, 자동화된 보고 시스템에서 발생하는 고급 읽기 시나리오를 다룹니다. 완전한 API 면적에 대해서는 IronXL 객체 참조를 참조하세요.
추가적인 권위 있는 참고 자료:
- IronXL 문서 홈
- Excel 수식 편집 방법
- 수학 함수 작업 방법
- 범위 선택 방법
- ECMA-376 Open XML 사양 -- XLSX 형식을 정의하는 권위 있는 표준
- Microsoft Open XML SDK 문서 -- 기본 파일 구조에 대한 참조 자료
- NuGet 갤러리 -- IronXL.Excel -- 버전 기록 및 다운로드 통계가 있는 패키지 페이지
다음 단계는 무엇입니까?
IronXL은 복잡한 Interop 과제를 몇 줄의 간단한 C# 코드로 해결하여 Excel 파일 읽기를 종속성에서 해방시킵니다. 워크북 로드, 유형화된 값 추출, 행별 반복, 집계 계산 실행, 극단적인 경우 처리 모두 동일한 일관된 API 패턴을 따릅니다. 배포 환경 어디에도 Microsoft Office가 설치되어 있지 않습니다.
튜토리얼에서 프로덕션으로 이동하려면:
- 무료 체험판 시작을 통해 전체 IronXL 기능 세트를 잠금 해제하고 라이센스를 구입하기 전에 자체 Excel 파일과 비교하여 유효성을 확인하세요.
- 스프레드시트 작성, 형식 지정, 스타일링 및 변환에 대한 가이드를 위해 완전한 IronXL 문서를 탐색하세요.
- 라이브러리에서 사용 가능한 모든 클래스, 메서드 및 속성을 발견하기 위해 객체 참조 및 전체 API를 탐색하세요.
- 워크플로우가 입력 파일 읽기뿐 아니라 결과 파일 생성도 요구할 때 스프레드시트 생성 방법 가이드를 검토하세요.
- 보고서 생성, 데이터 유효성 검사 및 멀티 시트 통합 같은 실제 시나리오를 다루는 추가 튜토리얼을 위해 IronXL 블로그 포스트 인덱스를 확인하세요.
기술 문서 작성자
커티스 차우는 칼턴 대학교에서 컴퓨터 과학 학사 학위를 취득했으며, Node.js, TypeScript, JavaScript, React를 전문으로 하는 프론트엔드 개발자입니다. 직관적이고 미적으로 뛰어난 사용자 인터페이스를 만드는 데 열정을 가진 그는 최신 프레임워크를 활용하고, 잘 구성되고 시각적으로 매력적인 매뉴얼을 제작하는 것을 즐깁니다.
...
더 읽어보기관련 기사
업데이트됨 2026년 7월 19일
.NET C#에서 Excel 파일 다운로드: XLSX, CSV 등 다양한 형식으로 데이터 내보내기
ASP.NET Core 에서 C# 및 IronXL 사용하여 Excel 파일을 다운로드하는 방법을 설명합니다. MVC 컨트롤러에서 MemoryStream 및 File() 반환 값을 사용하여 데이터를 XLSX, CSV 및 XML 형식으로 내보낼 수 있습니다. 코드 예제가 포함되어 있습니다.
더 읽어보기
업데이트됨 2026년 6월 28일
C#을 사용하여 Interop 없이 Excel에서 피벗 테이블을 만드는 방법
Office 종속성 없이 C#을 사용하여 Excel에서 피벗 테이블을 만드는 방법을 알아보세요. 이 가이드에서는 Excel Interop과 IronXL 모두 다루며, 완벽한 코드 예제를 제공합니다.
더 읽어보기
IronXL는 IRON SUITE 의 일부입니다.
10개의 .NET API 제품, 당신의 사무 문서를 위해
제품 링크
- - PDF를 생성, 읽고 편집하세요. .NET용 HTML to PDF.
- - DOCX Word 파일 편집. Office Interop 필요 없음.
- - Excel 및 CSV 파일 편집. Office Interop 필요 없음.
- - 프레젠테이션 생성, 읽기 및 편집. Office Interop 필요 없음.
- - 125개 언어로 OCR(이미지에서 텍스트 추출) 기능을 제공합니다.
- - QR 코드 및 바코드를 읽고 쓸 수 있습니다.
- - QR 코드를 읽고 쓰세요.
- - 압축 파일을 압축하고 압축을 해제합니다.
- - .NET 애플리케이션에서 문서 인쇄.
- - 웹사이트에서 구조화된 데이터를 추출합니다.
Office Interop의 번거로움 없이 필요한 Excel API를 사용하세요.
