.NET C#에서 Excel 파일 다운로드: XLSX, CSV 등 다양한 형식으로 데이터 내보내기

컨트롤러에서 엑셀 파일 생성 및 다운로드 방법

ASP.NET Core 시나리오에서 엑셀 파일을 다운로드하려면 세 가지 핵심 단계가 필요합니다: 워크북 생성, 스트림에 작성, 스트림을 파일 응답으로 반환. 다음 코드는 처음부터XLSX파일을 생성하고 브라우저로 전송하는 완전한 MVC 컨트롤러 액션을 보여줍니다.

using IronXL;
using Microsoft.AspNetCore.Mvc;
public class ReportController : Controller
{
    // Export employee data as a downloadable Excel file
    public IActionResult DownloadExcel()
    {
        // Create a new workbook and worksheet
        var workbook = WorkBook.Create(ExcelFileFormat.XLSX);
        var worksheet = workbook.CreateWorkSheet("Employees");
        // Add header row with column names
        worksheet["A1"].Value = "Name";
        worksheet["B1"].Value = "Department";
        worksheet["C1"].Value = "Salary";
        // Populate cells with data values
        worksheet["A2"].Value = "Alice Torres";
        worksheet["B2"].Value = "Engineering";
        worksheet["C2"].Value = 95000;
        worksheet["A3"].Value = "James Park";
        worksheet["B3"].Value = "Marketing";
        worksheet["C3"].Value = 78000;
        // Export workbook to a MemoryStream for download
        var stream = workbook.ToStream();
        string filename = "Employees.xlsx";
        var content = "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet";
        // Return file to the browser with content disposition attachment
        return File(stream, content, filename);
    }
}

using IronXL;
using Microsoft.AspNetCore.Mvc;
public class ReportController : Controller
{
    // Export employee data as a downloadable Excel file
    public IActionResult DownloadExcel()
    {
        // Create a new workbook and worksheet
        var workbook = WorkBook.Create(ExcelFileFormat.XLSX);
        var worksheet = workbook.CreateWorkSheet("Employees");
        // Add header row with column names
        worksheet["A1"].Value = "Name";
        worksheet["B1"].Value = "Department";
        worksheet["C1"].Value = "Salary";
        // Populate cells with data values
        worksheet["A2"].Value = "Alice Torres";
        worksheet["B2"].Value = "Engineering";
        worksheet["C2"].Value = 95000;
        worksheet["A3"].Value = "James Park";
        worksheet["B3"].Value = "Marketing";
        worksheet["C3"].Value = 78000;
        // Export workbook to a MemoryStream for download
        var stream = workbook.ToStream();
        string filename = "Employees.xlsx";
        var content = "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet";
        // Return file to the browser with content disposition attachment
        return File(stream, content, filename);
    }
}

XLSX대신CSV파일로 데이터를 다운로드하는 방법

가벼운CSV파일이 더 나은 선택인 경우가 있으며, 특히 다른 시스템, 데이터베이스 또는 Excel의 기능이 필요 없는 도구에 데이터를 제공할 때 그렇습니다. IronXL은 형식 간의 전환을 쉽게 만듭니다.

using IronXL;
using Microsoft.AspNetCore.Mvc;
public class CsvController : Controller
{
    // Export data as aCSVfile download
    public IActionResult ExportCsv()
    {
        var workbook = WorkBook.Create(ExcelFileFormat.XLSX);
        var worksheet = workbook.CreateWorkSheet("Products");
        worksheet["A1"].Value = "SKU";
        worksheet["B1"].Value = "Product";
        worksheet["C1"].Value = "Price";
        worksheet["A2"].Value = "WDG-001";
        worksheet["B2"].Value = "Widget Pro";
        worksheet["C2"].Value = 29.99;
        // Convert toCSVstream instead of XLSX
        var stream = workbook.ToCsvStream();
        string filename = "Products.csv";
        return File(stream, "text/csv", filename);
    }
}

