IronXL 사용하여 Blazor 에서 Excel 파일을 내보내는 방법

Blazor 서버 프로젝트 생성

먼저 .NET 10을 대상으로 설정된 Visual Studio 2022 이상에서 새 Blazor 서버 프로젝트를 생성하세요. 프로젝트가 준비되면 NuGet 패키지 관리자 콘솔을 통해 IronXL을 설치하세요:

Install-Package IronXl.Excel

IronXL은 .NET 6 이상과 호환되므로 기존 Blazor 프로젝트는 프레임워크를 업그레이드하지 않고도 이를 채택할 수 있습니다. 대체 설치 방법 -- 예를 들어 NuGet UI 또는 CLI -- 에 대해서는 IronXL 설치 가이드를 참조하세요.

JavaScript 다운로드 도우미 추가

Blazor 서버는 서버 측에서 실행되므로 파일 다운로드를 트리거하는 데는 작은 JavaScript 브리지가 필요합니다. 파일 excelExport.js를 wwwroot 폴더에 추가하십시오:

window.downloadFileFromStream = async (fileName, contentStreamReference) => {
    const arrayBuffer = await contentStreamReference.arrayBuffer();
    const blob = new Blob([arrayBuffer]);
    const url = URL.createObjectURL(blob);
    const anchorElement = document.createElement('a');
    anchorElement.href = url;
    anchorElement.download = fileName ?? 'export.xlsx';
    anchorElement.click();
    anchorElement.remove();
    URL.revokeObjectURL(url);
}

window.downloadFileFromStream = async (fileName, contentStreamReference) => {
    const arrayBuffer = await contentStreamReference.arrayBuffer();
    const blob = new Blob([arrayBuffer]);
    const url = URL.createObjectURL(blob);
    const anchorElement = document.createElement('a');
    anchorElement.href = url;
    anchorElement.download = fileName ?? 'export.xlsx';
    anchorElement.click();
    anchorElement.remove();
    URL.revokeObjectURL(url);
}

이 스크립트를 _Host.cshtml 파일에 포함하십시오 (또는 .NET 8+에서는 App.razor에 포함):

<script src="~/excelExport.js"></script>

<script src="~/excelExport.js"></script>

이 함수는 Blazor로부터 바이트 스트림을 임시 블롭 URL로 변환하고, 브라우저 다운로드를 트리거한 후 메모리 누수를 방지하기 위해 URL 객체를 정리합니다. 의도적으로 최소화되었습니다 -- 서버에서 C#에서의 많은 작업이 일어납니다.

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

무료로 시작하세요

ExcelExportService 만들기

새 파일 Services/ExcelExportService.cs를 생성하십시오:

using IronXL;
using System.IO;
using ExportExcel.Models;

public class ExcelExportService
{
    public byte[] GenerateSalesReport(List<SalesData> salesData)
    {
        var workbook = WorkBook.Create(ExcelFileFormat.XLSX);
        workbook.Metadata.Author = "Sales Department";

        var worksheet = workbook.CreateWorkSheet("Monthly Sales");

        // Add column headers
        worksheet["A1"].Value = "Date";
        worksheet["B1"].Value = "Product";
        worksheet["C1"].Value = "Quantity";
        worksheet["D1"].Value = "Revenue";
        worksheet["E1"].Value = "Profit Margin";

        // Style the header row
        var headerRange = worksheet["A1:E1"];
        headerRange.Style.Font.Bold = true;
        headerRange.Style.BackgroundColor = "#4472C4";
        headerRange.Style.Font.Color = "#FFFFFF";

        // Populate data rows
        int row = 2;
        foreach (var sale in salesData)
        {
            worksheet[$"A{row}"].Value = sale.Date.ToString("yyyy-MM-dd");
            worksheet[$"B{row}"].Value = sale.Product ?? "Unknown";
            worksheet[$"C{row}"].Value = sale.Quantity;
            worksheet[$"D{row}"].Value = sale.Revenue;
            worksheet[$"E{row}"].Value = $"=D{row}*0.15";
            row++;
        }

        worksheet.AutoSizeColumn(0, true);

        using var ms = workbook.ToStream();
        return ms.ToArray();
    }
}

