C# XLSX 파일 읽기

This article was translated from English: Does it need improvement?
Translated
View the article in English

C#에서 XLSX 파일을 읽으려면 IronXL의 WorkBook.Load 메서드를 사용하여 Excel 파일을 열고 워크시트를 액세스하여 셀 데이터를 읽고, 계산을 수행하고, DataTable 또는 DataSet 형식으로 프로그래밍 방식으로 변환합니다.

빠른 시작: 손쉽게 워크북을 로드하고 워크시트 액세스

IronXL을 사용하면 한 줄로 WorkBook.Load 메서드를 사용하여 XLSX 파일을 로드할 수 있습니다. 그리고 첫 번째 또는 명명된 워크시트를 즉시 액세스하여 셀 값을 읽기 시작할 수 있습니다.

  1. NuGet 패키지 관리자를 사용하여 https://www.nuget.org/packages/IronXl.Excel 설치하기

    PM > Install-Package IronXl.Excel
  2. 다음 코드 조각을 복사하여 실행하세요.

    IronXl.WorkBook workbook = IronXl.WorkBook.Load("your-file.xlsx");
  3. 실제 운영 환경에서 테스트할 수 있도록 배포하세요.

    무료 체험판으로 오늘 프로젝트에서 IronXL 사용 시작하기

    arrow pointer
## .XLSX 파일 C# 읽기
  • 프로젝트에 IronXL 가져오기
  • `WorkBook` 로드
  • `WorkSheet`에서 데이터 액세스
  • Sum, Min, & Max와 같은 함수 적용
  • `WorkSheet`를 DataTable, DataSet 등으로 읽기
How To Work related to C# XLSX 파일 읽기

내 프로젝트에 IronXL을 가져오는 방법?

프로젝트에서 IronXL을 사용하여 C#에서 Excel 파일 형식을 쉽게 작업할 수 있습니다. 직접 다운로드를 통해 IronXL 설치하거나 Visual Studio를 위한 NuGet 설치를 사용할 수 있습니다. 소프트웨어는 개발을 위해 무료입니다.

Install-Package IronXl.Excel

XLSX 파일을 읽기 전에, 포괄적인 IronXL 문서를 탐색하여 사용 가능한 모든 기능을 이해하십시오. IronXL은 .xls 및 .xlsx 형식을 모두 지원하여 레거시 및 현대 Excel 파일에 모두 유연합니다.


튜토리얼 사용법

워크북을 로드하는 방법?

WorkBook는 IronXL의 클래스이며 Excel 파일과 모든 기능에 대한 전체 액세스를 제공합니다. 예를 들어, Excel 파일을 액세스하려면 코드를 사용하십시오:

:path=/static-assets/excel/content-code-examples/how-to/c-sharp-read-xlsx-file-load-workbook.cs
using IronXL;

// Load the workbook
WorkBook workBook = WorkBook.Load("sample.xlsx"); // Excel file path
$vbLabelText   $csharpLabel

왜 WorkBook.Load() 메서드를 사용하나요?

위 코드에서 WorkBook.Load() 함수가 workBooksample.xlsx를 로드합니다. Excel 파일의 특정 WorkSheet에 액세스하여 workBook에 어떤 유형의 함수도 수행할 수 있습니다. WorkBook.Load 메서드는 파일 형식을 자동으로 감지하며, XLS, XLSX, XLSM, XLTX, CSV 중 무엇인지 판단합니다. 더욱 고급 로딩 시나리오에 대한 자세한 내용은 스프레드시트 로드에 대한 자세한 안내서를 참조하세요.


특정 워크시트를 액세스하는 방법?

Excel 파일의 특정 WorkSheet에 액세스하기 위해 IronXL은 WorkSheet 클래스를 제공합니다. 여러 가지 다른 방식으로 사용할 수 있습니다:

워크시트에 액세스하는 다양한 방법은 무엇인가요?

:path=/static-assets/excel/content-code-examples/how-to/c-sharp-read-xlsx-file-get-worksheet.cs
using IronXL;

