C# DataGridView를 Excel로 내보내기: 서식 지정 포함 완벽 가이드 | IronXL

NuGet을 통한 IronXL 설치하기

Visual Studio에서 .NET 10을 대상으로 새 Windows Forms App 프로젝트를 생성합니다. DataGridView 컨트롤과 Button을 폼 표면에 추가합니다. 버튼 이름을 btnExport로 지정하고 레이블 'Excel로 내보내기'를 부여합니다. 그런 다음 NuGet 패키지 관리자 콘솔을 열고 실행합니다:

Install-Package IronXl.Excel

Install-Package IronXl.Excel

폼 파일 상단에 필요한 네임스페이스를 추가하세요:

using IronXL;
using System.Data;

using IronXL;
using System.Data;

이 두 네임스페이스는 Excel 워크북 읽기 및 쓰기에 필요한 모든 IronXL 유형과, DataTable 객체를 내보내기 파이프라인에 연결하는 데 필요한 표준 System.Data 유형을 포함합니다.

DataTable을 DataGridView에 바인딩하기

void Form1_Load(object sender, EventArgs e)
{
    DataTable dt = new DataTable();
    dt.Columns.Add("ProductID", typeof(int));
    dt.Columns.Add("ProductName", typeof(string));
    dt.Columns.Add("Price", typeof(decimal));
    dt.Columns.Add("Stock", typeof(int));

    dt.Rows.Add(1, "Laptop", 999.99m, 50);
    dt.Rows.Add(2, "Mouse", 29.99m, 200);
    dt.Rows.Add(3, "Keyboard", 79.99m, 150);
    dt.Rows.Add(4, "Monitor", 349.99m, 75);
    dt.Rows.Add(5, "Webcam", 89.99m, 120);

    dataGridView1.DataSource = dt;
}

void Form1_Load(object sender, EventArgs e)
{
    DataTable dt = new DataTable();
    dt.Columns.Add("ProductID", typeof(int));
    dt.Columns.Add("ProductName", typeof(string));
    dt.Columns.Add("Price", typeof(decimal));
    dt.Columns.Add("Stock", typeof(int));

    dt.Rows.Add(1, "Laptop", 999.99m, 50);
    dt.Rows.Add(2, "Mouse", 29.99m, 200);
    dt.Rows.Add(3, "Keyboard", 79.99m, 150);
    dt.Rows.Add(4, "Monitor", 349.99m, 75);
    dt.Rows.Add(5, "Webcam", 89.99m, 120);

    dataGridView1.DataSource = dt;
}

이 코드는 이벤트 핸들러 서명의 상위 수준 문장 스타일을 사용합니다. DataTable는 정수, 문자열, 소수, 정수의 네 가지 타입이 있는 열을 가지며, IronXL은 Excel 워크북을 쓸 때 이를 보존합니다. 타입이 지정된 컬럼은 중요합니다. IronXL이 숫자 컬럼을 텍스트가 아닌 숫자 셀로 작성하기 때문에, 사용자는 Excel에서 값을 재포맷하지 않고 정렬하고 합산할 수 있습니다.

DataGridView는 DataTable 열 이름에서 자동으로 열 머리글 행을 렌더링합니다. 내보내기를 할 때 Excel 파일에 그 머리글 행이 보존되기를 원하며, 이는 내보내기 코드가 데이터 행과 별개로 머리글을 처리해야 함을 의미합니다 — 다음 섹션에서 이를 정확히 다룹니다.

생산 환경에서는 DataTable가 Entity Framework, Dapper, ADO.NET 또는 기타 데이터 액세스 레이어에서 나오더라도 동일한 패턴이 적용됩니다. 내보내기 코드는 DataGridView 바인딩에서 분리되어 있어 내보내기 로직을 수정하지 않고 데이터 소스를 교체할 수 있습니다.

버튼 클릭 내보내기 핸들러

void btnExport_Click(object sender, EventArgs e)
{
    try
    {
        DataTable dt = new DataTable();

        foreach (DataGridViewColumn column in dataGridView1.Columns)
            dt.Columns.Add(column.HeaderText);

        foreach (DataGridViewRow row in dataGridView1.Rows)
        {
            if (row.IsNewRow) continue;

            DataRow dataRow = dt.NewRow();
            for (int i = 0; i < dataGridView1.Columns.Count; i++)
                dataRow[i] = row.Cells[i].Value ?? DBNull.Value;

            dt.Rows.Add(dataRow);
        }

        WorkBook workbook = WorkBook.Create(ExcelFileFormat.XLSX);
        WorkSheet worksheet = workbook.DefaultWorkSheet;
        worksheet.Name = "Product Data";

        worksheet.LoadFromDataTable(dt, true);

        string outputPath = Path.Combine(
            Environment.GetFolderPath(Environment.SpecialFolder.Desktop),
            "DataGridViewExport.xlsx"
        );

        workbook.SaveAs(outputPath);
        MessageBox.Show($"Exported successfully to:\n{outputPath}", "Export Complete",
            MessageBoxButtons.OK, MessageBoxIcon.Information);
    }
    catch (Exception ex)
    {
        MessageBox.Show($"Export failed: {ex.Message}", "Error",
            MessageBoxButtons.OK, MessageBoxIcon.Error);
    }
}

