C# 리스트 객체를 엑셀로 내보내기

목록을 엑셀 파일로 내보내는 것은 왜 어려운가요?

데이터를 엑셀로 내보내는 전통적인 접근 방식은 종종 Microsoft Office Interop을 포함하여 서버에 MS 엑셀 설치가 필요하며 배포 문제를 야기합니다. 반사의 수동 셀별 채우기는 시간 소모적이며 오류가 발생하기 쉽습니다. IronXL의 데이터 가져오기 기능은 MS Office나 복잡한 반사 코드 없이 데이터 소스와 엑셀 열 헤더 간의 지능적인 속성 매핑으로 이러한 문제를 해결합니다.

라이브러리는 형식 변환을 자동으로 처리하고, 중첩 객체를 지원하며, CSV 파일 및 XLSX 파일과 같은 다양한 형식을 통해 데이터 무결성을 유지합니다. C# 엑셀 작업을 Interop 없이 수행하는 개발자에게 IronXL은 신뢰할 수 있는 엑셀 생성 및 데이터 가져오기/내보내기 기능이 필요한 현대 .NET 프로젝트에 이상적인 선택입니다.

IronXL은 어떻게 설치합니까?

IronXL을 시작하려면 최소한의 설정이 필요합니다. NuGet 패키지 관리자 콘솔을 통해 라이브러리를 설치하십시오:

Install-Package IronXL

Install-Package IronXL

또는 .NET CLI를 사용하세요:

dotnet add package IronXL

dotnet add package IronXL

설치가 완료되면, using IronXL; 지시문을 파일에 추가하십시오. 추가적인 Office 종속성이나 실행 환경 설치는 필요하지 않습니다.

간단한 목록을 엑셀로 내보내려면 어떻게 해야 하나요?

다음 예제는 .NET 10에서 선호되는 스타일인 최상위 수준 문을 사용하여 Employee 객체의 목록을 XLSX 파일로 내보내는 방법을 보여줍니다:

using IronXL;
using System.Data;

// Define the Employee model
record Employee(int Id, string Name, string Department, decimal Salary, DateTime HireDate);

// Create sample employee data
List<Employee> employees =
[
    new(1, "Alice Johnson", "Engineering", 95000, new DateTime(2020, 3, 15)),
    new(2, "Bob Smith",    "Marketing",   75000, new DateTime(2021, 7, 1)),
    new(3, "Carol Williams","Engineering",105000, new DateTime(2019, 11, 20))
];

// Build a DataTable from the list
DataTable dataTable = new();
dataTable.Columns.Add("Id",         typeof(int));
dataTable.Columns.Add("Name",       typeof(string));
dataTable.Columns.Add("Department", typeof(string));
dataTable.Columns.Add("Salary",     typeof(decimal));
dataTable.Columns.Add("HireDate",   typeof(DateTime));

foreach (var emp in employees)
    dataTable.Rows.Add(emp.Id, emp.Name, emp.Department, emp.Salary, emp.HireDate);

// Create an IronXL workbook and worksheet
WorkBook workbook  = new();
WorkSheet worksheet = workbook.CreateWorkSheet("Employees");

// Write headers
for (int col = 0; col < dataTable.Columns.Count; col++)
    worksheet.SetCellValue(0, col, dataTable.Columns[col].ColumnName);

// Write data rows
for (int row = 0; row < dataTable.Rows.Count; row++)
    for (int col = 0; col < dataTable.Columns.Count; col++)
        worksheet.SetCellValue(row + 1, col, dataTable.Rows[row][col]);

// Save as XLSX
workbook.SaveAs("EmployeeReport.xlsx");
Console.WriteLine("EmployeeReport.xlsx saved.");

using IronXL;
using System.Data;

// Define the Employee model
record Employee(int Id, string Name, string Department, decimal Salary, DateTime HireDate);

// Create sample employee data
List<Employee> employees =
[
    new(1, "Alice Johnson", "Engineering", 95000, new DateTime(2020, 3, 15)),
    new(2, "Bob Smith",    "Marketing",   75000, new DateTime(2021, 7, 1)),
    new(3, "Carol Williams","Engineering",105000, new DateTime(2019, 11, 20))
];

// Build a DataTable from the list
DataTable dataTable = new();
dataTable.Columns.Add("Id",         typeof(int));
dataTable.Columns.Add("Name",       typeof(string));
dataTable.Columns.Add("Department", typeof(string));
dataTable.Columns.Add("Salary",     typeof(decimal));
dataTable.Columns.Add("HireDate",   typeof(DateTime));