// Access sheet by name
WorkSheet workSheet = workBook.GetWorkSheet("Sheet1");
$vbLabelText   $csharpLabel

위의 부분에서 선언된 WorkBookworkBook입니다.

혹은

:path=/static-assets/excel/content-code-examples/how-to/c-sharp-read-xlsx-file-worksheet-index.cs
using IronXL;

// Access sheet by index
WorkSheet workSheet = workBook.WorkSheets[0];
$vbLabelText   $csharpLabel

혹은

:path=/static-assets/excel/content-code-examples/how-to/c-sharp-read-xlsx-file-default-worksheet.cs
using IronXL;

// Access the default worksheet
WorkSheet workSheet = workBook.DefaultWorkSheet;
$vbLabelText   $csharpLabel

혹은

:path=/static-assets/excel/content-code-examples/how-to/c-sharp-read-xlsx-file-first-worksheet.cs
using IronXL;
using System.Linq;

// Access the first worksheet
WorkSheet workSheet = workBook.WorkSheets.First();
$vbLabelText   $csharpLabel

혹은

:path=/static-assets/excel/content-code-examples/how-to/c-sharp-read-xlsx-file-first-or-default-worksheet.cs
using IronXL;
using System.Linq;

// Access the first or default worksheet
WorkSheet workSheet = workBook.WorkSheets.FirstOrDefault();
$vbLabelText   $csharpLabel

각 워크시트 액세스 메서드는 언제 사용해야 하나요?

각 메서드는 이상적인 사용 사례를 갖추고 있습니다:

  • GetWorkSheet("name"): 시트 이름을 정확히 알고 있을 때
  • WorkSheets[index]: 프로그래밍 방식으로 시트를 반복 처리할 때
  • DefaultWorkSheet: 단일 시트 파일을 작업할 때 빠르게 액세스할 때
  • First() 또는 FirstOrDefault(): 시트 이름이 변경될 수 있을 때 안전한 옵션

ExcelSheet workSheet을 얻은 후, 그로부터 어떤 유형의 데이터든 얻을 수 있으며, 모든 Excel 기능을 수행할 수 있습니다. 더 복잡한 워크시트 작업을 위해, C#에서 Excel 워크시트 열기에 대한 가이드를 참조하십시오.


워크시트에서 데이터를 액세스하는 방법?

다음 과정을 통해 ExcelSheet workSheet에서 데이터를 액세스할 수 있습니다:

셀에서 읽을 수 있는 데이터 유형은 무엇입니까?

:path=/static-assets/excel/content-code-examples/how-to/c-sharp-read-xlsx-file-get-data.cs
using IronXL;

// Accessing data as a string
string dataString = workSheet["A1"].ToString();

// Accessing data as an integer
int dataInt = workSheet["B1"].Int32Value;
$vbLabelText   $csharpLabel

IronXL은 다양한 데이터 유형에 대한 여러 값 액세서들을 제공합니다:

  • StringValue: 텍스트 데이터용
  • Int32Value: 정수용
  • DoubleValue: 소수용
  • DateTimeValue: 날짜용
  • BoolValue: true/false 값용

한 번에 여러 셀을 읽으려면 어떻게 해야 하나요?

지정된 열의 여러 셀에서 데이터를 가져올 수도 있습니다:

foreach (var cell in workSheet["A2:A10"])
{
    Console.WriteLine("Value is: {0}", cell.Text);
}
foreach (var cell in workSheet["A2:A10"])
{
    Console.WriteLine("Value is: {0}", cell.Text);
}
$vbLabelText   $csharpLabel

A2에서 A10까지의 값을 표시합니다. 보다 고급 범위 선택 기술에 대한 내용은 범위 선택 튜토리얼을 방문하세요.

완전한 구현은 어떻게 보이나요?

위의 세부 구현에 대한 완전한 코드 예시는 다음과 같습니다:

:path=/static-assets/excel/content-code-examples/how-to/c-sharp-read-xlsx-file-log-data.cs
using IronXL;
using System;

// Load an Excel file
WorkBook workBook = WorkBook.Load("sample.xlsx");
WorkSheet workSheet = workBook.GetWorkSheet("Sheet1");

