Untitled Blog Post

IronXL이란 무엇이며 왜 Excel 파일 생성에 사용해야 할까요?

IronXL은 .NET Excel 라이브러리로 개발자가 Excel을 만들거나, Excel 스프레드시트를 읽거나, C# 또는 Visual Basic 소스 코드에서 직접 Excel 파일을 조작할 수 있게 합니다. Microsoft Office Interop 접근 방식이 전체 Excel 애플리케이션에 의존하거나 Open XML SDK를 통한 역설계와 달리, IronXL은 Excel 설치 또는 타사 종속성 없이 Windows, Linux, macOS 및 클라우드 환경 전반에서 작동합니다. 이것은 서버 측 Excel 보고서, 자동화된 워크플로우, .NET Core 또는 .NET Framework에서 구축된 웹 응용 프로그램에 이상적입니다.

수동 Excel 프로세스, 오래된 라이브러리 또는 다양한 XML 네임스페이스를 탐색해야 하는 Open XML 생산성 도구 워크플로우에서 전환하는 팀에게 IronXL은 직관적인 API를 제공합니다. 이는 XML 파일과 다양한 폴더를 포함하는 ZIP 파일인 현대 XLSX 파일과 레거시 XLS 파일을 모두 지원합니다. 새 Excel 워크북 생성, 여러 워크시트 조작, 외부 코드에서 Excel 데이터를 로드하는 것 등 IronXL은 기본 형식을 이해할 필요 없이 과정을 크게 단순화합니다.

Excel 파일 생성을 위한 IronXL 시작하기

Excel 보고서를 생성하기 위한 IronXL 설정은 몇 분이면 완료됩니다. Visual Studio의 NuGet 패키지 관리자를 통해 라이브러리를 설치하세요:

Install-Package IronXl.Excel

오늘 IronXL을 다운로드하고 Excel 보고서 생성을 자동화합니다.

설치 후 첫 번째 Excel 보고서를 생성하는 데는 몇 줄의 코드만 필요합니다:

using IronXL;
// Create a new Excel workbook for reports
WorkBook workBook = WorkBook.Create(ExcelFileFormat.XLSX);
// Add a worksheet for the report
WorkSheet reportSheet = workBook.CreateWorkSheet("Monthly Report");
// Add a title
reportSheet["A1"].Value = "Sales Report - January 2024";
reportSheet["A1"].Style.Font.Bold = true;
// Save the Excel report
workBook.SaveAs("MonthlyReport.xlsx");

using IronXL;
// Create a new Excel workbook for reports
WorkBook workBook = WorkBook.Create(ExcelFileFormat.XLSX);
// Add a worksheet for the report
WorkSheet reportSheet = workBook.CreateWorkSheet("Monthly Report");
// Add a title
reportSheet["A1"].Value = "Sales Report - January 2024";
reportSheet["A1"].Style.Font.Bold = true;
// Save the Excel report
workBook.SaveAs("MonthlyReport.xlsx");

이 코드는 형식화된 제목이 있는 새 Excel 보고서 파일을 생성합니다. 익숙한 셀 참조 구문 (reportSheet["A1"])을 사용하여 개발자가 수동으로 Excel 작업을 하는 것처럼 데이터가 정확히 나타나도록 쉽게 지정할 수 있습니다.

여러 소스에서 데이터 로드하기

현실 세계의 Excel 보고서는 거의 정적 데이터를 사용하지 않습니다. IronXL은 다양한 형식, API, 새로운 DataTable 소스 또는 여러 XML 파일에서 Excel 데이터를 통합하는 데 탁월합니다. 이것은 서버 측 또는 웹 응용 프로그램에서 동적 C# Excel 보고서 생성에 완벽합니다.

using System.Data;
using System.Data.SqlClient;
// Fetch data from database
string connectionString = "Server=localhost;Database=Sales;Integrated Security=true;";
DataTable salesData = new DataTable();
using (SqlConnection conn = new SqlConnection(connectionString))
{
    SqlDataAdapter adapter = new SqlDataAdapter(
        "SELECT ProductName, Quantity, Revenue FROM MonthlySales", conn);
    adapter.Fill(salesData);
}
// Create Excel report from DataTable
WorkBook workBook = WorkBook.Create();
WorkSheet sheet = workBook.CreateWorkSheet("Sales Data");
// Add headers
sheet["A1"].Value = "Product";
sheet["B1"].Value = "Quantity";  
sheet["C1"].Value = "Revenue";
// Populate data
int row = 2;
foreach (DataRow dataRow in salesData.Rows)
{
    sheet[$"A{row}"].Value = dataRow["ProductName"];
    sheet[$"B{row}"].Value = dataRow["Quantity"];
    sheet[$"C{row}"].Value = dataRow["Revenue"];
    row++;
}

