C#에서 기존 스프레드시트를 불러오는 방법

C#에서 기존 스프레드시트를 로드하는 방법

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

기존의 Excel, CSV, TSV 파일과 DataSet 객체를 IronXL의 WorkBook.Load() 메서드를 사용하여 C# 스프레드시트로 불러오세요. Excel 전용 지원을 위해 또는 CSV 형식에 대해 LoadCSV()을 사용하여 .NET 애플리케이션에서 매끄러운 데이터 조작 및 추출이 가능합니다.

CSV (Comma-Separated Values) 파일 형식은 쉼표로 구분된 값을 사용하는 표 형식 데이터 교환에 일반적으로 사용됩니다. TSV (Tab-Separated Values)는 탭으로 값을 구분하며, 데이터에 쉼표가 포함된 경우 선호됩니다. 파일 형식 간 변환에 대해 더 알아보기.

Microsoft의 .NET에서 DataSet 클래스는 ADO.NET (ActiveX Data Objects for .NET) 기술의 일부입니다. 이것은 데이터베이스 관련 응용 프로그램에 자주 사용되며 데이터베이스, XML 등 여러 출처의 데이터를 작업할 수 있게 합니다. IronXL는 DataSet 객체 가져오기 및 내보내기에 대한 원활한 통합을 제공합니다.

XLSX, XLS, XLSM, XLTX, CSV, TSV 등 Excel 파일 형식에 포함된 데이터와 DataSet 객체는 IronXL을 사용하여 Excel 스프레드시트로 불러올 수 있습니다. 이 강력한 기능은 비즈니스 응용 프로그램, 데이터 분석 프로젝트, 자동 보고 시스템에서 스프레드시트 데이터를 처리하는 개발자에게 필수적인 도구가 됩니다.

빠른 시작: 기존 스프레드시트 로드

간단한 한 가지 메서드를 사용하여 IronXL을 통해 기존 Excel, CSV 또는 TSV 파일을 WorkBook으로 로드할 수 있습니다. 개발자는 Excel 전용 지원을 위해 WorkBook.Load(...)을 호출하거나 CSV 형식 전용으로 LoadCSV(...)을 호출하여 신속하게 데이터 편집 또는 추출을 시작할 수 있습니다. 포괄적인 API 문서는 IronXL API 참고를 참조하십시오.

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

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

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

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

    arrow pointer


C#에서 Excel 스프레드시트 파일을 로드하는 방법

기존의 Excel 워크북을 로드하기 위해 정적 메서드 Load을 사용하세요. 이 메서드는 XLSX, XLS, XLSM, XLTX, CSV 및 TSV 파일 형식을 지원합니다. 워크북이 암호로 보호되어 있는 경우 메서드의 두 번째 매개변수로 암호를 전달하십시오. 이 메서드는 워크북 데이터를 바이트 배열 또는 스트림으로 수용할 수 있으며, 각각 FromByteArrayFromStream 메서드를 사용할 수 있습니다.

IronXL의 로드 기능은 실제 응용 프로그램의 다양한 시나리오를 처리하도록 설계되었습니다. 사용자가 업로드한 파일을 처리하거나, 네트워크 스트림에서 읽거나, 암호화된 문서로 작업하든, 이 라이브러리는 일관되고 신뢰할 수 있는 인터페이스를 제공합니다. Load 메서드는 파일 확장자 및 내용을 기반으로 파일 형식을 자동으로 감지하여 다양한 사용 사례에 적합합니다.

어떤 파일 형식을 로드할 수 있습니까?

:path=/static-assets/excel/content-code-examples/how-to/load-spreadsheet-load-spreadsheet.cs
using IronXL;

// Supported for XLSX, XLS, XLSM, XLTX, CSV and TSV
WorkBook workBook = WorkBook.Load("sample.xlsx");
$vbLabelText   $csharpLabel