// Specify the range
foreach (var cell in workSheet["B2:B10"])
{
    Console.WriteLine("Value is: {0}", cell.Text);
}
$vbLabelText   $csharpLabel

다음 결과를 표시합니다:

콘솔 출력이 보여주는 워크시트 데이터: 정부, 개인, 중소기업, 그리고 채널 파트너의 값

Excel 파일 Sample.xlsx으로:

사업 데이터가 포함된 Excel 스프레드시트: 16개의 행에 걸친 세그먼트, 국가, 제품, 할인 대역 열

이 방법론들은 프로젝트에서 Excel 파일 데이터를 사용하는 것이 얼마나 쉬운지를 보여줍니다. Interop 없이 Excel 파일을 읽는 실제 예시를 보려면 Excel 예제 읽기를 탐색하세요.


데이터에 대해 함수를 실행하려면 어떻게 해야 하나요?

다음 코드를 사용하여 Excel WorkSheet에서 Sum, Min 또는 Max와 같은 집계 함수를 적용하여 필터링된 데이터에 액세스하십시오:

사용 가능한 집계 함수는 무엇입니까?

:path=/static-assets/excel/content-code-examples/how-to/c-sharp-read-xlsx-file-aggregate-function.cs
using IronXL;

// Apply aggregate functions
decimal sum = workSheet["G2:G10"].Sum(); // Sum of cells from G2 to G10
decimal min = workSheet["G2:G10"].Min(); // Minimum value in cells from G2 to G10
decimal max = workSheet["G2:G10"].Max(); // Maximum value in cells from G2 to G10
$vbLabelText   $csharpLabel

IronXL은 다음을 포함한 수많은 수학 함수를 지원합니다:

  • Average(): 평균 값 계산
  • Count(): 비어있지 않은 셀 세기
  • CountIf(): 조건에 맞는 셀 세기
  • Median(): 중간 값 찾기
  • StdDev(): 표준편차 계산

여러 함수를 함께 구현하려면 어떻게 해야 하나요?

자세한 내용은 집계 함수에 대한 특정 사항이 포함된 C# Excel 파일 쓰기에 관한 심층 튜토리얼을 참조하세요. IronXL에서 사용 가능한 수학 함수의 전체 목록을 탐색할 수도 있습니다.

:path=/static-assets/excel/content-code-examples/how-to/c-sharp-read-xlsx-file-min-max.cs
using IronXL;
using System;

// Load the Excel workbook
WorkBook workBook = WorkBook.Load("sample.xlsx");

// Get the specified WorkSheet
WorkSheet workSheet = workBook.GetWorkSheet("Sheet1");

// Calculate sum, minimum, and maximum for a range of cells
decimal sum = workSheet["G2:G10"].Sum();
decimal min = workSheet["G2:G10"].Min();
decimal max = workSheet["G2:G10"].Max();

// Output results
Console.WriteLine("Sum is: {0}", sum);
Console.WriteLine("Min is: {0}", min);
Console.WriteLine("Max is: {0}", max);
$vbLabelText   $csharpLabel

이 코드는 다음의 출력을 표시합니다:

데이터 분석 결과 보여주는 터미널: 검은 배경에 Sum=482, Min=12, Max=350

이렇게 하면 Excel 파일 Sample.xlsx의 모양은 다음과 같습니다:

여러 행에 걸쳐 세그먼트, 국가, 제품, 판매 단위 및 가격을 보여주는 판매 데이터가 포함된 Excel 스프레드시트

Excel 워크시트를 DataTable로 읽으려면 어떻게 해야 하나요?

IronXL을 사용하면 Excel WorkSheet을 DataTable로 쉽게 작업할 수 있습니다. 이 기능은 특히 Excel 데이터를 기존 데이터 처리 파이프라인에 통합하거나 UI 컨트롤에 데이터를 바인딩해야 할 때 유용합니다.

기본 변환 방법은 무엇입니까?

:path=/static-assets/excel/content-code-examples/how-to/c-sharp-read-xlsx-file-datatable.cs
using IronXL;
using System.Data;