foreach (var emp in employees)
    dataTable.Rows.Add(emp.Id, emp.Name, emp.Department, emp.Salary, emp.HireDate);

// Create an IronXL workbook and worksheet
WorkBook workbook  = new();
WorkSheet worksheet = workbook.CreateWorkSheet("Employees");

// Write headers
for (int col = 0; col < dataTable.Columns.Count; col++)
    worksheet.SetCellValue(0, col, dataTable.Columns[col].ColumnName);

// Write data rows
for (int row = 0; row < dataTable.Rows.Count; row++)
    for (int col = 0; col < dataTable.Columns.Count; col++)
        worksheet.SetCellValue(row + 1, col, dataTable.Rows[row][col]);

// Save as XLSX
workbook.SaveAs("EmployeeReport.xlsx");
Console.WriteLine("EmployeeReport.xlsx saved.");

이 예제는 List<Employee>를 DataTable로 변환한 다음, IronXL 워크시트에 헤더와 행을 씁니다. IronXL은 int, string 및 DateTime와 같은 데이터 유형을 자동으로 처리하여 생성된 스프레드시트의 깔끔한 형식을 보장합니다. 엑셀 저장 함수는 모든 스프레드시트 애플리케이션에서 열 수 있는 XLSX 파일을 생성합니다.

복잡한 비즈니스 개체를 어떻게 내보내나요?

실제 .NET 애플리케이션은 종종 더 복잡한 데이터 구조를 포함합니다. 다음 예제는 계산 속성이 있는 제품 재고 보고서를 생성합니다:

using IronXL;
using System.Data;

// Define the Product model with a computed property
record Product(
    string SKU,
    string ProductName,
    string Category,
    decimal Price,
    int StockLevel,
    bool IsActive,
    DateTime LastRestocked)
{
    public decimal CalculatedValue => Price * StockLevel;
}

// Build the product list
List<Product> products =
[
    new("TECH-001", "Wireless Mouse",      "Electronics",     29.99m, 150, true,  DateTime.Now.AddDays(-5)),
    new("TECH-002", "Mechanical Keyboard", "Electronics",     89.99m,  75, true,  DateTime.Now.AddDays(-12)),
    new("OFF-001",  "Desk Organizer",      "Office Supplies", 15.99m,   0, false, DateTime.Now.AddMonths(-1))
];

// Populate a DataTable
DataTable dt = new();
dt.Columns.Add("SKU",             typeof(string));
dt.Columns.Add("ProductName",     typeof(string));
dt.Columns.Add("Category",        typeof(string));
dt.Columns.Add("Price",           typeof(decimal));
dt.Columns.Add("StockLevel",      typeof(int));
dt.Columns.Add("IsActive",        typeof(bool));
dt.Columns.Add("LastRestocked",   typeof(DateTime));
dt.Columns.Add("CalculatedValue", typeof(decimal));

foreach (var p in products)
    dt.Rows.Add(p.SKU, p.ProductName, p.Category, p.Price,
                p.StockLevel, p.IsActive, p.LastRestocked, p.CalculatedValue);

// Create the workbook
WorkBook  wb = WorkBook.Create();
WorkSheet ws = wb.CreateWorkSheet("Inventory");

// Write column headers
string[] headers = ["SKU","ProductName","Category","Price",
                    "StockLevel","IsActive","LastRestocked","CalculatedValue"];
for (int col = 0; col < headers.Length; col++)
    ws.SetCellValue(0, col, headers[col]);

// 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]);

// Auto-size columns for readability
for (int col = 0; col < headers.Length; col++)
    ws.AutoSizeColumn(col);

wb.SaveAs("ProductInventory.xlsx");
Console.WriteLine("ProductInventory.xlsx saved.");

using IronXL;
using System.Data;

// Define the Product model with a computed property
record Product(
    string SKU,
    string ProductName,
    string Category,
    decimal Price,
    int StockLevel,
    bool IsActive,
    DateTime LastRestocked)
{
    public decimal CalculatedValue => Price * StockLevel;
}

// Build the product list
List<Product> products =
[
    new("TECH-001", "Wireless Mouse",      "Electronics",     29.99m, 150, true,  DateTime.Now.AddDays(-5)),
    new("TECH-002", "Mechanical Keyboard", "Electronics",     89.99m,  75, true,  DateTime.Now.AddDays(-12)),
    new("OFF-001",  "Desk Organizer",      "Office Supplies", 15.99m,   0, false, DateTime.Now.AddMonths(-1))
];