void btnExport_Click(object sender, EventArgs e)
{
    try
    {
        DataTable dt = new DataTable();

        foreach (DataGridViewColumn column in dataGridView1.Columns)
            dt.Columns.Add(column.HeaderText);

        foreach (DataGridViewRow row in dataGridView1.Rows)
        {
            if (row.IsNewRow) continue;

            DataRow dataRow = dt.NewRow();
            for (int i = 0; i < dataGridView1.Columns.Count; i++)
                dataRow[i] = row.Cells[i].Value ?? DBNull.Value;

            dt.Rows.Add(dataRow);
        }

        WorkBook workbook = WorkBook.Create(ExcelFileFormat.XLSX);
        WorkSheet worksheet = workbook.DefaultWorkSheet;
        worksheet.Name = "Product Data";

        worksheet.LoadFromDataTable(dt, true);

        string outputPath = Path.Combine(
            Environment.GetFolderPath(Environment.SpecialFolder.Desktop),
            "DataGridViewExport.xlsx"
        );

        workbook.SaveAs(outputPath);
        MessageBox.Show($"Exported successfully to:\n{outputPath}", "Export Complete",
            MessageBoxButtons.OK, MessageBoxIcon.Information);
    }
    catch (Exception ex)
    {
        MessageBox.Show($"Export failed: {ex.Message}", "Error",
            MessageBoxButtons.OK, MessageBoxIcon.Error);
    }
}

LoadFromDataTable(dt, true) 호출은 DataTable와 IronXL에게 Excel의 첫 번째 행으로 열 이름을 쓰도록 지시하는 부울 플래그를 받습니다. 이는 머리글 셀이 됩니다. 사용자의 데스크톱에 하드코드된 경로 대신 Environment.SpecialFolder.Desktop을 사용하여 워크북을 저장하여 코드가 사용자 계정 간 포터블하게 만듭니다.

null 확인 (?? DBNull.Value) prevents a NullReferenceException는 셀에 값이 없을 때 발생합니다. 옵션 필드가 비어 있을 수 있는 실제 데이터에서 중요합니다. IronXL은 문자열 'DBNull' 대신 빈 셀로 DBNull을 쓰므로 출력이 깔끔하게 유지됩니다.

Excel 파일에서 데이터를 DataGridView으로 다시 읽는 것에 대한 자세한 내용은 IronXL DataTable 문서를 참조하세요. 이 문서는 역작업과 멀티시트 워크북의 Excel을 DataSet으로 변환하는 방법을 다룹니다.

헤더 스타일 적용 및 교대로 행 색상

void ExportWithFormatting(object sender, EventArgs e)
{
    WorkBook workbook = WorkBook.Create(ExcelFileFormat.XLSX);
    WorkSheet worksheet = workbook.DefaultWorkSheet;
    worksheet.Name = "Formatted Export";

    string[] headers = { "ID", "Product Name", "Price", "Stock" };

    // Write and style header row
    for (int col = 0; col < headers.Length; col++)
    {
        char colLetter = (char)('A' + col);
        string cellAddress = $"{colLetter}1";

        worksheet.SetCellValue(0, col, headers[col]);
        worksheet[cellAddress].Style.Font.Bold = true;
        worksheet[cellAddress].Style.Font.Height = 12;
        worksheet[cellAddress].Style.SetBackgroundColor("#4472C4");
        worksheet[cellAddress].Style.Font.Color = "#FFFFFF";
        worksheet[cellAddress].Style.HorizontalAlignment =
            IronXl.Styles.HorizontalAlignment.Center;
    }

    // Write data rows with alternating background colors
    int rowIndex = 1;
    foreach (DataGridViewRow row in dataGridView1.Rows)
    {
        if (row.IsNewRow) continue;

        for (int col = 0; col < dataGridView1.Columns.Count; col++)
        {
            worksheet.SetCellValue(rowIndex, col,
                row.Cells[col].Value?.ToString() ?? string.Empty);
        }

        if (rowIndex % 2 == 0)
        {
            string rangeAddress = $"A{rowIndex + 1}:D{rowIndex + 1}";
            worksheet[rangeAddress].Style.SetBackgroundColor("#D6DCE5");
        }

        rowIndex++;
    }

    // Format the Price column as currency
    worksheet["C2:C100"].Style.Format = "$#,##0.00";

    // Auto-fit column widths
    worksheet.AutoSizeColumn(0);
    worksheet.AutoSizeColumn(1);
    worksheet.AutoSizeColumn(2);
    worksheet.AutoSizeColumn(3);

    string outputPath = Path.Combine(
        Environment.GetFolderPath(Environment.SpecialFolder.Desktop),
        "FormattedExport.xlsx"
    );

    workbook.SaveAs(outputPath);
    MessageBox.Show("Formatted export complete.", "Done",
        MessageBoxButtons.OK, MessageBoxIcon.Information);
}