// Convert worksheet to DataTable
DataTable dt = workSheet.ToDataTable();
$vbLabelText   $csharpLabel

첫 번째 행을 열 머리글로 사용하려면 어떻게 해야 하나요?

ExcelSheet의 첫 번째 행을 DataTable ColumnName으로 사용하려면:

:path=/static-assets/excel/content-code-examples/how-to/c-sharp-read-xlsx-file-datatable-header.cs
using IronXL;
using System.Data;

// Convert worksheet to DataTable with the first row as column names
DataTable dt = workSheet.ToDataTable(true);
$vbLabelText   $csharpLabel

ToDataTable()의 Boolean 매개변수는 첫 번째 행을 DataTable의 열 이름으로 설정합니다. 기본값으로는 항상 False입니다. 이것은 머리글을 포함하는 구조화된 데이터를 작업할 때 특히 유용합니다.

DataTable을 반복하려면 어떻게 해야 합니까?

:path=/static-assets/excel/content-code-examples/how-to/c-sharp-read-xlsx-file-print-datatable.cs
using IronXL;
using System;
using System.Data;

// Load the Excel workbook
WorkBook workBook = WorkBook.Load("sample.xlsx");

// Get the specified WorkSheet
WorkSheet workSheet = workBook.GetWorkSheet("Sheet1");

// Convert WorkSheet to DataTable
DataTable dt = workSheet.ToDataTable(true); // Use first row as column names

// Iterate through rows and columns and display data
foreach (DataRow row in dt.Rows) // Access rows
{
    for (int i = 0; i < dt.Columns.Count; i++) // Access columns of corresponding row
    {
        Console.Write(row[i] + " ");
    }
    Console.WriteLine();
}
$vbLabelText   $csharpLabel

위의 코드를 사용하여 WorkSheet의 모든 셀 값을 필요에 따라 액세스하고 사용할 수 있습니다. 보다 고급 DataTable 작업에 대해서는 DataSet으로 내보내기 및 가져오기 가이드를 참조하세요.


Excel 파일을 DataSet로 읽으려면 어떻게 해야 합니까?

IronXL은 전체 Excel 파일 (WorkBook)을 DataSet으로 사용하는 간단한 기능을 제공합니다. 전체 워크북을 DataSet으로 변환하려면 ToDataSet 메서드를 사용하십시오.
이 예에서는 Excel 파일을 DataSet으로 사용하는 방법을 봅니다.

워크북을 DataSet으로 변환하려면 어떻게 해야 하나요?

:path=/static-assets/excel/content-code-examples/how-to/c-sharp-read-xlsx-file-excel-to-dataset.cs
using IronXL;
using System;
using System.Data;

// Load the Excel workbook
WorkBook workBook = WorkBook.Load("sample.xlsx");

// Convert the WorkBook to a DataSet
DataSet ds = workBook.ToDataSet();

// Iterate through tables in the DataSet and display table names
foreach (DataTable dt in ds.Tables)
{
    Console.WriteLine(dt.TableName);
}
$vbLabelText   $csharpLabel

위의 코드 출력은 다음과 같습니다:

손상되었거나 불완전한 스크린샷: Sheet1, Sheet2, Sheet3 레이블만 표시

그리고 Excel 파일 Sample.xlsx은 다음과 같습니다:

다양한 시장 부문 및 국가의 비즈니스 데이터를 보여주는 다중 시트 작업 책을 포함한 Excel 스프레드시트

모든 워크시트의 각 셀 값을 어떻게 액세스할 수 있나요?

위의 예에서 우리는 Excel 파일을 쉽게 DataSet으로 구문 분석하고 Excel 파일의 모든 WorkSheet을 DataTable로 작업할 수 있습니다. 여기에서 코드 예제를 사용하여 DataSet으로 Excel을 구문 분석하는 방법에 대해 더 깊이 탐구하십시오.

모든 ExcelSheets의 각 셀 값에 액세스하는 또 다른 예를 살펴봅시다. 여기에서 우리는 Excel 파일의 모든 WorkSheet의 각 셀 값을 액세스할 수 있습니다.