// Populate a DataTable
DataTable dt = new();
dt.Columns.Add("SKU",             typeof(string));
dt.Columns.Add("ProductName",     typeof(string));
dt.Columns.Add("Category",        typeof(string));
dt.Columns.Add("Price",           typeof(decimal));
dt.Columns.Add("StockLevel",      typeof(int));
dt.Columns.Add("IsActive",        typeof(bool));
dt.Columns.Add("LastRestocked",   typeof(DateTime));
dt.Columns.Add("CalculatedValue", typeof(decimal));

foreach (var p in products)
    dt.Rows.Add(p.SKU, p.ProductName, p.Category, p.Price,
                p.StockLevel, p.IsActive, p.LastRestocked, p.CalculatedValue);

// Create the workbook
WorkBook  wb = WorkBook.Create();
WorkSheet ws = wb.CreateWorkSheet("Inventory");

// Write column headers
string[] headers = ["SKU","ProductName","Category","Price",
                    "StockLevel","IsActive","LastRestocked","CalculatedValue"];
for (int col = 0; col < headers.Length; col++)
    ws.SetCellValue(0, col, headers[col]);

// 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]);

// Auto-size columns for readability
for (int col = 0; col < headers.Length; col++)
    ws.AutoSizeColumn(col);

wb.SaveAs("ProductInventory.xlsx");
Console.WriteLine("ProductInventory.xlsx saved.");

이 코드는 SKU, 가격, 재고수준 및 재입고 날짜 등의 세부정보를 포함하는 Product 객체 목록을 만든 다음, 각 항목에 대한 파생 CalculatedValue를 계산합니다. IronXL은 소수, 부울, 날짜와 같은 데이터 유형을 처리하며, 전문 스프레드시트 출력을 보장합니다. 결과 ProductInventory.xlsx는 비즈니스 보고 또는 분석에 적합한 깔끔하고 데이터 중심의 인벤토리 내보내기를 제공합니다. 또한, 기존 코드베이스가 이미 DataTable 객체와 함께 작동하는 경우, DataTable을 Excel로 직접 내보낼 수 있습니다.

전문적인 포맷팅을 어떻게 추가하나요?

포맷팅은 기본 내보내기를 세련된 보고서로 변환합니다. IronXL의 스타일링 API는 모든 셀이나 범위에 대해 글꼴, 색상, 테두리 및 숫자 형식 설정을 제공합니다:

using IronXL;

WorkBook  wb = WorkBook.Load("ProductInventory.xlsx");
WorkSheet ws = wb.DefaultWorkSheet;

// Bold header row with a blue background and white text
Range headerRange = ws["A1:H1"];
headerRange.Style.Font.Bold            = true;
headerRange.Style.BackgroundColor      = "#4472C4";
headerRange.Style.Font.Color           = "#FFFFFF";

// Format the Price column as currency
Range priceColumn = ws["D2:D100"];
priceColumn.Style.NumberFormat = "$#,##0.00";

// Highlight low-stock rows in red
for (int row = 2; row <= 4; row++)
{
    var stockCell = ws[$"E{row}"];
    if (stockCell.IntValue < 10)
        stockCell.Style.BackgroundColor = "#FF6B6B";
}

wb.SaveAs("FormattedInventory.xlsx");
Console.WriteLine("FormattedInventory.xlsx saved.");

using IronXL;

WorkBook  wb = WorkBook.Load("ProductInventory.xlsx");
WorkSheet ws = wb.DefaultWorkSheet;

// Bold header row with a blue background and white text
Range headerRange = ws["A1:H1"];
headerRange.Style.Font.Bold            = true;
headerRange.Style.BackgroundColor      = "#4472C4";
headerRange.Style.Font.Color           = "#FFFFFF";

// Format the Price column as currency
Range priceColumn = ws["D2:D100"];
priceColumn.Style.NumberFormat = "$#,##0.00";

// Highlight low-stock rows in red
for (int row = 2; row <= 4; row++)
{
    var stockCell = ws[$"E{row}"];
    if (stockCell.IntValue < 10)
        stockCell.Style.BackgroundColor = "#FF6B6B";
}

wb.SaveAs("FormattedInventory.xlsx");
Console.WriteLine("FormattedInventory.xlsx saved.");