using IronXL;
using System.IO;
using ExportExcel.Models;

public class ExcelExportService
{
    public byte[] GenerateSalesReport(List<SalesData> salesData)
    {
        var workbook = WorkBook.Create(ExcelFileFormat.XLSX);
        workbook.Metadata.Author = "Sales Department";

        var worksheet = workbook.CreateWorkSheet("Monthly Sales");

        // Add column headers
        worksheet["A1"].Value = "Date";
        worksheet["B1"].Value = "Product";
        worksheet["C1"].Value = "Quantity";
        worksheet["D1"].Value = "Revenue";
        worksheet["E1"].Value = "Profit Margin";

        // Style the header row
        var headerRange = worksheet["A1:E1"];
        headerRange.Style.Font.Bold = true;
        headerRange.Style.BackgroundColor = "#4472C4";
        headerRange.Style.Font.Color = "#FFFFFF";

        // Populate data rows
        int row = 2;
        foreach (var sale in salesData)
        {
            worksheet[$"A{row}"].Value = sale.Date.ToString("yyyy-MM-dd");
            worksheet[$"B{row}"].Value = sale.Product ?? "Unknown";
            worksheet[$"C{row}"].Value = sale.Quantity;
            worksheet[$"D{row}"].Value = sale.Revenue;
            worksheet[$"E{row}"].Value = $"=D{row}*0.15";
            row++;
        }

        worksheet.AutoSizeColumn(0, true);

        using var ms = workbook.ToStream();
        return ms.ToArray();
    }
}

서비스 등록하기

서비스를 Program.cs의 DI 컨테이너에 추가하십시오:

var builder = WebApplication.CreateBuilder(args);

builder.Services.AddRazorPages();
builder.Services.AddServerSideBlazor();
builder.Services.AddScoped<ExcelExportService>();

var app = builder.Build();
app.MapBlazorHub();
app.MapFallbackToPage("/_Host");
app.Run();

var builder = WebApplication.CreateBuilder(args);

builder.Services.AddRazorPages();
builder.Services.AddServerSideBlazor();
builder.Services.AddScoped<ExcelExportService>();

var app = builder.Build();
app.MapBlazorHub();
app.MapFallbackToPage("/_Host");
app.Run();

이 서비스는 여러 가지 주요 IronXL 기능을 보여줍니다. 새로운 워크북과 워크시트 생성을 단일 메서드 호출로 수행하고, 스타일 적용된 헤더를 추가하며, 모든 데이터 소스에서 행을 채우고, =D2*0.15 같은 Excel 수식을 내장할 수 있습니다. AutoSizeColumn 호출은 데이터 길이에 상관없이 열의 내용이 제대로 표시되도록 충분히 넓게 설정합니다. 추가 포맷 옵션에 대해서는 셀 스타일링 가이드를 참조하세요.

Razor 구성 요소 작성

페이지를 Pages/ExcelExportDashboard.razor에 생성하십시오:

@page "/excel-export"
@using ExportExcel.Models
@inject ExcelExportService ExcelService
@inject IJSRuntime JS

<h3>Excel Export Dashboard</h3>

<div class="export-section">
    <button class="btn btn-primary" @onclick="ExportSalesReport" disabled="@isExporting">
        @if (isExporting)
        {
            <span>Generating...</span>
        }
        else
        {
            <span>Export Sales Report</span>
        }
    </button>

    @if (!string.IsNullOrEmpty(errorMessage))
    {
        <div class="alert alert-danger mt-2">@errorMessage</div>
    }
</div>

