Read Excel Files in ASP.NET MVC Using C# with IronXL

왜 Visual Studio 2022가 가장 적합할까요?

Visual Studio 2022를 사용하여 새로운 ASP.NET 프로젝트를 만듭니다. Visual Studio 2022는 .NET 6+ 프레임워크에 대해 뛰어난 지원을 제공하며, IronXL 메서드에 대한 개선된 IntelliSense 및 대형 Excel 파일 작업 시 더 나은 성능을 제공합니다. IDE의 NuGet 통합은 IronXL 설치를 특히 간단하게 만듭니다.

어떤 프로젝트 템플릿을 선택해야 하나요?

ASP.NET에서 Excel 파일을 읽으려면 "ASP.NET Core Web App (Model-View-Controller)" 템플릿을 선택하십시오. 이 템플릿은 데이터 처리(Excel 읽기)와 표현 로직을 분리하는 깔끔한 MVC 구조를 제공합니다. MVC 패턴은 IronXL의 DataTable 변환과 완벽하게 함께 작동하며, 컨트롤러에서 스프레드시트를 로드하고 뷰에 원활하게 표시할 수 있습니다.

어떤 .NET 버전을 추천하나요?

IronXL는 .NET Framework 4.6.2+ 및 .NET Core 3.1+와 호환됩니다. 새로운 ASP.NET MVC 프로젝트의 경우, 최적의 성능과 보안을 위해 .NET 6.0 이상을 사용하십시오. 이러한 버전은 대용량 Excel 파일을 처리할 때 개선된 메모리 관리와 스프레드시트 파일 형식 변환을 위한 더 나은 async/await 지원을 제공합니다.

설치 요구 사항은 무엇입니까?

어떤 설치 방법이 가장 빠른가요?

새 프로젝트를 생성한 후 IronXL 라이브러리를 설치하십시오. 다음 단계에 따라 IronXL를 설치하세요. NuGet 패키지 관리자 콘솔을 열고 다음 명령어를 실행하십시오:

Install-Package IronXl.Excel

설치를 어떻게 확인할 수 있나요?

IronXL가 제대로 설치되었는지 확인하려면 솔루션 탐색기에서 프로젝트의 종속성을 확인하세요. "Dependencies > Packages" 아래에 "IronXL"이 표시되어야 합니다. 또한, 컨트롤러 파일 상단에 using IronXL;를 추가해 보십시오 - IntelliSense가 네임스페이스를 즉시 인식해야 합니다. 설치 문제 해결에 대한 내용은 라이선스 가이드를 방문하십시오.

컨트롤러 액션에 어떤 코드가 들어가나요?

ASP.NET 프로젝트의 기본 컨트롤러(e.g., HomeController.cs)를 열어 Index 메서드를 다음 코드로 대체하세요:

using IronXL;
using System.Data;

public ActionResult Index()
{
    // Load the Excel workbook from a specified path.
    WorkBook workBook = WorkBook.Load(@"C:\Files\Customer Data.xlsx");

    // Access the first worksheet from the workbook.
    WorkSheet workSheet = workBook.WorkSheets.First();

    // Convert the worksheet data to a DataTable object.
    // The 'true' parameter uses the first row as column headers
    var dataTable = workSheet.ToDataTable(true);

    // Send the DataTable to the view for rendering.
    return View(dataTable);
}

using IronXL;
using System.Data;

public ActionResult Index()
{
    // Load the Excel workbook from a specified path.
    WorkBook workBook = WorkBook.Load(@"C:\Files\Customer Data.xlsx");

    // Access the first worksheet from the workbook.
    WorkSheet workSheet = workBook.WorkSheets.First();

    // Convert the worksheet data to a DataTable object.
    // The 'true' parameter uses the first row as column headers
    var dataTable = workSheet.ToDataTable(true);

    // Send the DataTable to the view for rendering.
    return View(dataTable);
}

다른 형식 대신 DataTable을 사용하는 이유는 무엇인가요?

Index 액션 메서드에서, IronXL의 Load 메서드를 사용하여 Excel 파일을 로드합니다. Excel 파일의 경로(파일명 포함)는 메서드 호출의 매개변수로 제공됩니다. 다음으로, 첫 번째 Excel 시트를 작업 시트로 선택하고 그 안에 포함된 데이터를 DataTable 객체에 로드합니다. 마지막으로, DataTable를 프론트엔드로 전송합니다.