다양한 파일 형식을 로드할 수 있는 유연성 덕분에 레거시 Excel 파일(XLS), 현대 Excel 워크북(XLSX), 매크로 사용 워크북(XLSM) 및 템플릿 파일(XLTX)을 사용할 수 있습니다. 이 호환성은 이전 시스템의 원활한 마이그레이션을 보장하며 현대 Excel 기능을 지원합니다. 새 스프레드시트 만들기에 대한 자세한 내용은 포괄적인 가이드를 확인하십시오.

비밀번호로 보호된 파일을 어떻게 처리합니까?

민감한 데이터를 처리할 때 비밀번호 보호가 자주 필요합니다. IronXL은 비밀번호를 매개변수로 제공하여 비밀번호로 보호된 워크북을 로드하는 것을 간단하게 만듭니다:

// Load password-protected Excel file
WorkBook protectedWorkBook = WorkBook.Load("protected.xlsx", "myPassword123");

// Work with the workbook normally
WorkSheet sheet = protectedWorkBook.DefaultWorkSheet;
sheet["B2"].Value = "Updated secure data";

// Save with password protection
protectedWorkBook.SaveAs("updated_protected.xlsx");
// Load password-protected Excel file
WorkBook protectedWorkBook = WorkBook.Load("protected.xlsx", "myPassword123");

// Work with the workbook normally
WorkSheet sheet = protectedWorkBook.DefaultWorkSheet;
sheet["B2"].Value = "Updated secure data";

// Save with password protection
protectedWorkBook.SaveAs("updated_protected.xlsx");
$vbLabelText   $csharpLabel

바이트 배열이나 스트림에서 로드하는 것은 어떻습니까?

현대 응용 프로그램에서는 파일이 웹 업로드, API 응답 또는 데이터베이스 BLOB과 같은 다양한 소스에서 오는 경우가 많습니다. IronXL은 이러한 시나리오를 우아하게 처리합니다:

// Loading from byte array
byte[] excelBytes = File.ReadAllBytes("sample.xlsx");
WorkBook workBookFromBytes = WorkBook.FromByteArray(excelBytes);

// Loading from stream
using (FileStream stream = new FileStream("sample.xlsx", FileMode.Open))
{
    WorkBook workBookFromStream = WorkBook.FromStream(stream);

    // Process the workbook
    var sheet = workBookFromStream.DefaultWorkSheet;
    Console.WriteLine($"Sheet has {sheet.RowCount} rows");
}

// Loading from MemoryStream (common in web applications)
using (MemoryStream memStream = new MemoryStream(excelBytes))
{
    WorkBook workBookFromMemory = WorkBook.FromStream(memStream);
}
// Loading from byte array
byte[] excelBytes = File.ReadAllBytes("sample.xlsx");
WorkBook workBookFromBytes = WorkBook.FromByteArray(excelBytes);

// Loading from stream
using (FileStream stream = new FileStream("sample.xlsx", FileMode.Open))
{
    WorkBook workBookFromStream = WorkBook.FromStream(stream);

    // Process the workbook
    var sheet = workBookFromStream.DefaultWorkSheet;
    Console.WriteLine($"Sheet has {sheet.RowCount} rows");
}

// Loading from MemoryStream (common in web applications)
using (MemoryStream memStream = new MemoryStream(excelBytes))
{
    WorkBook workBookFromMemory = WorkBook.FromStream(memStream);
}
$vbLabelText   $csharpLabel

CSV 파일에 전용 메소드를 사용해야 하는 이유는 무엇입니까?

Load 메서드는 사용 가능한 모든 파일 형식을 읽을 수 있지만, CSV 파일 형식에는 LoadCSV 메서드를 사용하여 최적의 처리를 보장하세요. CSV 파일은 구분 기호 감지, 인코딩 처리, 데이터 유형 유추와 같은 전문화된 처리를 통해 이익을 얻는 고유한 특성을 가지고 있습니다. 특히 국제 데이터 형식으로 작업하거나 CSV 파일이 세미콜론이나 파이프와 같은 비표준 구분 기호를 사용할 때 유용합니다.

