ASP.NET Excel 내보내기: IronXL , ClosedXML, EPPlus 비교

ASP.NET Core에서 Excel로 데이터를 내보내는 일반적인 방법은 무엇입니까?

ASP.NET Core 개발자는 Excel 내보내기 기능을 추가할 때 여러 가지 방법을 사용할 수 있습니다. 각 접근 방식은 출력 파일의 품질, 구현에 필요한 노력 및 상업 프로젝트에 대한 라이센스 문제로 다릅니다.

전통적인 MIME 유형 스트리밍은 가장 오래된 기법입니다. 서버는 응답 Content-Type 헤더를 application/vnd.ms-excel로 설정하고 HTML 테이블을 출력 스트림에 작성합니다. 브라우저는 이것을 Excel 다운로드로 해석하지만, 파일은 실제 스프레드시트 데이터가 아닌 HTML 마크업을 포함하고 있습니다. Microsoft Excel은 불일치를 감지하고 파일을 열기 전에 형식 경고를 표시합니다. 이 방법은 공식적인 셀 형식, 타입화된 열 또는 적절한 셀 서식을 지원할 수 없습니다.

라이브러리 기반 솔루션은 Microsoft가 정의한 Open XML 형식을 사용하여 실제 XLSX 파일을 구성하는 NuGet 패키지를 추가합니다. 옵션에는 IronXL, 클로즈드XML, EPPlus가 포함됩니다. 이들은 모두 경고 없이 열리는 유효한 Excel 파일을 생성하며, 셀 수준의 형식을 지원하고 .NET Core에서 작동합니다. 모든 접근 방식에 사용되는 ASP.NET Core 메커니즘을 다루는 공식 .NET 파일 다운로드 문서가 있습니다.

아래 표는 주요 차이점을 요약합니다:

ASP.NET Core 프로젝트에 IronXL을 어떻게 설치합니까?

내보내기 코드를 작성하기 전에, NuGet 패키지 관리자 또는 .NET CLI를 통해 프로젝트에 IronXL을 추가하세요. IronXL은 Microsoft Office 또는 COM 상호 운용에 의존하지 않기 때문에 .NET이 지원하는 모든 운영 체제에 설치가 간단합니다.

dotnet add package IronXl.Excel

dotnet add package IronXl.Excel

대안으로, Visual Studio에서 패키지 관리자 콘솔을 사용하세요:

Install-Package IronXl.Excel

Install-Package IronXl.Excel

패키지를 설치하면 Excel 파일을 생성해야 하는 모든 컨트롤러나 서비스 클래스에 using IronXL;를 추가합니다. 기본 내보내기 시나리오를 위한 추가 구성은 필요하지 않습니다. 라이센스와 배포 옵션에 대한 정보는 IronXL 라이센스 페이지를 방문하세요.

전통적인 GridView 내보내기 접근법은 어떻게 작동합니까?

기존 WebForms 및 일부 오래된 MVC 패턴에서 개발자들은 그리드뷰 데이터를 HTML로 렌더링하고 잘못된 Content-Type 헤더와 함께 브라우저로 스트리밍하여 내보냈습니다. 응용 프로그램은 Response.AddHeader를 호출하여 파일 이름을 설정하고 HTML 출력을 직접 작성합니다.

// Traditional approach -- exports HTML disguised as Excel
public void ExportToExcel(object sender, EventArgs e)
{
    Response.Clear();
    Response.Buffer = true;
    Response.ContentType = "application/vnd.ms-excel";
    Response.AddHeader("content-disposition", "attachment;filename=Report.xls");
    StringWriter stringWriter = new StringWriter();
    HtmlTextWriter htmlTextWriter = new HtmlTextWriter(stringWriter);
    // Render grid content as HTML
    DataGrid1.RenderControl(htmlTextWriter);
    Response.Write(stringWriter.ToString());
    Response.End();
}

public override void VerifyRenderingInServerForm(Control control)
{
    // Required to prevent server form rendering errors
}