using System.Data;
using System.Data.SqlClient;
// Fetch data from database
string connectionString = "Server=localhost;Database=Sales;Integrated Security=true;";
DataTable salesData = new DataTable();
using (SqlConnection conn = new SqlConnection(connectionString))
{
    SqlDataAdapter adapter = new SqlDataAdapter(
        "SELECT ProductName, Quantity, Revenue FROM MonthlySales", conn);
    adapter.Fill(salesData);
}
// Create Excel report from DataTable
WorkBook workBook = WorkBook.Create();
WorkSheet sheet = workBook.CreateWorkSheet("Sales Data");
// Add headers
sheet["A1"].Value = "Product";
sheet["B1"].Value = "Quantity";  
sheet["C1"].Value = "Revenue";
// Populate data
int row = 2;
foreach (DataRow dataRow in salesData.Rows)
{
    sheet[$"A{row}"].Value = dataRow["ProductName"];
    sheet[$"B{row}"].Value = dataRow["Quantity"];
    sheet[$"C{row}"].Value = dataRow["Revenue"];
    row++;
}

var salesRecords = new List<SalesRecord>
{
    new SalesRecord { Product = "Widget A", Units = 150, Price = 29.99m },
    new SalesRecord { Product = "Widget B", Units = 82, Price = 49.99m }
};
// Convert collection to Excel
for (int i = 0; i < salesRecords.Count; i++)
{
    sheet[$"A{i+2}"].Value = salesRecords[i].Product;
    sheet[$"B{i+2}"].Value = salesRecords[i].Units;
    sheet[$"C{i+2}"].Value = salesRecords[i].Price;
}

var salesRecords = new List<SalesRecord>
{
    new SalesRecord { Product = "Widget A", Units = 150, Price = 29.99m },
    new SalesRecord { Product = "Widget B", Units = 82, Price = 49.99m }
};
// Convert collection to Excel
for (int i = 0; i < salesRecords.Count; i++)
{
    sheet[$"A{i+2}"].Value = salesRecords[i].Product;
    sheet[$"B{i+2}"].Value = salesRecords[i].Units;
    sheet[$"C{i+2}"].Value = salesRecords[i].Price;
}

전문적인 Excel 보고서 서식 만들기

원시 데이터만으로는 전문적인 보고서를 만들 수 없습니다. IronXL은 세련되고 비즈니스에 적합한 Excel 파일을 생성하기 위한 포괄적인 셀 서식 옵션을 제공합니다. 다음 코드는 IronXL을 사용하여 얼마나 쉬운지 보여줍니다:

using IronXL;
using IronXl.Styles;
class Program
{
    static void Main(string[] args)
    {
        // Create a new workbook
        var workbook = WorkBook.Create(ExcelFileFormat.XLSX);
        // Add a new worksheet
        var sheet = workbook.CreateWorkSheet("MySheet");
        // Add header values
        sheet["A1"].Value = "Product";
        sheet["B1"].Value = "Quantity";
        sheet["C1"].Value = "Price";
        // Add sample data rows
        sheet["A2"].Value = "Laptop";
        sheet["B2"].Value = 5;
        sheet["C2"].Value = 1299.99;
        sheet["A3"].Value = "Headphones";
        sheet["B3"].Value = 15;
        sheet["C3"].Value = 199.50;
        sheet["A4"].Value = "Keyboard";
        sheet["B4"].Value = 10;
        sheet["C4"].Value = 89.99;
        sheet["A5"].Value = "Monitor";
        sheet["B5"].Value = 7;
        sheet["C5"].Value = 249.00;
        // Header formatting
        var headerRange = sheet["A1:C1"];
        headerRange.Style.Font.Bold = true;
        headerRange.Style.SetBackgroundColor("#4472C4");
        headerRange.Style.Font.Color = "#FFFFFF";
        headerRange.Style.BottomBorder.Type = BorderType.Thick;
        // Number formatting for currency  
        sheet["C:C"].FormatString = "$#,##0.00";
        // Alternating row colors for readability
        for (int row = 2; row <= 10; row++)
        {
            if (row % 2 == 0)
            {
                sheet[$"A{row}:C{row}"].Style.SetBackgroundColor("#F2F2F2");
            }
        }
        // Column width adjustment
        sheet.Columns[0].Width = 15 * 256; // Width in 1/256th of character width
        sheet.Columns[2].Width = 12 * 256;
        // Add borders around data
        var dataRange = sheet["A1:C10"];
        dataRange.Style.TopBorder.Type = BorderType.Thin;
        dataRange.Style.RightBorder.Type = BorderType.Thin;
        dataRange.Style.BottomBorder.Type = BorderType.Thin;
        dataRange.Style.LeftBorder.Type = BorderType.Thin;
        // Save the workbook to a file
        workbook.SaveAs("MyWorkbook.xlsx");
    }
}