LoadCSV는 언제 Load보다 더 나은가요?

CSV 구문 분석에 대한 향상된 제어를 제공하는 LoadCSV 메서드는 사용자 정의 구분 기호 지정, 다양한 인코딩 처리, 대용량 CSV 파일 작업 시 이상적입니다. 특히 국제 데이터 형식으로 작업하거나 CSV 파일이 세미콜론이나 파이프와 같은 비표준 구분 기호를 사용할 때 유용합니다.

LoadCSV는 특수 문자를 어떻게 처리합니까?

:path=/static-assets/excel/content-code-examples/how-to/load-spreadsheet-load-csv.cs
using IronXL;

// Load CSV file
WorkBook workBook = WorkBook.LoadCSV("sample.csv");
$vbLabelText   $csharpLabel

특수 문자, 억양이 있는 문자, 국제 심벌이 올바르게 유지되도록 하는 LoadCSV 메서드는 UTF-8, UTF-16, ASCII 등 다양한 인코딩을 자동으로 처리합니다. 이는 다국어 데이터 또는 과학적 표기법으로 작업할 때 매우 중요합니다. 완전한 CSV 워크플로우 관리를 위해 .NET에서 CSV 파일 작성에 대한 자세한 내용을 알아보세요.


Excel에 DataSet 객체를 로드하는 방법은 무엇입니까?

Microsoft .NET의 DataSet 클래스는 연결되지 않은 메모리 내 표현에서 데이터를 관리하고 작업하는 데 사용됩니다. 이 DataSet은/는 LoadWorkSheetsFromDataSet 메서드를 사용하여 워크북에 로드될 수 있습니다. 아래 코드 예제에서는 빈 DataSet이/가 생성됩니다. 그러나 데이터베이스 쿼리에서 DataSet을/를 인스턴스화하는 것이 더 일반적입니다.

DataSet을 Excel로 변환하는 이유는 무엇입니까?

보고, 데이터 내보내기, 사용자 친화적인 데이터 표현 생성을 위해 DataSet 객체를 Excel 형식으로 변환하는 것은 필수적입니다. 비즈니스 사용자는 종종 데이터 분석을 위해 Excel 형식을 선호하며, 자동화된 보고서는 데이터베이스 결과를 스프레드시트 형식으로 변환해야 할 경우가 많습니다. 이 변환은 조건부 서식, 차트 생성, 그리고 원시 DataSet 객체에는 없는 수식 적용과 같은 기능을 활성화합니다.

DataSet 관계는 Excel에 어떻게 반영됩니까?

여러 관련 테이블을 갖는 DataSet을 로드할 때 IronXL은 DataSet 내 각 DataTable에 대해 개별 워크시트를 생성합니다. 테이블 관계는 일관된 키 값을 통해 유지되며, 이렇게 하면 내보낸 Excel 파일로 작업할 때 데이터 무결성을 유지할 수 있습니다. 이는 참조 무결성을 유지하면서 복잡한 데이터베이스 스키마를 내보내기에 이상적입니다.

여러 테이블을 DataSet에서 로드할 수 있습니까?

:path=/static-assets/excel/content-code-examples/how-to/load-spreadsheet-load-dataset.cs
using IronXL;
using System.Data;

// Create dataset
DataSet dataSet = new DataSet();

// Create workbook
WorkBook workBook = WorkBook.Create();

// Load DataSet
WorkBook.LoadWorkSheetsFromDataSet(dataSet, workBook);
$vbLabelText   $csharpLabel

데이터베이스 통합과 관련된 보다 고급 시나리오에 대해, Excel과 데이터베이스 간 양방향 데이터 흐름을 보여주는 Excel에서 SQL로의 System.Data.DataSet을 통한 가이드를 참조하세요.