// Traditional approach -- exports HTML disguised as Excel
public void ExportToExcel(object sender, EventArgs e)
{
    Response.Clear();
    Response.Buffer = true;
    Response.ContentType = "application/vnd.ms-excel";
    Response.AddHeader("content-disposition", "attachment;filename=Report.xls");
    StringWriter stringWriter = new StringWriter();
    HtmlTextWriter htmlTextWriter = new HtmlTextWriter(stringWriter);
    // Render grid content as HTML
    DataGrid1.RenderControl(htmlTextWriter);
    Response.Write(stringWriter.ToString());
    Response.End();
}

public override void VerifyRenderingInServerForm(Control control)
{
    // Required to prevent server form rendering errors
}

IronXL이 ASP.NET Core에서 Excel 파일 생성을 어떻게 간소화하나요?

IronXL은 Microsoft Office나 COM 상호 운용성을 요구하지 않고도 진짜 XLSX 파일을 생성할 수 있는 API를 제공합니다. 라이브러리는 워크북 객체를 전적으로 관리 코드에서 구성하며, 추가적인 종속성 없이 Linux, macOS 및 Windows에서 실행됩니다.

다음 예제는 워크북을 생성하고 판매 데이터를 워크시트에 채우며, 헤더 행에 굵은 서식을 적용하고 파일을 브라우저로 스트리밍합니다:

using IronXL;
using Microsoft.AspNetCore.Mvc;

public class ExportController : Controller
{
    [HttpPost]
    public IActionResult ExportReport()
    {
        // Create workbook and worksheet
        WorkBook workbook = WorkBook.Create(ExcelFileFormat.XLSX);
        WorkSheet worksheet = workbook.CreateWorkSheet("Sales Data");

        // Add header row
        worksheet["A1"].Value = "Product";
        worksheet["B1"].Value = "Quantity";
        worksheet["C1"].Value = "Revenue";

        // Populate data rows
        worksheet["A2"].Value = "Widget A";
        worksheet["B2"].Value = 150;
        worksheet["C2"].Value = 4500.00;
        worksheet["A3"].Value = "Widget B";
        worksheet["B3"].Value = 230;
        worksheet["C3"].Value = 6900.00;

        // Apply bold formatting to headers
        var headerRange = worksheet["A1:C1"];
        headerRange.Style.Font.Bold = true;

        // Stream file to browser
        byte[] fileBytes = workbook.ToByteArray();
        string filename = $"SalesReport_{DateTime.아니요w:yyyyMMdd}.xlsx";
        return File(fileBytes,
            "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
            filename);
    }
}

using IronXL;
using Microsoft.AspNetCore.Mvc;

public class ExportController : Controller
{
    [HttpPost]
    public IActionResult ExportReport()
    {
        // Create workbook and worksheet
        WorkBook workbook = WorkBook.Create(ExcelFileFormat.XLSX);
        WorkSheet worksheet = workbook.CreateWorkSheet("Sales Data");

        // Add header row
        worksheet["A1"].Value = "Product";
        worksheet["B1"].Value = "Quantity";
        worksheet["C1"].Value = "Revenue";

        // Populate data rows
        worksheet["A2"].Value = "Widget A";
        worksheet["B2"].Value = 150;
        worksheet["C2"].Value = 4500.00;
        worksheet["A3"].Value = "Widget B";
        worksheet["B3"].Value = 230;
        worksheet["C3"].Value = 6900.00;

        // Apply bold formatting to headers
        var headerRange = worksheet["A1:C1"];
        headerRange.Style.Font.Bold = true;

        // Stream file to browser
        byte[] fileBytes = workbook.ToByteArray();
        string filename = $"SalesReport_{DateTime.아니요w:yyyyMMdd}.xlsx";
        return File(fileBytes,
            "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
            filename);
    }
}

// Export as CSV instead of XLSX
workbook.SaveAsCsv("output.csv");

// Export as CSV instead of XLSX
workbook.SaveAsCsv("output.csv");

IronXL이 DataTable 및 데이터베이스 통합을 어떻게 처리하나요?

많은 ASP.NET Core 애플리케이션은 내보내기 전에 SQL Server나 다른 관계형 데이터베이스에서 데이터를 가져옵니다. IronXL은 DataTable을 직접 워크시트로 로드하는 데 일류 지원을 제공하여 행을 수동으로 반복할 필요를 없애줍니다.