@code {
    private bool isExporting = false;
    private string errorMessage = "";

    private async Task ExportSalesReport()
    {
        try
        {
            isExporting = true;
            errorMessage = "";

            var salesData = GetSalesData();
            var fileBytes = ExcelService.GenerateSalesReport(salesData);

            using var stream = new MemoryStream(fileBytes);
            using var streamRef = new DotNetStreamReference(stream);
            await JS.InvokeVoidAsync(
                "downloadFileFromStream",
                $"SalesReport_{DateTime.Now:yyyyMMdd}.xlsx",
                streamRef
            );
        }
        catch (Exception)
        {
            errorMessage = "Export failed. Please try again.";
        }
        finally
        {
            isExporting = false;
        }
    }

    private List<SalesData> GetSalesData()
    {
        return new List<SalesData>
        {
            new() { Date = DateTime.Now, Product = "Widget A", Quantity = 100, Revenue = 5000 },
            new() { Date = DateTime.Now.AddDays(-1), Product = "Widget B", Quantity = 75, Revenue = 3750 }
        };
    }
}

@page "/excel-export"
@using ExportExcel.Models
@inject ExcelExportService ExcelService
@inject IJSRuntime JS

<h3>Excel Export Dashboard</h3>

<div class="export-section">
    <button class="btn btn-primary" @onclick="ExportSalesReport" disabled="@isExporting">
        @if (isExporting)
        {
            <span>Generating...</span>
        }
        else
        {
            <span>Export Sales Report</span>
        }
    </button>

    @if (!string.IsNullOrEmpty(errorMessage))
    {
        <div class="alert alert-danger mt-2">@errorMessage</div>
    }
</div>

@code {
    private bool isExporting = false;
    private string errorMessage = "";

    private async Task ExportSalesReport()
    {
        try
        {
            isExporting = true;
            errorMessage = "";

            var salesData = GetSalesData();
            var fileBytes = ExcelService.GenerateSalesReport(salesData);

            using var stream = new MemoryStream(fileBytes);
            using var streamRef = new DotNetStreamReference(stream);
            await JS.InvokeVoidAsync(
                "downloadFileFromStream",
                $"SalesReport_{DateTime.Now:yyyyMMdd}.xlsx",
                streamRef
            );
        }
        catch (Exception)
        {
            errorMessage = "Export failed. Please try again.";
        }
        finally
        {
            isExporting = false;
        }
    }

    private List<SalesData> GetSalesData()
    {
        return new List<SalesData>
        {
            new() { Date = DateTime.Now, Product = "Widget A", Quantity = 100, Revenue = 5000 },
            new() { Date = DateTime.Now.AddDays(-1), Product = "Widget B", Quantity = 75, Revenue = 3750 }
        };
    }
}

구성 요소가 하는 일

isExporting 플래그는 생성 중에 버튼을 비활성화하여 중복 요청을 방지합니다. DotNetStreamReference 래퍼는 .NET 메모리 스트림에서 JavaScript 함수로의 효율적 이진 스트리밍 처리를 담당하며, 페이로드 크기를 부풀리는 큰 base64 문자열을 피합니다. SalesReport_20260228.xlsx와 같은 타임스탬프된 파일명은 추가 설정 없이 다운로드를 정리됩니다.

브라우저에서 /excel-export로 이동하면 대시보드 페이지가 내보내기 버튼과 함께 로드됩니다:

버튼을 클릭하면 스프레드시트가 생성되고 브라우저가 자동으로 파일을 다운로드합니다:

인벤토리 보고서를 위한 조건부 서식

다음 서비스는 재고 부족 항목을 빨간색으로 강조 표시하여 창고 또는 인벤토리 관리 응용 프로그램의 일반적인 요구 사항을 충족시킵니다:

using IronXL;
using ExportExcel.Models;
using System.IO;

