ASP.NET C#에서 Excel 파일을 GridView로 가져오는 방법

Excel GridView 통합을 위해 IronXL을 설치하는 방법은 무엇인가요?

코드를 작성하기 전에 ASP.NET 프로젝트에 IronXL을 추가해야 합니다. 가장 빠른 방법은 Visual Studio 패키지 관리자 콘솔이나 .NET CLI를 통해 NuGet을 사용하는 것입니다.

Install-Package IronXL
dotnet add package IronXL

Install-Package IronXL
dotnet add package IronXL

설치가 완료되면 NuGet은 프로젝트에 필요한 모든 참조를 추가합니다. 설치할 외부 드라이버가 없으며, 등록할 OLEDB 공급자가 없고, 서버에서 Microsoft Office에 대한 의존성이 없습니다. 이 라이브러리는 단일 관리 어셈블리로 제공되며 Windows, Linux, macOS 및 Azure App Service 같은 클라우드 호스팅 환경에서 작동합니다.

설치 후 Excel 데이터를 읽거나 쓰는 모든 코드 비하인드 파일에 다음 네임스페이스를 추가하세요:

using IronXL;
using System.Data;
using System.IO;

using IronXL;
using System.Data;
using System.IO;

IronXL은 .xls(Excel 97-2003) 및 .xlsx(Excel 2007+) 형식을 모두 지원하므로 각 파일 유형에 대해 별도로 처리할 필요가 없습니다. 같은 WorkBook.Load 호출이 파일 서명을 자동으로 검사하여 두 형식을 모두 처리합니다.

GridView에 Excel 데이터를 로드하는 가장 빠른 방법은 무엇인가요?

가장 빠른 방법은 WorkBook.Load, sheet.ToDataTable, 및 GridView.DataBind를 결합하여 약 네 줄의 효과적인 코드를 만듭니다. 기본 시나리오에서는 수동으로 열을 생성하거나 행을 반복할 필요가 없습니다.

using IronXL;
using System.Data;

WorkBook workBook = WorkBook.Load("data.xlsx");
WorkSheet sheet = workBook.DefaultWorkSheet;

// true = treat first row as column headers
DataTable dataTable = sheet.ToDataTable(true);

GridView1.DataSource = dataTable;
GridView1.DataBind();

using IronXL;
using System.Data;

WorkBook workBook = WorkBook.Load("data.xlsx");
WorkSheet sheet = workBook.DefaultWorkSheet;

// true = treat first row as column headers
DataTable dataTable = sheet.ToDataTable(true);

GridView1.DataSource = dataTable;
GridView1.DataBind();

ToDataTable(true) 호출은 IronXL에게 워크시트의 첫 번째 행을 결과 DataTable의 열 이름으로 승격하도록 지시합니다. 해당 테이블을 GridView에 AutoGenerateColumns="true"와 바인딩하면, ASP.NET은 자동으로 각 Excel 헤더당 하나의 열을 생성합니다.

ASP.NET Web Forms 페이지를 사용하여 Excel을 가져오는 방법은 무엇인가요?

최소한의 가져오기 페이지에는 세 가지 컨트롤이 필요합니다: 파일 업로드 입력, 제출 버튼, 및 GridView. <form runat="server"> 요소 내에 다음 ASPX 마크업을 추가하십시오:

<asp:FileUpload ID="FileUpload1" runat="server" />
<asp:Button ID="btnUpload" runat="server" Text="Upload Excel File"
    OnClick="btnUpload_Click" />
<asp:GridView ID="GridView1" runat="server" AutoGenerateColumns="true"
    CssClass="table table-bordered" />

<asp:FileUpload ID="FileUpload1" runat="server" />
<asp:Button ID="btnUpload" runat="server" Text="Upload Excel File"
    OnClick="btnUpload_Click" />
<asp:GridView ID="GridView1" runat="server" AutoGenerateColumns="true"
    CssClass="table table-bordered" />

CssClass 속성은 Bootstrap 스타일시트를 사용하는 경우, 그리드를 스타일링된 행과 테두리가 추가 구성 없이 연결합니다.