다양한 데이터 소스를 Excel 형식으로 로딩할 수 있는 기능은 IronXL을 .NET 개발자들에게 귀중한 도구로 만듭니다. 보고서 시스템 구축, 데이터 마이그레이션 도구 또는 비즈니스 인텔리전스 응용 프로그램을 구축하든, 로딩 기능은 강력한 스프레드시트 조작의 기초를 제공합니다. 종합적인 튜토리얼 섹션을 방문하여 더 많은 예제와 고급 기술을 참조하세요.

자주 묻는 질문

C# 스프레드시트에 어떤 파일 형식을 불러올 수 있나요?

IronXL은 XLSX, XLS, XLSM, XLTX, CSV, TSV 파일 형식은 물론 DataSet 객체까지 다양한 파일 형식을 지원합니다. 이러한 포괄적인 형식 지원 덕분에 IronXL은 .NET 애플리케이션에서 다양한 스프레드시트 데이터 조작 요구 사항에 적합합니다.

C#에서 Excel 파일을 불러오는 방법은 무엇인가요?

IronXL의 WorkBook.Load() 메서드를 사용하면 단 한 줄의 코드로 Excel 파일을 불러올 수 있습니다. 예를 들어, IronXl.WorkBook workbook = IronXl.WorkBook.Load("sample.xlsx") 와 같이 작성하면 됩니다. CSV 파일의 경우에는 LoadCSV() 메서드를 사용하십시오.

암호로 보호된 엑셀 파일을 불러올 수 있나요?

네, IronXL은 암호로 보호된 통합 문서를 불러오는 것을 지원합니다. 암호화된 Excel 파일을 열 때 Load 메서드의 두 번째 매개변수로 암호를 전달하기만 하면 됩니다.

CSV 파일 형식과 TSV 파일 형식의 차이점은 무엇인가요?

CSV(쉼표로 구분된 값)는 값을 쉼표로 구분하며 데이터 교환에 일반적으로 사용됩니다. TSV(탭으로 구분된 값)는 쉼표 대신 탭을 사용하며, 데이터에 쉼표가 포함된 경우 선호됩니다. IronXL은 두 가지 형식을 모두 원활하게 로드할 수 있도록 지원합니다.

파일 이외의 소스에서 Excel 데이터를 불러올 수 있나요?

예, IronXL은 FromByteArray 메서드를 사용한 바이트 배열이나 FromStream 메서드를 사용한 스트림을 포함하여 여러 소스에서 통합 문서 데이터를 로드할 수 있습니다. 이러한 유연성을 통해 업로드된 파일, 네트워크 스트림 또는 메모리에서 파일을 처리할 수 있습니다.

스프레드시트에서 DataSet 객체를 어떻게 사용하나요?

IronXL은 ADO.NET DataSet 개체에서 Excel 스프레드시트로 데이터를 가져오는 LoadWorkSheetsFromDataSet 메서드를 제공합니다. 이 통합을 통해 데이터베이스 애플리케이션과 Excel 통합 문서 간의 원활한 데이터 전송이 가능합니다.

스프레드시트 데이터를 불러오고 내보내는 주요 단계는 무엇입니까?

워크플로는 다음과 같습니다. 1) IronXL 라이브러리 다운로드, 2) 파일 또는 데이터셋 준비, 3) Load 메서드를 사용하여 통합 문서 개체 생성, 4) LoadWorkSheetsFromDataSet 메서드를 사용하여 데이터셋 가져오기, 5) 필요에 따라 통합 문서 내보내기.

로딩 방법에 대한 포괄적인 문서가 있습니까?

예, IronXL은 IronXL API 참조에서 모든 로딩 메서드와 해당 매개변수에 대한 자세한 정보를 포함한 완벽한 API 문서를 제공하여 개발자가 스프레드시트 로딩 기능을 효과적으로 구현할 수 있도록 지원합니다.

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

커티스 차우는 칼턴 대학교에서 컴퓨터 과학 학사 학위를 취득했으며, 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
샘플을 실행하세요 데이터가 스프레드시트로 변환되는 것을 지켜보세요.