public class InventoryExportService
{
    public byte[] GenerateInventoryReport(List<InventoryItem> items)
    {
        var workbook = WorkBook.Create();
        var details = workbook.CreateWorkSheet("Inventory Details");

        // Column headers
        details["A1"].Value = "SKU";
        details["B1"].Value = "Name";
        details["C1"].Value = "Quantity";
        details["D1"].Value = "Reorder Level";
        details["E1"].Value = "Status";

        var headerRange = details["A1:E1"];
        headerRange.Style.Font.Bold = true;
        headerRange.Style.BackgroundColor = "#2E75B6";
        headerRange.Style.Font.Color = "#FFFFFF";

        for (int i = 0; i < items.Count; i++)
        {
            int row = i + 2;
            var item = items[i];

            details[$"A{row}"].Value = item.SKU;
            details[$"B{row}"].Value = item.Name;
            details[$"C{row}"].Value = item.Quantity;
            details[$"D{row}"].Value = item.ReorderLevel;
            details[$"E{row}"].Value = item.Quantity < item.ReorderLevel
                ? "Reorder Required"
                : "OK";

            if (item.Quantity < item.ReorderLevel)
            {
                // Highlight the entire row for low-stock items
                details[$"A{row}:E{row}"].Style.BackgroundColor = "#FFB6B6";
                details[$"C{row}"].Style.Font.Bold = true;
            }
        }

        details.AutoSizeColumn(0, true);
        details.AutoSizeColumn(1, true);

        using var stream = workbook.ToStream();
        return stream.ToArray();
    }
}

using IronXL;
using ExportExcel.Models;
using System.IO;

public class InventoryExportService
{
    public byte[] GenerateInventoryReport(List<InventoryItem> items)
    {
        var workbook = WorkBook.Create();
        var details = workbook.CreateWorkSheet("Inventory Details");

        // Column headers
        details["A1"].Value = "SKU";
        details["B1"].Value = "Name";
        details["C1"].Value = "Quantity";
        details["D1"].Value = "Reorder Level";
        details["E1"].Value = "Status";

        var headerRange = details["A1:E1"];
        headerRange.Style.Font.Bold = true;
        headerRange.Style.BackgroundColor = "#2E75B6";
        headerRange.Style.Font.Color = "#FFFFFF";

        for (int i = 0; i < items.Count; i++)
        {
            int row = i + 2;
            var item = items[i];

            details[$"A{row}"].Value = item.SKU;
            details[$"B{row}"].Value = item.Name;
            details[$"C{row}"].Value = item.Quantity;
            details[$"D{row}"].Value = item.ReorderLevel;
            details[$"E{row}"].Value = item.Quantity < item.ReorderLevel
                ? "Reorder Required"
                : "OK";

            if (item.Quantity < item.ReorderLevel)
            {
                // Highlight the entire row for low-stock items
                details[$"A{row}:E{row}"].Style.BackgroundColor = "#FFB6B6";
                details[$"C{row}"].Style.Font.Bold = true;
            }
        }

        details.AutoSizeColumn(0, true);
        details.AutoSizeColumn(1, true);

        using var stream = workbook.ToStream();
        return stream.ToArray();
    }
}

IronXL은 생성 시점에서 데이터 값에 따라 셀 수준 포맷을 적용합니다. 조건부 서식 규칙을 선언적으로 적용하거나 같은 워크북 내에서 여러 워크시트를 관리할 수 있습니다. 예를 들어, 하나의 시트는 현재 재고를, 다른 시트는 과거 주문을 위한 것입니다.

단일 내보내기에 여러 워크시트 추가

데이터를 논리적인 시트로 나누면 개별 다운로드 없이 가독성을 향상시킵니다:

public byte[] GenerateMultiSheetReport(
    List<SalesData> sales,
    List<InventoryItem> inventory)
{
    var workbook = WorkBook.Create(ExcelFileFormat.XLSX);

    // Sheet 1 -- Sales summary
    var salesSheet = workbook.CreateWorkSheet("Sales");
    salesSheet["A1"].Value = "Date";
    salesSheet["B1"].Value = "Revenue";
    salesSheet["A1:B1"].Style.Font.Bold = true;

    for (int i = 0; i < sales.Count; i++)
    {
        salesSheet[$"A{i + 2}"].Value = sales[i].Date.ToString("yyyy-MM-dd");
        salesSheet[$"B{i + 2}"].Value = sales[i].Revenue;
    }

    // Sheet 2 -- Inventory snapshot
    var invSheet = workbook.CreateWorkSheet("Inventory");
    invSheet["A1"].Value = "SKU";
    invSheet["B1"].Value = "Name";
    invSheet["C1"].Value = "Quantity";
    invSheet["A1:C1"].Style.Font.Bold = true;

    for (int i = 0; i < inventory.Count; i++)
    {
        invSheet[$"A{i + 2}"].Value = inventory[i].SKU;
        invSheet[$"B{i + 2}"].Value = inventory[i].Name;
        invSheet[$"C{i + 2}"].Value = inventory[i].Quantity;
    }

    using var stream = workbook.ToStream();
    return stream.ToArray();
}