void ExportWithFormatting(object sender, EventArgs e)
{
    WorkBook workbook = WorkBook.Create(ExcelFileFormat.XLSX);
    WorkSheet worksheet = workbook.DefaultWorkSheet;
    worksheet.Name = "Formatted Export";

    string[] headers = { "ID", "Product Name", "Price", "Stock" };

    // Write and style header row
    for (int col = 0; col < headers.Length; col++)
    {
        char colLetter = (char)('A' + col);
        string cellAddress = $"{colLetter}1";

        worksheet.SetCellValue(0, col, headers[col]);
        worksheet[cellAddress].Style.Font.Bold = true;
        worksheet[cellAddress].Style.Font.Height = 12;
        worksheet[cellAddress].Style.SetBackgroundColor("#4472C4");
        worksheet[cellAddress].Style.Font.Color = "#FFFFFF";
        worksheet[cellAddress].Style.HorizontalAlignment =
            IronXl.Styles.HorizontalAlignment.Center;
    }

    // Write data rows with alternating background colors
    int rowIndex = 1;
    foreach (DataGridViewRow row in dataGridView1.Rows)
    {
        if (row.IsNewRow) continue;

        for (int col = 0; col < dataGridView1.Columns.Count; col++)
        {
            worksheet.SetCellValue(rowIndex, col,
                row.Cells[col].Value?.ToString() ?? string.Empty);
        }

        if (rowIndex % 2 == 0)
        {
            string rangeAddress = $"A{rowIndex + 1}:D{rowIndex + 1}";
            worksheet[rangeAddress].Style.SetBackgroundColor("#D6DCE5");
        }

        rowIndex++;
    }

    // Format the Price column as currency
    worksheet["C2:C100"].Style.Format = "$#,##0.00";

    // Auto-fit column widths
    worksheet.AutoSizeColumn(0);
    worksheet.AutoSizeColumn(1);
    worksheet.AutoSizeColumn(2);
    worksheet.AutoSizeColumn(3);

    string outputPath = Path.Combine(
        Environment.GetFolderPath(Environment.SpecialFolder.Desktop),
        "FormattedExport.xlsx"
    );

    workbook.SaveAs(outputPath);
    MessageBox.Show("Formatted export complete.", "Done",
        MessageBoxButtons.OK, MessageBoxIcon.Information);
}

서식 코드에는 여러 기술이 적용됩니다. 머리글 행은 파란색 배경 (#4472C4), 흰색 텍스트, 12포인트 굵은 글꼴 및 가운데 정렬을 가지며, 이는 표준 비즈니스 스프레드시트 스타일입니다. 데이터 행은 짝수 행마다 흰색과 연한 회색 (#D6DCE5)이 번갈아 나타나며, 사용자가 넓은 표를 읽을 때 위치를 잃지 않기 쉽게 만듭니다. 가격 열은 Excel의 내장 통화 형식 ($#,##0.00)을 사용하여, 스프레드시트에서 달러 기호와 소수 두 자리와 함께 값을 표시합니다. 기본 수치 데이터는 변경되지 않습니다. AutoSizeColumn는 각 열을 가장 긴 값에 맞춰 맞추므로 내용이 잘리지 않습니다.

셀 테두리 스타일링, 조건부 서식, 데이터 유효성 검사 규칙을 사용하여 이 패턴을 더 확장할 수 있습니다. 기업 템플릿과 일치해야 하는 보고서의 경우, 내보낸 파일을 조정 없이 바로 인쇄할 수 있도록 페이지 레이아웃 및 인쇄 영역을 설정할 수 있습니다.