아래 예제는 ADO.NET을 사용하여 데이터베이스를 쿼리하고 결과 DataTable에서 Excel 워크시트를 채웁니다.

using IronXL;
using System.Data;
using System.Data.SqlClient;
using Microsoft.AspNetCore.Mvc;

public class ReportController : Controller
{
    private readonly string _connectionString;

    public ReportController(IConfiguration config)
    {
        _connectionString = config.GetConnectionString("DefaultConnection");
    }

    [HttpGet]
    public IActionResult DownloadReport()
    {
        DataTable table = new DataTable();

        using (SqlConnection connection = new SqlConnection(_connectionString))
        {
            string query = "SELECT OrderId, CustomerName, Total, OrderDate FROM Orders";
            using SqlDataAdapter adapter = new SqlDataAdapter(query, connection);
            adapter.Fill(table);
        }

        WorkBook workbook = WorkBook.Create(ExcelFileFormat.XLSX);
        WorkSheet worksheet = workbook.CreateWorkSheet("Orders");

        // Write column headers from DataTable schema
        for (int col = 0; col < table.Columns.Count; col++)
        {
            worksheet[0, col].Value = table.Columns[col].ColumnName;
        }

        // Write data rows
        for (int row = 0; row < table.Rows.Count; row++)
        {
            for (int col = 0; col < table.Columns.Count; col++)
            {
                worksheet[row + 1, col].Value = table.Rows[row][col].ToString();
            }
        }

        byte[] fileBytes = workbook.ToByteArray();
        return File(fileBytes,
            "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
            "Orders.xlsx");
    }
}

using IronXL;
using System.Data;
using System.Data.SqlClient;
using Microsoft.AspNetCore.Mvc;

public class ReportController : Controller
{
    private readonly string _connectionString;

    public ReportController(IConfiguration config)
    {
        _connectionString = config.GetConnectionString("DefaultConnection");
    }

    [HttpGet]
    public IActionResult DownloadReport()
    {
        DataTable table = new DataTable();

        using (SqlConnection connection = new SqlConnection(_connectionString))
        {
            string query = "SELECT OrderId, CustomerName, Total, OrderDate FROM Orders";
            using SqlDataAdapter adapter = new SqlDataAdapter(query, connection);
            adapter.Fill(table);
        }

        WorkBook workbook = WorkBook.Create(ExcelFileFormat.XLSX);
        WorkSheet worksheet = workbook.CreateWorkSheet("Orders");

        // Write column headers from DataTable schema
        for (int col = 0; col < table.Columns.Count; col++)
        {
            worksheet[0, col].Value = table.Columns[col].ColumnName;
        }

        // Write data rows
        for (int row = 0; row < table.Rows.Count; row++)
        {
            for (int col = 0; col < table.Columns.Count; col++)
            {
                worksheet[row + 1, col].Value = table.Rows[row][col].ToString();
            }
        }

        byte[] fileBytes = workbook.ToByteArray();
        return File(fileBytes,
            "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
            "Orders.xlsx");
    }
}

이 패턴은 컨트롤러를 간결하고 테스트 가능하게 유지합니다. 데이터베이스 쿼리와 워크북 구성이 명확히 분리되어 있어 데이터 소스를 교체하거나 요약 데이터를 위한 추가 워크시트를 추가하는 것이 간단합니다. 기존 Excel 파일을 DataTable로 읽어오는 것에 대한 안내는 IronXL Excel 파일 읽기 가이드를 참조하세요.

클로즈드XML과 EPPlus는 어떻게 비교되나요?

클로즈드XML은 접근 가능한 API와 함께 Microsoft의 Open XML SDK를 랩핑합니다. NuGet에서 설치하세요:

Install-Package 클로즈드XML

Install-Package 클로즈드XML

다음 예제는 일반적인 클로즈드XML 내보내기 액션을 보여줍니다:

using 클로즈드XML.Excel;
using Microsoft.AspNetCore.Mvc;

public class ExportController : Controller
{
    [HttpGet]
    public IActionResult ExportWith클로즈드XML()
    {
        using var workbook = new XLWorkbook();
        var worksheet = workbook.AddWorksheet("Data");
        worksheet.Cell(1, 1).Value = "Name";
        worksheet.Cell(1, 2).Value = "Amount";
        worksheet.Cell(2, 1).Value = "Alpha";
        worksheet.Cell(2, 2).Value = 1200;

        using var stream = new MemoryStream();
        workbook.SaveAs(stream);
        return File(stream.ToArray(),
            "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
            "export.xlsx");
    }
}