using IronXL;
using Microsoft.AspNetCore.Mvc;
public class CsvController : Controller
{
    // Export data as aCSVfile download
    public IActionResult ExportCsv()
    {
        var workbook = WorkBook.Create(ExcelFileFormat.XLSX);
        var worksheet = workbook.CreateWorkSheet("Products");
        worksheet["A1"].Value = "SKU";
        worksheet["B1"].Value = "Product";
        worksheet["C1"].Value = "Price";
        worksheet["A2"].Value = "WDG-001";
        worksheet["B2"].Value = "Widget Pro";
        worksheet["C2"].Value = 29.99;
        // Convert toCSVstream instead of XLSX
        var stream = workbook.ToCsvStream();
        string filename = "Products.csv";
        return File(stream, "text/csv", filename);
    }
}

업로드를 다른 형식으로 다시 내보내는 방법은?

일반적인 웹 애플리케이션 시나리오에는 사용자가 업로드한 파일을 수락하고 다른 형식으로 내보내는 것이 포함됩니다. 예를 들어,XLS업로드를 XLSX로 변환하거나, 기존 형식으로 저장된 워크북에서CSV파일을 생성하는 것입니다.

public IActionResult ConvertUpload(IFormFile upload)
{
    using var memoryStream = new MemoryStream();
    upload.CopyTo(memoryStream);
    memoryStream.Position = 0;
    // Load uploaded Excel file from the stream
    var workbook = WorkBook.Load(memoryStream);
    // Re-export asXLSXregardless of the original file extension or file type
    var stream = workbook.ToXlsxStream();
    string filename = Path.GetFileNameWithoutExtension(upload.FileName) + ".xlsx";
    return File(stream, "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet", filename);
}

public IActionResult ConvertUpload(IFormFile upload)
{
    using var memoryStream = new MemoryStream();
    upload.CopyTo(memoryStream);
    memoryStream.Position = 0;
    // Load uploaded Excel file from the stream
    var workbook = WorkBook.Load(memoryStream);
    // Re-export asXLSXregardless of the original file extension or file type
    var stream = workbook.ToXlsxStream();
    string filename = Path.GetFileNameWithoutExtension(upload.FileName) + ".xlsx";
    return File(stream, "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet", filename);
}

어떤 파일 형식이 내보내질 수 있나요?

IronXL은 데이터를 여러 스프레드시트 및 데이터 교환 형식으로 내보낼 수 있습니다. 아래 표는 사용 가능한 출력 옵션과 그 최적의 사용 사례를 요약한 것입니다.

|형식| 파일 확장자 | 스트림 메서드 | 최상의 사용 사례 | |---|---|---|---| |XLSX|.xlsx|ToXlsxStream()| 서식 및 수식이 있는 최신 엑셀 스프레드시트 | |XLS|.xls|ToXlsStream()| 레거시 시스템 호환성 | |CSV|.csv|ToCsvStream()| 데이터베이스 임포트, 데이터 파이프라인, 경량 내보내기 | |XML|.xml|ToXmlStream()| 기업 시스템 통합 | |JSON|.json|SaveAsJson()| 웹 API 응답 및 데이터 교환 | |HTML|.html|ExportToHtml()| 스프레드시트 데이터의 웹 페이지 디스플레이 |

모든 스트림 메서드는 ASP.NET Core의 File() 반환 도우미에 직접 연결되는 MemoryStream을 반환합니다. 바이트 배열 대안(ToByteArray()) 역시 사용할 수 있으며, 예를 들어 바이트[]가 더 편리한 경우, blob 데이터베이스에 저장하거나 이메일 응답 스트림에 첨부할 때 사용합니다. 이 모든 메서드는 IronXL NuGet 패키지를 설치한 즉시 사용할 수 있습니다. 각 내보내기 형식에 대한 전체 안내는 엑셀로 내보내기 문서를 참조하세요.

비즈니스 분석가를 위한XLSX형식으로 파일을 다운로드하거나, 데이터 엔지니어를 위한CSV파일을 내보내거나, 기업 통합을 위한 XML을 생성하는 것이 목표인 경우, IronXL은 코드를 깔끔하게 유지하며 .NET Core와 .NET Framework 애플리케이션에서 출력이 안정적입니다. 다음 프로젝트에서 스프레드시트 내보내기를 배송할 준비가 되셨나요? 무료 체험판 라이센스를 받거나 라이센싱 옵션을 탐색하여 오늘 시작하세요. 단계별 설정 지침은 IronXL 시작 가이드를 참조하세요.