:path=/static-assets/excel/content-code-examples/how-to/c-sharp-read-xlsx-all-excel-sheets.cs
// 이 코드 조각은 사용할 수 없습니다!
$vbLabelText   $csharpLabel

위의 예를 사용하면 Excel 파일의 모든 WorkSheet의 각 셀 값을 편리하게 액세스할 수 있습니다. 이 방법은 데이터가 서로 다른 탭으로 분산된 멀티 시트 워크북을 처리할 때 특히 유용합니다.

Interop 없이 Excel 파일을 읽는 방법에 대한 자세한 내용은 여기를 확인하세요. API 참조 문서는 IronXL API 참조에서 모든 사용 가능한 메서드와 속성에 대한 포괄적인 세부 정보를 제공합니다.


튜토리얼 바로가기

### IronXL의 API 참조

문서에서 IronXL의 기능, 클래스, 메서드 필드, 네임스페이스 및 열거형에 대해 자세히 읽어보세요.

IronXL의 API 참조
Documentation related to 튜토리얼 바로가기

자주 묻는 질문

C#에서 XLSX 파일을 어떻게 읽나요?

C#에서 XLSX 파일을 읽으려면 IronXL의 WorkBook.Load 메서드를 사용하면 됩니다. IronXl.WorkBook.Load("your-file.xlsx")를 사용하여 Excel 파일을 로드한 다음, 워크시트에 접근하여 셀 데이터를 읽고, 계산을 수행하고, DataTable 또는 DataSet 형식으로 프로그래밍 방식으로 변환할 수 있습니다.

엑셀 파일을 불러올 때 지원되는 파일 형식은 무엇인가요?

IronXL은 .xls, .xlsx, .xlsm, .xltx 및 .csv 파일을 포함한 다양한 Excel 파일 형식을 지원합니다. WorkBook.Load 메서드는 파일 형식을 자동으로 감지하므로 기존 Excel 파일과 최신 Excel 파일 모두에서 사용할 수 있습니다.

C# 프로젝트에 Excel 읽기 라이브러리를 설치하려면 어떻게 해야 하나요?

IronXL은 직접 다운로드하거나 Visual Studio용 NuGet 설치를 통해 설치할 수 있습니다. 이 소프트웨어는 개발 목적으로 무료로 사용할 수 있으며 C#에서 Excel 파일 형식을 간편하게 다룰 수 있도록 지원합니다.

특정 워크시트에 접근하는 다양한 방법은 무엇인가요?

IronXL은 워크시트에 액세스하는 여러 가지 방법을 제공합니다. 이름으로 액세스하려면 workBook.GetWorkSheet("SheetName")을 사용하고, 인덱스로 액세스하려면 workBook.WorkSheets[0]을 사용하고, 첫 번째 워크시트를 가져오려면 workBook.WorkSheets.First()를 사용할 수 있습니다.

엑셀 데이터를 불러온 후 계산을 수행할 수 있나요?

네, IronXL을 사용하여 XLSX 파일을 불러온 후에는 합계, 최소값, 최대값 등의 다양한 함수를 데이터에 적용할 수 있습니다. 이 라이브러리는 WorkBook 객체를 통해 Excel 파일의 모든 기능을 사용할 수 있도록 지원합니다.

엑셀 워크시트 데이터를 다른 형식으로 변환하는 것이 가능할까요?

네, IronXL을 사용하면 워크시트를 읽어 DataTable, DataSet 등 다양한 형식으로 변환할 수 있습니다. 이를 통해 Excel 데이터를 C# 애플리케이션에 쉽게 통합할 수 있습니다.

커티스 차우
기술 문서 작성자

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

커티스는 개발 분야 외에도 사물 인터넷(IoT)에 깊은 관심을 가지고 있으며, 하드웨어와 소프트웨어를 통합하는 혁신적인 방법을 연구합니다. 여가 시간에는 게임을 즐기거나 디스코드 봇을 만들면서 기술에 대한 애정과 창의성을 결합합니다.