코드 비하인드에서 버튼 클릭 이벤트를 처리합니다. 아래 패턴은 업로드된 파일을 임시 서버 경로에 저장하고, IronXL로 로드하며, 결과 DataTable을 그리드에 바인딩합니다:

using IronXL;
using System.Data;
using System.IO;

void btnUpload_Click(object sender, EventArgs e)
{
    if (!FileUpload1.HasFile) return;

    string uploadDir = Server.MapPath("~/Uploads/");
    Directory.CreateDirectory(uploadDir); // ensure directory exists

    string filePath = Path.Combine(uploadDir, Path.GetFileName(FileUpload1.FileName));
    FileUpload1.SaveAs(filePath);

    WorkBook workBook = WorkBook.Load(filePath);
    WorkSheet sheet = workBook.DefaultWorkSheet;
    DataTable dt = sheet.ToDataTable(true);

    GridView1.DataSource = dt;
    GridView1.DataBind();

    // Store for later export operations
    Session["CurrentData"] = dt;
}

using IronXL;
using System.Data;
using System.IO;

void btnUpload_Click(object sender, EventArgs e)
{
    if (!FileUpload1.HasFile) return;

    string uploadDir = Server.MapPath("~/Uploads/");
    Directory.CreateDirectory(uploadDir); // ensure directory exists

    string filePath = Path.Combine(uploadDir, Path.GetFileName(FileUpload1.FileName));
    FileUpload1.SaveAs(filePath);

    WorkBook workBook = WorkBook.Load(filePath);
    WorkSheet sheet = workBook.DefaultWorkSheet;
    DataTable dt = sheet.ToDataTable(true);

    GridView1.DataSource = dt;
    GridView1.DataBind();

    // Store for later export operations
    Session["CurrentData"] = dt;
}

이 구현은 Web Forms 이벤트 서명을 유지하면서 이벤트 핸들러 내부에서 논리의 최상위 문장 스타일을 따릅니다. Directory.CreateDirectory가 방어적으로 호출된 것을 주목하십시오 - Uploads 폴더가 이미 존재하는 경우, 호출은 아무런 작업도 하지 않습니다.

사용자가 .xlsx 파일을 선택하고 업로드 버튼을 클릭하면, 그리드가 스프레드시트 내용으로 채워집니다. 열 이름은 Excel 파일의 첫 번째 행에서 오며, 이후 모든 행은 그리드의 데이터 행이 됩니다.

string ext = Path.GetExtension(FileUpload1.FileName).To낮음erInvariant();
string[] allowed = { ".xls", ".xlsx" };

if (!allowed.Contains(ext))
{
    lblError.Text = "Only .xls and .xlsx files are accepted.";
    return;
}

string ext = Path.GetExtension(FileUpload1.FileName).To낮음erInvariant();
string[] allowed = { ".xls", ".xlsx" };

if (!allowed.Contains(ext))
{
    lblError.Text = "Only .xls and .xlsx files are accepted.";
    return;
}

특정 워크시트와 셀 범위에 어떻게 액세스하나요?

Excel 워크북이 여러 시트를 포함하는 경우, DefaultWorkSheet에 의존하지 않고 이름으로 특정 시트를 타겟팅해야 합니다. IronXL은 문자열로 시트 탭 이름을 받는 GetWorkSheet 메서드를 제공합니다.

using IronXL;
using System.Data;

WorkBook workBook = WorkBook.Load("sales-report.xlsx");

// Access a named sheet
WorkSheet salesSheet = workBook.GetWorkSheet("Q4 Sales");

// Read a specific cell range
var topTen = salesSheet["A1:E11"];

// Convert the entire workbook to a DataSet (one DataTable per sheet)
DataSet allSheets = workBook.ToDataSet();

// Bind the first sheet's DataTable to the grid
GridView1.DataSource = allSheets.Tables[0];
GridView1.DataBind();

using IronXL;
using System.Data;