public byte[] GenerateMultiSheetReport(
    List<SalesData> sales,
    List<InventoryItem> inventory)
{
    var workbook = WorkBook.Create(ExcelFileFormat.XLSX);

    // Sheet 1 -- Sales summary
    var salesSheet = workbook.CreateWorkSheet("Sales");
    salesSheet["A1"].Value = "Date";
    salesSheet["B1"].Value = "Revenue";
    salesSheet["A1:B1"].Style.Font.Bold = true;

    for (int i = 0; i < sales.Count; i++)
    {
        salesSheet[$"A{i + 2}"].Value = sales[i].Date.ToString("yyyy-MM-dd");
        salesSheet[$"B{i + 2}"].Value = sales[i].Revenue;
    }

    // Sheet 2 -- Inventory snapshot
    var invSheet = workbook.CreateWorkSheet("Inventory");
    invSheet["A1"].Value = "SKU";
    invSheet["B1"].Value = "Name";
    invSheet["C1"].Value = "Quantity";
    invSheet["A1:C1"].Style.Font.Bold = true;

    for (int i = 0; i < inventory.Count; i++)
    {
        invSheet[$"A{i + 2}"].Value = inventory[i].SKU;
        invSheet[$"B{i + 2}"].Value = inventory[i].Name;
        invSheet[$"C{i + 2}"].Value = inventory[i].Quantity;
    }

    using var stream = workbook.ToStream();
    return stream.ToArray();
}

워크북 속성, 범위 연산 및 차트 지원을 다루는 전체 API 참조는 IronXL API 문서를 방문하십시오.

서비스 계층에서 오류 처리

생성 논리를 컴포넌트가 아닌 서비스에 래핑하면 모든 호출자에 대해 오류 처리를 일관되게 유지할 수 있습니다. 권장 패턴은 IronXL 예외를 전파시키고, 그런 다음 어떤 보고서가 실패했는지에 대한 컨텍스트를 갖춘 도메인 특화 예외로 래핑하는 것입니다.

워크북 생성을 GenerateSalesReport에서 try/catch 블록으로 감싸고, Exception를 잡고 InvalidOperationException("Failed to generate sales report", ex)로 재던지기하십시오. Blazor 구성 요소에서 InvalidOperationException를 잡고 내부 세부 사항을 노출하지 않고 사용자 친화적인 메시지를 표시하십시오. 서비스 생성자에 주입된 ILogger<t>를 사용하여 내부 예외를 기록하여 개발 팀이 특정 워크북 작업으로 실패를 추적할 수 있습니다. 원시 예외 메시지를 최종 사용자에게 노출하지 마십시오. - 파일 경로, 메모리 주소 또는 스택 트레이스가 서버 내부 사항을 드러낼 수 있습니다.

Blazor에서의 구조화된 오류 로깅에 대한 공식 Microsoft 문서의 오류 처리 모범 사례를 참조하십시오. .NET에서 테스트 가능한 서비스를 구축하는 데 대한 추가 안내는 Microsoft 종속성 주입 문서가 서비스 등록 및 스콥드 서비스 해결 방법을 설명하며, 이는 여기서 ExcelExportService으로 사용된 패턴입니다.

대용량 데이터셋에 대한 성능 고려사항

수천 개의 행을 초과하는 데이터셋의 경우 다음 접근 방식을 고려하십시오:

IronXL의 ToStream() 메서드는 처음부터 파일을 바이트 배열에 로드하지 않고 직접 출력 스트림으로 작성하므로 대형 워크북에 대한 메모리 사용량이 적습니다. 추가 성능 안내는 IronXL을 사용하여 큰 Excel 파일 읽기 및 쓰기를 참조하십시오.

수식, 이름 있는 범위, 숫자 서식

Excel 셀에 직접 입력하는 구문을 사용하여 모든 Excel 수식을 임베드할 수 있습니다. IronXL은 읽기 시점에 수식을 평가하므로, 생성된 파일의 사용자는 스프레드시트를 열자마자 계산된 결과를 볼 수 있습니다. 이름 있는 범위는 수식을 더 읽기 쉽고 유지 관리하기 쉽게 만듭니다:

// Aggregate formulas on a summary row
worksheet["E2"].Value = "=SUM(D2:D100)";
worksheet["F2"].Value = "=AVERAGE(C2:C100)";
worksheet["G2"].Value = "=COUNTIF(B2:B100,\"Widget A\")";

// Named ranges improve formula readability
worksheet["D2:D100"].Name = "RevenueColumn";
worksheet["E2"].Value = "=SUM(RevenueColumn)";

// Number and date formatting prevents type misinterpretation
worksheet["D2"].Value = 12345.67m;
worksheet["D2"].FormatString = "#,##0.00";
worksheet["A2"].Value = DateTime.Now;
worksheet["A2"].FormatString = "dd/MM/yyyy";

// Aggregate formulas on a summary row
worksheet["E2"].Value = "=SUM(D2:D100)";
worksheet["F2"].Value = "=AVERAGE(C2:C100)";
worksheet["G2"].Value = "=COUNTIF(B2:B100,\"Widget A\")";

// Named ranges improve formula readability
worksheet["D2:D100"].Name = "RevenueColumn";
worksheet["E2"].Value = "=SUM(RevenueColumn)";

// Number and date formatting prevents type misinterpretation
worksheet["D2"].Value = 12345.67m;
worksheet["D2"].FormatString = "#,##0.00";
worksheet["A2"].Value = DateTime.Now;
worksheet["A2"].FormatString = "dd/MM/yyyy";

이름 있는 범위 정의 및 숫자 서식을 명시적으로 설정하기 위해 IronXL은 범위 객체의 속성으로 둘 다 제공합니다. 이렇게 하면 데이터베이스에서 문자열로 값을 저장하는 경우 일반적으로 발생하는 금융 데이터 내보내기 시 통화 값을 일반 텍스트로 처리하지 않도록 방지합니다.

지원되는 Excel 파일 형식

IronXL은 .xlsx, .xls, .csv, .tsv을 포함한 여러 Excel 형식을 읽고 쓸 수 있습니다. 형식은 저장 시점에 결정되므로 동일한 서비스 클래스에서 Excel 및 CSV 내보내기를 작은 매개변수 변경으로 지원할 수 있습니다.

// Export as CSV for systems that consume flat files
workbook.SaveAs("report.csv");

// Or stream as CSV for download
using var ms = workbook.ToStream(ExcelFileFormat.CSV);

// Export as CSV for systems that consume flat files
workbook.SaveAs("report.csv");

// Or stream as CSV for download
using var ms = workbook.ToStream(ExcelFileFormat.CSV);

이 유연성은 특정 파일 형식을 기대하는 ERP 플랫폼이나 데이터 웨어하우스와 같은 다운스트림 시스템과의 통합에서 중요합니다. IronXL 및 다른 Excel 라이브러리 간의 전체 기능 비교를 보려면 IronXL 기능 페이지를 방문하세요.

Microsoft는 예상치 못한 출력 디버깅 시 .xlsx 파일의 내부 구조를 이해해야 할 경우 OOXML 파일 형식을 이해하는 데에 대한 좋은 참고자료를 제공합니다. IronXL의 NuGet 패키지는 NuGet.org에 전체 버전 기록 및 호환성 노트와 함께 나열되어 있습니다.