using IronXL;
using IronXl.Styles;
class Program
{
    static void Main(string[] args)
    {
        // Create a new workbook
        var workbook = WorkBook.Create(ExcelFileFormat.XLSX);
        // Add a new worksheet
        var sheet = workbook.CreateWorkSheet("MySheet");
        // Add header values
        sheet["A1"].Value = "Product";
        sheet["B1"].Value = "Quantity";
        sheet["C1"].Value = "Price";
        // Add sample data rows
        sheet["A2"].Value = "Laptop";
        sheet["B2"].Value = 5;
        sheet["C2"].Value = 1299.99;
        sheet["A3"].Value = "Headphones";
        sheet["B3"].Value = 15;
        sheet["C3"].Value = 199.50;
        sheet["A4"].Value = "Keyboard";
        sheet["B4"].Value = 10;
        sheet["C4"].Value = 89.99;
        sheet["A5"].Value = "Monitor";
        sheet["B5"].Value = 7;
        sheet["C5"].Value = 249.00;
        // Header formatting
        var headerRange = sheet["A1:C1"];
        headerRange.Style.Font.Bold = true;
        headerRange.Style.SetBackgroundColor("#4472C4");
        headerRange.Style.Font.Color = "#FFFFFF";
        headerRange.Style.BottomBorder.Type = BorderType.Thick;
        // Number formatting for currency  
        sheet["C:C"].FormatString = "$#,##0.00";
        // Alternating row colors for readability
        for (int row = 2; row <= 10; row++)
        {
            if (row % 2 == 0)
            {
                sheet[$"A{row}:C{row}"].Style.SetBackgroundColor("#F2F2F2");
            }
        }
        // Column width adjustment
        sheet.Columns[0].Width = 15 * 256; // Width in 1/256th of character width
        sheet.Columns[2].Width = 12 * 256;
        // Add borders around data
        var dataRange = sheet["A1:C10"];
        dataRange.Style.TopBorder.Type = BorderType.Thin;
        dataRange.Style.RightBorder.Type = BorderType.Thin;
        dataRange.Style.BottomBorder.Type = BorderType.Thin;
        dataRange.Style.LeftBorder.Type = BorderType.Thin;
        // Save the workbook to a file
        workbook.SaveAs("MyWorkbook.xlsx");
    }
}

이 형식 옵션은 기본 데이터를 전문 보고서로 변환합니다. 스타일 API는 글꼴 및 색상에서 테두리 및 정렬에 이르기까지 모든 것을 다루며, Excel 보고서의 외관을 완전히 제어할 수 있습니다. 고급 서식 요구 사항의 경우 중요한 데이터를 자동으로 강조 표시하는 조건부 서식을 탐색하십시오.

동적 Excel 보고서 계산을 위한 수식 사용

Excel의 강력함은 그 수식에서 나옵니다. IronXL은 Excel 수식 생성을 완전히 지원합니다:

// Add formula for row totals
sheet["D1"].Value = "Total";
sheet["D2"].Formula = "=B2*C2";
// Copy formula down the column
for (int row = 3; row <= 10; row++)
{
    sheet[$"D{row}"].Formula = $"=B{row}*C{row}";
}
// Add summary formulas
sheet["A12"].Value = "Summary";
sheet["B12"].Formula = "=SUM(B2:B10)";
sheet["C12"].Formula = "=AVERAGE(C2:C10)";
sheet["D12"].Formula = "=SUM(D2:D10)";