WorkBook workBook = WorkBook.Load("sales-report.xlsx");

// Access a named sheet
WorkSheet salesSheet = workBook.GetWorkSheet("Q4 Sales");

// Read a specific cell range
var topTen = salesSheet["A1:E11"];

// Convert the entire workbook to a DataSet (one DataTable per sheet)
DataSet allSheets = workBook.ToDataSet();

// Bind the first sheet's DataTable to the grid
GridView1.DataSource = allSheets.Tables[0];
GridView1.DataBind();

ToDataSet 메서드는 애플리케이션이 여러 시트에서 데이터를 표시해야 하거나 사용자가 볼 시트를 선택할 수 있도록 할 때 유용합니다. 반환된 DataSet의 각각의 DataTable은 하나의 Excel 워크시트를 나타내며, 테이블 이름은 시트 탭 이름과 일치합니다.

DataTable dt = sheet.ToDataTable(true);
DataView dv = new DataView(dt)
{
    RowFilter = "Status = 'Active'"
};

GridView1.DataSource = dv;
GridView1.DataBind();

DataTable dt = sheet.ToDataTable(true);
DataView dv = new DataView(dt)
{
    RowFilter = "Status = 'Active'"
};

GridView1.DataSource = dv;
GridView1.DataBind();

Excel GridView 바인딩을 위한 가져오기 방법을 어떻게 비교하나요?

Excel-to-GridView 바인딩에 대한 다양한 접근 방식은 서로 다른 장단점을 갖고 있습니다. 아래 표는 가장 일반적인 방법을 요약하여 시나리오에 적합한 방법을 선택할 수 있도록 합니다.

IronXL은 레거시 XLS와 최신 XLSX 형식을 모두 지원하며, 서버 측 드라이버 설치가 필요하지 않고, 나열된 옵션 중 가장 낮은 코드 복잡성을 제공합니다. 기존에 IronPDF나 IronOCR 같은 다른 Iron Software 제품을 사용하는 팀의 경우, 단일 Iron Software 라이선스가 전체 제품군을 커버합니다.

GridView 데이터를 Excel로 다시 내보내는 방법은?

IronXL을 사용하면 Excel에서 그리드로, 그리고 다시 Excel로의 왕복 처리가 간결합니다. 사용자가 현재 그리드에 표시된 내용을 Excel로 내보낼 수 있는 "Excel로 다운로드" 버튼에 유용한 패턴입니다.

void btnExport_Click(object sender, EventArgs e)
{
    DataTable dt = Session["CurrentData"] as DataTable;
    if (dt == null) return;

    WorkBook workBook = WorkBook.Create(ExcelFileFormat.XLSX);
    WorkSheet ws = workBook.CreateWorkSheet("Export");

    // Write header row
    for (int col = 0; col < dt.Columns.Count; col++)
        ws.SetCellValue(0, col, dt.Columns[col].ColumnName);

    // Write data rows
    for (int row = 0; row < dt.Rows.Count; row++)
        for (int col = 0; col < dt.Columns.Count; col++)
            ws.SetCellValue(row + 1, col, dt.Rows[row][col]?.ToString() ?? string.Empty);

    string exportDir = Server.MapPath("~/Exports/");
    Directory.CreateDirectory(exportDir);
    string exportPath = Path.Combine(exportDir, "export.xlsx");
    workBook.SaveAs(exportPath);

    Response.Clear();
    Response.ContentType = "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet";
    Response.AddHeader("Content-Disposition", "attachment; filename=export.xlsx");
    Response.TransmitFile(exportPath);
    Response.End();
}