using 클로즈드XML.Excel;
using Microsoft.AspNetCore.Mvc;

public class ExportController : Controller
{
    [HttpGet]
    public IActionResult ExportWith클로즈드XML()
    {
        using var workbook = new XLWorkbook();
        var worksheet = workbook.AddWorksheet("Data");
        worksheet.Cell(1, 1).Value = "Name";
        worksheet.Cell(1, 2).Value = "Amount";
        worksheet.Cell(2, 1).Value = "Alpha";
        worksheet.Cell(2, 2).Value = 1200;

        using var stream = new MemoryStream();
        workbook.SaveAs(stream);
        return File(stream.ToArray(),
            "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
            "export.xlsx");
    }
}

프로젝트에 적합한 라이브러리를 선택하는 방법은 무엇인가요?

올바른 Excel 내보내기 라이브러리를 선택하려면 필요한 출력 형식, 프로젝트의 라이선스 제약 조건, 전문 지원이 필요한지를 고려해야 합니다.

다음 경우 IronXL을 선택하세요. 애플리케이션이 멀티 포맷 출력 (XLSX, CSV, JSON, XML)이 필요하거나, 보장된 지원 채널이 필요한 상업용 제품을 개발 중인 경우, 또는 고급 Excel 기능 (예: 수식 평가, 셀 스타일링, 차트 생성 등)이 필요한 경우. IronXL의 문서는 모든 API 표면을 자세히 다루고 있으며, 지원 팀은 라이선스 소지자에게 직접 대응합니다. 추가 패턴 및 튜토리얼은 IronXL 블로그를 참조하세요.

다음 경우 클로즈드XML을 선택하세요. 프로젝트가 오픈 소스 또는 비상업적이며 XLSX 출력만 필요한 경우. MIT 라이선스는 재배포에 제한을 두지 않으며, API는 커뮤니티 자원을 통해 잘 문서화되어 있습니다.

다음 경우 EPPlus를 선택하세요. 기존 코드베이스가 이미 EPPlus를 사용 중이고 다른 라이브러리로 마이그레이션하는 것이 상업용 라이선스를 구입하는 것보다 비용이 더 많이 드는 경우.

IronXL과 그 대안을 평가하는 팀에게는 IronXL 체험 라이선스로 구매 전 전 기능 테스트가 가능합니다. 추가 Excel 파일 읽기 및 쓰기 코드 예제는 IronXL 예제 페이지에서 확인할 수 있습니다.

다음 단계는 무엇입니까?

이제 ASP.NET Core용 Excel 내보내기 방법을 검토하셨으니 다음 단계로 나아가실 수 있습니다:

• IronXL 설치를 dotnet add package IronXl.Excel을 사용하여 설치하고 시작 가이드를 통해 첫 번째 워크북을 만듭니다.
• 코드 패턴 비교를 위해 IronXL 예제 페이지를 검토하여 데이터베이스 내보내기, 멀티시트 워크북, 스타일링된 보고서 등 사용 사례에 맞는 시나리오를 확인하세요.
• 라이선싱 평가를 위해 IronXL 라이선싱 페이지를 방문하여 개발, 스테이징, 프로덕션 배포 옵션을 이해하실 수 있습니다.
• 추가 형식 탐색은 동일한 코드베이스에서 여러 형식으로 데이터를 내보내야 하는 경우, SaveAsCsv, SaveAsJson 및 SaveAsXml 메서드를 테스트하여 추가 형식을 탐색합니다.
• 레거시 코드 마이그레이션은 솔루션에서 기존 Response.ContentType = "application/vnd.ms-excel" 패턴을 식별하고 IronXL 워크북 생성을 사용하여 사용자에게 형식 경고가 제거됩니다.

프로덕션 배포를 위해 라이선스를 구매하여 전문 지원을 받고 IronXL 라이선스 약관 준수를 보장하세요.

지금 바로 IronXL으로 시작하세요.

무료로 시작하세요