A PHP Error was encountered

Severity: Notice

Message: Undefined index: IronXl.Excel

Filename: helpers/counter_helper.php

Line Number: 85

Backtrace:

File: /var/www/ironpdf.com/application/helpers/counter_helper.php
Line: 85
Function: _error_handler

File: /var/www/ironpdf.com/application/views/main/sections/ready_to_started_202509.php
Line: 12
Function: getTotalDonwloadNumber

File: /var/www/ironpdf.com/application/libraries/Render.php
Line: 489
Function: view

File: /var/www/ironpdf.com/application/controllers/Products/Howto.php
Line: 31
Function: render_products_view

File: /var/www/ironpdf.com/index.php
Line: 292
Function: require_once

A PHP Error was encountered

Severity: Notice

Message: Undefined index: IronXl.Excel

Filename: helpers/counter_helper.php

Line Number: 85

Backtrace:

File: /var/www/ironpdf.com/application/helpers/counter_helper.php
Line: 85
Function: _error_handler

File: /var/www/ironpdf.com/application/views/main/sections/ready_to_started_202509.php
Line: 19
Function: getTotalDonwloadNumber

File: /var/www/ironpdf.com/application/libraries/Render.php
Line: 489
Function: view

File: /var/www/ironpdf.com/application/controllers/Products/Howto.php
Line: 31
Function: render_products_view

File: /var/www/ironpdf.com/index.php
Line: 292
Function: require_once

시작할 준비 되셨나요?
Nuget 다운로드 1,890,100 | 버전: 2026.3 방금 출시되었습니다

A PHP Error was encountered

Severity: Notice

Message: Undefined index: IronXl.Excel

Filename: helpers/counter_helper.php

Line Number: 85

Backtrace:

File: /var/www/ironpdf.com/application/helpers/counter_helper.php
Line: 85
Function: _error_handler

File: /var/www/ironpdf.com/application/views/main/sections/still_scrolling_202512.php
Line: 17
Function: getTotalDonwloadNumber

File: /var/www/ironpdf.com/application/views/products/sections/three_column_docs_page_structure.php
Line: 71
Function: view

File: /var/www/ironpdf.com/application/libraries/Render.php
Line: 88
Function: view

File: /var/www/ironpdf.com/application/views/products/how-to/index.php
Line: 2
Function: view

File: /var/www/ironpdf.com/application/libraries/Render.php
Line: 88
Function: view

File: /var/www/ironpdf.com/application/libraries/Render.php
Line: 552
Function: view

File: /var/www/ironpdf.com/application/controllers/Products/Howto.php
Line: 31
Function: render_products_view

File: /var/www/ironpdf.com/index.php
Line: 292
Function: require_once

A PHP Error was encountered

Severity: Notice

Message: Undefined index: IronXl.Excel

Filename: helpers/counter_helper.php

Line Number: 85

Backtrace:

File: /var/www/ironpdf.com/application/helpers/counter_helper.php
Line: 85
Function: _error_handler

File: /var/www/ironpdf.com/application/views/main/sections/still_scrolling_202512.php
Line: 24
Function: getTotalDonwloadNumber

File: /var/www/ironpdf.com/application/views/products/sections/three_column_docs_page_structure.php
Line: 71
Function: view

File: /var/www/ironpdf.com/application/libraries/Render.php
Line: 88
Function: view

File: /var/www/ironpdf.com/application/views/products/how-to/index.php
Line: 2
Function: view

File: /var/www/ironpdf.com/application/libraries/Render.php
Line: 88
Function: view

File: /var/www/ironpdf.com/application/libraries/Render.php
Line: 552
Function: view

File: /var/www/ironpdf.com/application/controllers/Products/Howto.php
Line: 31
Function: render_products_view

File: /var/www/ironpdf.com/index.php
Line: 292
Function: require_once

Still Scrolling Icon

아직도 스크롤하고 계신가요?

빠른 증거를 원하시나요? PM > Install-Package IronXl.Excel
샘플을 실행하세요 데이터가 스프레드시트로 변환되는 것을 지켜보세요.