void btnExport_Click(object sender, EventArgs e)
{
    DataTable dt = Session["CurrentData"] as DataTable;
    if (dt == null) return;

    WorkBook workBook = WorkBook.Create(ExcelFileFormat.XLSX);
    WorkSheet ws = workBook.CreateWorkSheet("Export");

    // Write header row
    for (int col = 0; col < dt.Columns.Count; col++)
        ws.SetCellValue(0, col, dt.Columns[col].ColumnName);

    // Write data rows
    for (int row = 0; row < dt.Rows.Count; row++)
        for (int col = 0; col < dt.Columns.Count; col++)
            ws.SetCellValue(row + 1, col, dt.Rows[row][col]?.ToString() ?? string.Empty);

    string exportDir = Server.MapPath("~/Exports/");
    Directory.CreateDirectory(exportDir);
    string exportPath = Path.Combine(exportDir, "export.xlsx");
    workBook.SaveAs(exportPath);

    Response.Clear();
    Response.ContentType = "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet";
    Response.AddHeader("Content-Disposition", "attachment; filename=export.xlsx");
    Response.TransmitFile(exportPath);
    Response.End();
}

Response.TransmitFile 호출은 저장된 파일을 브라우저로 스트리밍하여 다운로드 대화 상자를 발동시킵니다. Content-Disposition: attachment 헤더는 브라우저가 파일을 인라인으로 표시하려고 하기보다는 다운로드하도록 보장합니다.

// Bold the header row
ws["A1:Z1"].Style.Font.Bold = true;

// Apply a currency format to column C (index 2), rows 2 onward
ws[$"C2:C{dt.Rows.Count + 1}"].FormatString = IronXl.Styles.BuiltinFormats.Accounting2;

// Auto-fit column widths (IronXL approximates based on content length)
ws.AutoSizeColumn(0);
ws.AutoSizeColumn(1);

// Bold the header row
ws["A1:Z1"].Style.Font.Bold = true;

// Apply a currency format to column C (index 2), rows 2 onward
ws[$"C2:C{dt.Rows.Count + 1}"].FormatString = IronXl.Styles.BuiltinFormats.Accounting2;

// Auto-fit column widths (IronXL approximates based on content length)
ws.AutoSizeColumn(0);
ws.AutoSizeColumn(1);

다음 단계는 무엇입니까?

IronXL을 사용하면 ASP.NET GridView에 Excel 파일을 가져오고 GridView 데이터를 다시 Excel로 내보내는 완전하고 드라이버 없는 파이프라인을 갖게 됩니다. 이 기초를 바탕으로 탐색할 다음 사항은 다음과 같습니다:

• 전체 API 참조와 함께 수식 평가, 셀 범위 작업 및 차트 생성을 포함하여 IronXL 문서를 읽으십시오
• CSV 가져오기, 암호로 보호된 워크북, 조건부 서식 등을 다루는 실행 가능한 코드 스니펫이 있는 IronXL 코드 예제 라이브러리를 탐색하십시오
• 형식화된 열 매핑 및 null 처리에 대한 심층적인 설명을 원하면 Excel에서 DataTable로 변환하는 튜토리얼을 시도해 보십시오
• 개발 라이선스에서 OEM 재배포 라이선스에 이르기까지 옵션을 검토하려면 IronXL 라이선스 페이지를 확인하십시오
• 워크북 및 워크시트 탐색을 자세히 이해하려면 Iron Software의 .NET Excel 읽기 가이드를 검토하십시오
• OLEDB, EPPlus 및 Open XML SDK와 비교하여 기능별 비교를 할 수 있는 C# Excel 라이브러리 비교를 사용하여 IronXL을 대안과 비교하십시오

.NET Core 및 ASP.NET Core 응용 프로그램의 경우 동일한 IronXL API가 Razor Pages 및 MVC 컨트롤러에서 작동합니다. IronXL ASP.NET Core 가이드는 파일 업로드 처리 및 종속성 주입 패턴의 차이점을 안내합니다.

문서 생성과 함께 IronXL을 통합하는 경우, IronPDF 통합 가이드는 Excel 이외에 GridView 데이터를 PDF 보고서로 내보내는 방법을 보여줍니다. 두 형식이 모두 필요한 응용 프로그램에 유용합니다.

IronXL 체험판을 시작하여 구매하기 전에 프로젝트에서 모든 기능을 테스트하십시오. 체험판 라이선스를 위한 신용카드는 필요하지 않습니다.