DataTable는 Razor 뷰와 원활하게 통합되며 행과 열을 반복하는 데 내장된 지원을 제공하기 때문에 ASP.NET MVC에 이상적입니다. 커스텀 객체와 달리, DataTable는 모델 매핑이 필요하지 않으며 복합 데이터 유형을 자동으로 처리합니다. 필요할 때 DataSet와 DataTable를 다시 Excel로 내보낼 수도 있습니다.

누락된 파일에 대한 오류 처리는 어떻게 해야 하나요?

견고한 오류 처리는 Excel 파일이 누락되거나 손상되었을 때 애플리케이션이 중단되지 않도록 보장합니다. 다음은 적절한 예외 처리가 있는 향상된 버전입니다:

public ActionResult Index()
{
    try
    {
        string filePath = @"C:\Files\Customer Data.xlsx";

        // Check if file exists before attempting to load
        if (!System.IO.File.Exists(filePath))
        {
            ViewBag.Error = "Excel file not found at specified location.";
            return View(new DataTable());
        }

        // Load workbook with error handling
        WorkBook workBook = WorkBook.Load(filePath);

        // Verify worksheet exists
        if (workBook.WorkSheets.Count == 0)
        {
            ViewBag.Error = "No worksheets found in the Excel file.";
            return View(new DataTable());
        }

        WorkSheet workSheet = workBook.WorkSheets.First();
        var dataTable = workSheet.ToDataTable(true);

        return View(dataTable);
    }
    catch (Exception ex)
    {
        // Log the exception (consider using a logging framework)
        ViewBag.Error = $"Error reading Excel file: {ex.Message}";
        return View(new DataTable());
    }
}

public ActionResult Index()
{
    try
    {
        string filePath = @"C:\Files\Customer Data.xlsx";

        // Check if file exists before attempting to load
        if (!System.IO.File.Exists(filePath))
        {
            ViewBag.Error = "Excel file not found at specified location.";
            return View(new DataTable());
        }

        // Load workbook with error handling
        WorkBook workBook = WorkBook.Load(filePath);

        // Verify worksheet exists
        if (workBook.WorkSheets.Count == 0)
        {
            ViewBag.Error = "No worksheets found in the Excel file.";
            return View(new DataTable());
        }

        WorkSheet workSheet = workBook.WorkSheets.First();
        var dataTable = workSheet.ToDataTable(true);

        return View(dataTable);
    }
    catch (Exception ex)
    {
        // Log the exception (consider using a logging framework)
        ViewBag.Error = $"Error reading Excel file: {ex.Message}";
        return View(new DataTable());
    }
}

다른 워크시트를 선택하려면 어떻게 하나요?

IronXL는 특정 워크시트를 선택하고 작업하는 여러 방법을 제공합니다. 인덱스, 이름별로 워크시트에 접근하거나 사용 가능한 모든 시트를 반복할 수 있습니다:

// Method 1: Select by worksheet name
WorkSheet namedSheet = workBook.GetWorkSheet("Sales Data");

// Method 2: Select by index (zero-based)
WorkSheet secondSheet = workBook.WorkSheets[1];

// Method 3: Select the default/active worksheet
WorkSheet defaultSheet = workBook.DefaultWorkSheet;

// Method 4: Iterate through all worksheets
foreach (WorkSheet sheet in workBook.WorkSheets)
{
    string sheetName = sheet.Name;
    // Process each worksheet
}

// Method 1: Select by worksheet name
WorkSheet namedSheet = workBook.GetWorkSheet("Sales Data");

// Method 2: Select by index (zero-based)
WorkSheet secondSheet = workBook.WorkSheets[1];

// Method 3: Select the default/active worksheet
WorkSheet defaultSheet = workBook.DefaultWorkSheet;

// Method 4: Iterate through all worksheets
foreach (WorkSheet sheet in workBook.WorkSheets)
{
    string sheetName = sheet.Name;
    // Process each worksheet
}

어떤 뷰 코드가 필요합니까?

다음 예제는 이전 예제에서 반환된 DataTable를 웹 브라우저에 표시하는 방법을 보여줍니다.

이 예제에서 사용된 작업용 Excel 파일은 다음과 같습니다:

*Excel 파일*

index.cshtml (인덱스 보기)를 열고 코드를 다음 HTML 코드로 대체하십시오:

@{
    ViewData["Title"] = "Home Page";
}

@using System.Data
@model DataTable

<div class="text-center">
    <h1 class="display-4">Welcome to IronXL Read Excel MVC</h1>
</div>

@* Check for errors first *@
@if (ViewBag.Error != null)
{
    <div class="alert alert-danger">
        @ViewBag.Error
    </div>
}

@* Display table only if data exists *@
@if (Model != null && Model.Rows.Count > 0)
{
    <table class="table table-dark">
        <tbody>
            @foreach (DataRow row in Model.Rows)
            {
                <tr>
                    @for (int i = 0; i < Model.Columns.Count; i++)
                    {
                        <td>@row[i]</td>
                    }
                </tr>
            }
        </tbody>
    </table>
}
else
{
    <p>No data to display.</p>
}

@{
    ViewData["Title"] = "Home Page";
}

@using System.Data
@model DataTable

<div class="text-center">
    <h1 class="display-4">Welcome to IronXL Read Excel MVC</h1>
</div>

@* Check for errors first *@
@if (ViewBag.Error != null)
{
    <div class="alert alert-danger">
        @ViewBag.Error
    </div>
}

@* Display table only if data exists *@
@if (Model != null && Model.Rows.Count > 0)
{
    <table class="table table-dark">
        <tbody>
            @foreach (DataRow row in Model.Rows)
            {
                <tr>
                    @for (int i = 0; i < Model.Columns.Count; i++)
                    {
                        <td>@row[i]</td>
                    }
                </tr>
            }
        </tbody>
    </table>
}
else
{
    <p>No data to display.</p>
}

테이블 스타일링에 Bootstrap을 사용하는 이유는 무엇인가요?

위의 코드는 Index 메서드에서 반환된 DataTable를 모델로 사용합니다. 테이블의 각 행은 데코레이션용 Bootstrap 서식 포함하여 @for 루프를 사용하여 웹페이지에 출력됩니다.

Bootstrap은 다양한 화면 크기에 자동으로 맞춰지는 반응형 테이블 디자인을 제공하며, 이는 현대적인 웹 애플리케이션에 필수적입니다. table-dark 클래스는 읽기 쉬운 매력적인 어두운 테마 테이블을 생성합니다. 셀 테두리 및 정렬 또는 배경 패턴 및 색상과 같은 보다 고급 엑셀 서식을 위해 IronXL는 구조화된 데이터에 직접 접근할 수 있는 추가 메서드를 제공합니다.

최종 출력은 어떻게 보이나요?

프로젝트를 실행하면 아래에 표시된 결과가 생성됩니다:

*Bootstrap 테이블*

테이블에 헤더를 추가하려면 어떻게 하나요?

엑셀 파일에서 열 헤더를 표시하려면 보기 코드를 수정하여 테이블 헤더 섹션을 포함하십시오. ToDataTable(true)를 호출할 때, IronXL는 자동으로 첫 번째 행을 열 이름으로 사용합니다:

@if (Model != null && Model.Rows.Count > 0)
{
    <table class="table table-dark">
        <thead>
            <tr>
                @foreach (DataColumn column in Model.Columns)
                {
                    <th>@column.ColumnName</th>
                }
            </tr>
        </thead>
        <tbody>
            @foreach (DataRow row in Model.Rows)
            {
                <tr>
                    @for (int i = 0; i < Model.Columns.Count; i++)
                    {
                        <td>@row[i]</td>
                    }
                </tr>
            }
        </tbody>
    </table>
}

@if (Model != null && Model.Rows.Count > 0)
{
    <table class="table table-dark">
        <thead>
            <tr>
                @foreach (DataColumn column in Model.Columns)
                {
                    <th>@column.ColumnName</th>
                }
            </tr>
        </thead>
        <tbody>
            @foreach (DataRow row in Model.Rows)
            {
                <tr>
                    @for (int i = 0; i < Model.Columns.Count; i++)
                    {
                        <td>@row[i]</td>
                    }
                </tr>
            }
        </tbody>
    </table>
}

이 향상된 기능은 Excel 파일에서 '고객 이름', '배송 비용', '단가'와 같은 적절한 열 헤더를 표시합니다. 명명된 범위 또는 명명된 테이블을 포함한 더 복잡한 시나리오의 경우, IronXL는 구조화된 데이터에 직접 접근할 수 있는 추가 메서드를 제공합니다.