// Add formula for row totals
sheet["D1"].Value = "Total";
sheet["D2"].Formula = "=B2*C2";
// Copy formula down the column
for (int row = 3; row <= 10; row++)
{
    sheet[$"D{row}"].Formula = $"=B{row}*C{row}";
}
// Add summary formulas
sheet["A12"].Value = "Summary";
sheet["B12"].Formula = "=SUM(B2:B10)";
sheet["C12"].Formula = "=AVERAGE(C2:C10)";
sheet["D12"].Formula = "=SUM(D2:D10)";

수식 지원에는 SUM, AVERAGE, IF, VLOOKUP 등 모든 표준 Excel 함수가 포함됩니다. IronXL은 수식 종속성과 계산 순서를 자동으로 처리하여, 복잡한 계산으로 Excel 보고서 생성을 간단하게 만듭니다. IronXL의 수학 함수에 대해 더 알아보기.

템플릿 기반 보고서

반복적인 Excel 보고서 또는 표준화된 워크북을 위해 IronXL은 템플릿 기반 생성을 지원하여 개발자가 Open XML SDK, rels 파일 또는 다양한 폴더를 다루지 않고도 템플릿에서 Excel 파일을 만들 수 있도록 합니다:

// Load existing template
WorkBook templateBook = WorkBook.Load("ReportTemplate.xlsx");
WorkSheet templateSheet = templateBook.DefaultWorkSheet;
// Find and replace template markers
foreach (var cell in templateSheet["A1:Z100"])
{
    if (cell.Text.Contains("{{CompanyName}}"))
        cell.Value = cell.Text.Replace("{{CompanyName}}", "Acme Corp");
    if (cell.Text.Contains("{{ReportDate}}"))
        cell.Value = cell.Text.Replace("{{ReportDate}}", DateTime.Now.ToString("MMMM yyyy"));
}
// Save as new report
templateBook.SaveAs($"Report_{DateTime.Now:yyyyMMdd}.xlsx");

// Load existing template
WorkBook templateBook = WorkBook.Load("ReportTemplate.xlsx");
WorkSheet templateSheet = templateBook.DefaultWorkSheet;
// Find and replace template markers
foreach (var cell in templateSheet["A1:Z100"])
{
    if (cell.Text.Contains("{{CompanyName}}"))
        cell.Value = cell.Text.Replace("{{CompanyName}}", "Acme Corp");
    if (cell.Text.Contains("{{ReportDate}}"))
        cell.Value = cell.Text.Replace("{{ReportDate}}", DateTime.Now.ToString("MMMM yyyy"));
}
// Save as new report
templateBook.SaveAs($"Report_{DateTime.Now:yyyyMMdd}.xlsx");

이 접근 방식은 일관된 서식을 유지하면서 동적 콘텐츠를 업데이트하므로 월간 보고서나 표준화된 문서에 적합합니다.

모범 사례 및 문제 해결

Excel 보고서 생성을 구현할 때는 다음 팁을 염두에 두십시오:

• 대용량 파일의 메모리 사용: 전체 데이터 세트를 로드하는 대신 청크로 데이터를 처리하십시오 (대규모 Excel 파일을 위한 Microsoft의 권장 사항)
• 날짜 형식 문제: Excel 호환 날짜는 DateTime.ToOADate()를 사용하십시오 (Excel 날짜 시스템 설명)
• 파일 잠김 오류: Excel 객체를 using 문 또는 새로운 MemoryStream 접근 방식을 사용하여 항상 제대로 삭제하십시오.
• 누락된 스타일: 일부 스타일 속성은 배경색을 먼저 설정해야 합니다

결론

IronXL은 Excel 보고서 생성을 번거로운 수작업 프로세스에서 자동화되고 신뢰할 수 있는 워크플로우로 변화시킵니다. 직관적인 API, 크로스 플랫폼 지원, 포괄적인 기능 세트를 통해 개발자는 몇 분 만에 전문적인 Excel 보고서를 만들 수 있으며, 이는 몇 시간이 소요되던 것보다 더 빠릅니다. 쉬운 데이터 통합, 강력한 형식 옵션, 공식 지원의 조합으로 IronXL은 Excel 보고서를 다루는 C# 개발자에게 필수 도구입니다. 흥미 있는 개발자를 위해 IronXL은 무료 평가판과 회사 및 개인을 위한 추가 라이선스 옵션을 제공합니다.

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

무료로 시작하세요