이 스타일링 옵션들은 원시 데이터 내보내기를 임원 보고서로 변환합니다. 배경 색깔이 있는 굵은 헤더는 시각적 계층 구조를 만듭니다. 숫자 포맷팅은 통화 값을 올바르게 표시합니다. 조건부 서식은 재고 관리에 즉시 활용할 수 있도록 저재고 수준과 같은 중요한 비즈니스 메트릭을 강조 표시합니다. 고급 셀 포맷팅과 테두리 스타일에 대해 더 배우고 내보내기를 더 향상시킬 수 있습니다.

다른 파일 형식으로 목록을 어떻게 내보내나요?

IronXL은 XLSX에 제한되지 않습니다. 동일한 WorkBook 객체를 메서드 변경 한 번으로 몇 가지 형식으로 저장할 수 있습니다:

• XLSX -- 기본 최신 Excel 형식: workbook.SaveAs("output.xlsx")
• XLS -- 이전 Office 버전을 위한 레거시 Excel 형식
• CSV -- 데이터 파이프라인 호환성을 위한 쉼표로 구분된 값
• TSV -- 탭으로 구분된 값

CSV 형식으로 내보내면, 각 워크시트는 별도의 CSV 파일이 됩니다. 이는 IronXL이 최종 사용자 보고서뿐만 아니라 ETL 파이프라인, 데이터 과학 도구, 또는 타사 API에서 소비되는 중간 데이터 파일을 생성하기 위해 유용하게 합니다. DataGridView 데이터를 내보내기 -- Windows Forms 앱에서 일반적인 패턴 -- 를 위해 IronXL은 추가 어댑터를 요구하지 않고도 쉽게 적용됩니다.

ASP.NET Core에서 목록을 Excel로 내보내는 방법은?

웹 API 또는 Razor Pages 애플리케이션을 빌드할 때, 일반적으로 Excel 파일을 디스크에 저장하는 대신 HTTP 응답으로 반환하는 것이 좋습니다. 아래 패턴은 컨트롤러 액션에서 FileContentResult을 반환합니다:

컨트롤러는 WorkBook를 빌드하고, workbook.ToByteArray()를 호출하며, 그런 다음 MIME 타입 application/vnd.openxmlformats-officedocument.spreadsheetml.sheet와 Content-Disposition: attachment 헤더로 바이트를 반환하는 서비스를 주입합니다. 이 접근 방식은 .NET 10 최소 API 또는 MVC 컨트롤러에서 작동합니다.

완전한 워크스루는 ASP.NET Core Excel 내보내기 튜토리얼 및 Blazor WebAssembly 또는 Blazor 서버 애플리케이션을 빌드하는 경우 Blazor 내보내기 튜토리얼을 참조하세요.

오늘 IronXL로 시작하는 방법은?

IronXL은 Excel 생성 작업을 유지 가능한 코드로 변환합니다. 그의 API는 Microsoft Office 종속성을 제거하면서 Enterprise 요구사항을 충족하는 전문적인 결과를 제공합니다. 라이브러리의 기능 세트는 기본 목록 내보내기부터 스타일링 및 포맷이 있는 복잡한 데이터 변환까지 모든 것을 처리합니다.

IronXL을 사용하여 기존 워크북을 읽고 편집하거나, 추가 처리용으로 Excel 데이터를 DataTable로 내보내기 또는 요약 보고용으로 피벗 테이블 생성을 할 수 있습니다. 위에 표시된 포맷 옵션과 결합하여 배포 전에 수동 조정이 필요 없는 스프레드시트를 생성할 수 있습니다.

IronXL은 NuGet에서 사용할 수 있으며, .NET 10, .NET 8 또는 .NET Framework 4.6.2 이상의 프로젝트와 함께 작동합니다. Open XML SDK는 IronXL이 읽고 쓰는 XLSX 파일 형식의 기반을 이루며, 이로 인해 생성된 파일이 ECMA-376 표준을 준수하고 모든 OOXML 호환 애플리케이션에서 올바르게 열릴 수 있도록 보장합니다.

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

무료로 시작하세요

C# 목록을 Excel로 내보낼 준비가 되셨나요? 지금 IronXL을 다운로드하세요와 함께 .NET 애플리케이션에서 목록 객체를 빠르게 Excel로 변환할 수 있는 경험을 해보세요. 실행 환경 배포를 위해, 유연한 라이선스 옵션을 탐색하여 필요에 맞게 확장해보세요. 문서를 방문하여 더 많은 튜토리얼과 예제를 확인하세요.