C#에서 DataGridView를 열 머리글과 함께 Excel로 내보내기

C#에서 열 머리글과 함께 DataGridView를 Excel로 내보내는 방법은 무엇입니까?

Windows Forms DataGridView 컨트롤에서 Excel 형식으로 데이터를 내보내는 것은 일반적인 요구사항이지만 개발자는 종종 좌절감을 겪습니다: 내보낸 파일에 열 머리글이 없습니다. DataGridView를 열 머리글과 함께 Excel로 내보낼 필요가 있을 때, 솔루션은 모든 데이터와 서식을 신뢰성 있게 보존해야 합니다. Microsoft Office Interop을 사용하는 전통적인 접근법은 느리고 불안정할 수 있으며, 코드를 실행하는 모든 기기에 MS Excel이 설치되어야 합니다.

IronXL은 이 문제를 깔끔하게 해결합니다. 이는 Office 종속성 없이 Excel 파일을 읽고 생성하며 작성하는 .NET Excel 라이브러리입니다. 이 튜토리얼은 열 머리글, 데이터 유형, null 셀, 사용자 친화적인 파일 저장을 몇 줄의 코드로 처리하는 전체 내보내기 솔루션을 안내합니다.

결국, 당신은 열 머리글이 모두 포함된 XLSX 파일로 DataGridView를 내보내는 작동하는 Windows Forms 버튼 핸들러를 가지게 될 것입니다.

.NET 프로젝트에서 라이브러리를 설치하는 방법은?

Visual Studio에서 NuGet 패키지 관리자 콘솔을 열고 다음 명령 중 하나를 실행합니다. 패키지는 NuGet 갤러리에 목록화되어 있으며 .NET Standard 2.0 이상을 대상으로 하므로, 모든 최신 .NET 프로젝트에서 작동합니다.

Install-Package IronXL

Install-Package IronXL

dotnet add package IronXL

dotnet add package IronXL

설치 후, 양식 파일의 상단에 필요한 네임스페이스를 추가합니다:

using IronXL;
using System;
using System.Data;
using System.Windows.Forms;

using IronXL;
using System;
using System.Data;
using System.Windows.Forms;

이 가져오기는 IronXL의 Excel 기능, DataTable 작업 및 내보내기 프로세스에 필요한 Windows Forms 컨트롤에 대한 접근을 제공합니다.

샘플 데이터로 DataGridView를 설정하는 방법은?

Visual Studio에서 Windows Forms 응용 프로그램을 생성합니다. 디자이너를 통해 주 폼에 이름이 dataGridView1인 DataGridView와 이름이 btnExport인 버튼을 추가합니다. 그런 다음 양식 로드 시 그리드를 채웁니다:

using System;
using System.Data;
using System.Windows.Forms;

public partial class Form1 : Form
{
    public Form1()
    {
        InitializeComponent();
    }

    private void Form1_Load(object sender, EventArgs e)
    {
        DataTable dt = new DataTable();

        // Define columns -- these names become Excel headers
        dt.Columns.Add("Product ID", typeof(int));
        dt.Columns.Add("Product Name", typeof(string));
        dt.Columns.Add("Price", typeof(decimal));
        dt.Columns.Add("Stock Quantity", typeof(int));

        // Add sample rows
        dt.Rows.Add(1001, "Laptop", 999.99m, 15);
        dt.Rows.Add(1002, "Mouse", 29.99m, 50);
        dt.Rows.Add(1003, "Keyboard", 79.99m, 30);
        dt.Rows.Add(1004, "Monitor", 299.99m, 12);
        dt.Rows.Add(1005, "Headphones", 89.99m, 25);

        // Bind data to the grid
        dataGridView1.DataSource = dt;
    }
}

using System;
using System.Data;
using System.Windows.Forms;

public partial class Form1 : Form
{
    public Form1()
    {
        InitializeComponent();
    }

    private void Form1_Load(object sender, EventArgs e)
    {
        DataTable dt = new DataTable();

        // Define columns -- these names become Excel headers
        dt.Columns.Add("Product ID", typeof(int));
        dt.Columns.Add("Product Name", typeof(string));
        dt.Columns.Add("Price", typeof(decimal));
        dt.Columns.Add("Stock Quantity", typeof(int));

        // Add sample rows
        dt.Rows.Add(1001, "Laptop", 999.99m, 15);
        dt.Rows.Add(1002, "Mouse", 29.99m, 50);
        dt.Rows.Add(1003, "Keyboard", 79.99m, 30);
        dt.Rows.Add(1004, "Monitor", 299.99m, 12);
        dt.Rows.Add(1005, "Headphones", 89.99m, 25);

        // Bind data to the grid
        dataGridView1.DataSource = dt;
    }
}

dt.Columns.Add(...) 호출에 정의된 컬럼 이름은 내보낸 Excel 파일의 헤더 행이 됩니다. 여기에서 데이터 소스를 대체할 수 있습니다 -- 데이터베이스 쿼리 결과, CSV 가져오기, 또는 DataTable로 저장된 API 응답 등 모든 것이 이후에 제시된 내보내기 코드와 동일하게 작동합니다. DataTable 접근 방식은 특히 편리한데, DataGridView가 모든 IList 또는 IBindingList를 허용하는 DataSource 속성을 노출하므로 같은 내보내기 코드가 수정 없이 모든 바인딩 시나리오에 일반화됩니다.

DataGridView가 SqlDataAdapter를 사용하여 데이터베이스에서 채워지는 경우, DataTable은 이미 형식화된 열을 포함합니다. 형식화된 값을 ToString() 호출 대신 SetCellValue에 전달하면 Excel 출력에서 숫자 열이 숫자로 유지됩니다. 이는 이후 보고서 또는 피벗 테이블 사용에 중요합니다.

이는 모든 데이터를 포함한 DataGridView를 생성합니다:

보다 고급 데이터 바인딩 시나리오에 대한 Microsoft's DataGridView 데이터 바인딩 문서는 추가적인 예시를 제공합니다.

열 헤더를 보존하며 DataGridView를 Excel로 내보내는 방법은?

내보내기 메서드는 각 DataGridView 열의 HeaderText 속성에서 열 헤더를 읽고 이를 워크시트의 0행에 작성합니다. 데이터 행은 1행부터 이어집니다. 이 메서드를 btnExport 클릭 이벤트에 연결하십시오:

private void btnExport_Click(object sender, EventArgs e)
{
    try
    {
        // Create a new Excel workbook in XLSX format
        WorkBook workbook = WorkBook.Create(ExcelFileFormat.XLSX);
        WorkSheet worksheet = workbook.CreateWorkSheet("Exported Data");

        // Write column headers to row 0
        for (int col = 0; col < dataGridView1.Columns.Count; col++)
        {
            worksheet.SetCellValue(0, col, dataGridView1.Columns[col].HeaderText);
        }

        // Write data rows starting at row 1
        for (int row = 0; row < dataGridView1.Rows.Count; row++)
        {
            // Skip the placeholder new-row at the bottom of the grid
            if (dataGridView1.AllowUserToAddRows && row == dataGridView1.Rows.Count - 1)
                continue;

            for (int col = 0; col < dataGridView1.Columns.Count; col++)
            {
                var cellValue = dataGridView1.Rows[row].Cells[col].Value;
                if (cellValue != null)
                {
                    worksheet.SetCellValue(row + 1, col, cellValue.ToString());
                }
            }
        }

        // Prompt the user to choose a save location
        using SaveFileDialog saveFileDialog = new SaveFileDialog
        {
            Filter = "Excel Files|*.xlsx",
            FileName = "DataGridView_Export.xlsx"
        };

        if (saveFileDialog.ShowDialog() == DialogResult.OK)
        {
            workbook.SaveAs(saveFileDialog.FileName);
            MessageBox.Show("Export completed successfully!", "Success",
                            MessageBoxButtons.OK, MessageBoxIcon.Information);
        }
    }
    catch (Exception ex)
    {
        MessageBox.Show($"Export failed: {ex.Message}", "Error",
                       MessageBoxButtons.OK, MessageBoxIcon.Error);
    }
}

private void btnExport_Click(object sender, EventArgs e)
{
    try
    {
        // Create a new Excel workbook in XLSX format
        WorkBook workbook = WorkBook.Create(ExcelFileFormat.XLSX);
        WorkSheet worksheet = workbook.CreateWorkSheet("Exported Data");

        // Write column headers to row 0
        for (int col = 0; col < dataGridView1.Columns.Count; col++)
        {
            worksheet.SetCellValue(0, col, dataGridView1.Columns[col].HeaderText);
        }

        // Write data rows starting at row 1
        for (int row = 0; row < dataGridView1.Rows.Count; row++)
        {
            // Skip the placeholder new-row at the bottom of the grid
            if (dataGridView1.AllowUserToAddRows && row == dataGridView1.Rows.Count - 1)
                continue;

            for (int col = 0; col < dataGridView1.Columns.Count; col++)
            {
                var cellValue = dataGridView1.Rows[row].Cells[col].Value;
                if (cellValue != null)
                {
                    worksheet.SetCellValue(row + 1, col, cellValue.ToString());
                }
            }
        }

        // Prompt the user to choose a save location
        using SaveFileDialog saveFileDialog = new SaveFileDialog
        {
            Filter = "Excel Files|*.xlsx",
            FileName = "DataGridView_Export.xlsx"
        };

        if (saveFileDialog.ShowDialog() == DialogResult.OK)
        {
            workbook.SaveAs(saveFileDialog.FileName);
            MessageBox.Show("Export completed successfully!", "Success",
                            MessageBoxButtons.OK, MessageBoxIcon.Information);
        }
    }
    catch (Exception ex)
    {
        MessageBox.Show($"Export failed: {ex.Message}", "Error",
                       MessageBoxButtons.OK, MessageBoxIcon.Error);
    }
}

내보내기 중 일반적인 예외 사례를 처리하는 방법은?

실제 세계의 데이터는 샘플 데이터셋만큼 깨끗하게 보이지 않습니다. 가장 자주 직면하는 시나리오와 이를 해결하는 방법을 소개합니다.

if (cellValue is int intVal)
    worksheet.SetCellValue(row + 1, col, intVal);
else if (cellValue is decimal decVal)
    worksheet.SetCellValue(row + 1, col, (double)decVal);
else
    worksheet.SetCellValue(row + 1, col, cellValue?.ToString() ?? string.Empty);

if (cellValue is int intVal)
    worksheet.SetCellValue(row + 1, col, intVal);
else if (cellValue is decimal decVal)
    worksheet.SetCellValue(row + 1, col, (double)decVal);
else
    worksheet.SetCellValue(row + 1, col, cellValue?.ToString() ?? string.Empty);

주요 내보내기 접근 방식 비교 방법은?

라이브러리에 커밋하기 전에 가장 일반적인 방법들 간의 절충점을 이해하는 데 도움이 됩니다.

Interop 기반 솔루션은 서버에 Excel 설치가 필요하며, 이는 라이선스 문제와 배포 복잡성을 초래합니다. OpenXml SDK는 강력하지만 저수준의 도구로, 헤더 행을 작성하려면 XML 구조를 수동으로 구축해야 합니다. IronXL과 클로즈드XML은 둘 다 고수준의 API를 제공하지만, IronXL의 WorkBook과 WorkSheet 모델은 개발자가 스프레드시트를 이미 생각하는 방식과 밀접하게 연관되어 있습니다.

XLSX 대신 CSV로 내보내는 방법은?

Excel 워크북 대신 CSV 파일이 필요할 때 동일한 내보내기 패턴이 적용됩니다. 파일 형식과 확장자를 변경하세요:

WorkBook csvWorkbook = WorkBook.Create(ExcelFileFormat.CSV);
WorkSheet csvSheet = csvWorkbook.CreateWorkSheet("Data");

// Headers and data loops remain identical

using SaveFileDialog dialog = new SaveFileDialog
{
    Filter = "CSV Files|*.csv",
    FileName = "DataGridView_Export.csv"
};

if (dialog.ShowDialog() == DialogResult.OK)
    csvWorkbook.SaveAs(dialog.FileName);

WorkBook csvWorkbook = WorkBook.Create(ExcelFileFormat.CSV);
WorkSheet csvSheet = csvWorkbook.CreateWorkSheet("Data");

// Headers and data loops remain identical

using SaveFileDialog dialog = new SaveFileDialog
{
    Filter = "CSV Files|*.csv",
    FileName = "DataGridView_Export.csv"
};

if (dialog.ShowDialog() == DialogResult.OK)
    csvWorkbook.SaveAs(dialog.FileName);

CSV 내보내기는 소비 시스템이 XLSX를 지원하지 않거나 매우 큰 데이터 세트의 경우 파일 크기가 문제일 때 유용합니다.

내보낸 파일의 헤더 행을 스타일링하는 방법은?

내보낸 데이터는 헤더 행이 시각적으로 뚜렷할 때 더 읽기 쉽습니다. IronXL은 헤더 값을 작성한 후 굵은 텍스트, 배경색, 폰트 크기를 적용할 수 있는 셀 스타일링 옵션을 제공합니다:

// Write headers and apply bold styling
for (int col = 0; col < dataGridView1.Columns.Count; col++)
{
    string cellAddress = worksheet.GetCellAddress(0, col);
    worksheet[cellAddress].Value = dataGridView1.Columns[col].HeaderText;
    worksheet[cellAddress].Style.Font.Bold = true;
    worksheet[cellAddress].Style.SetBackgroundColor("#4472C4");
    worksheet[cellAddress].Style.Font.FontColor = "#FFFFFF";
}

// Write headers and apply bold styling
for (int col = 0; col < dataGridView1.Columns.Count; col++)
{
    string cellAddress = worksheet.GetCellAddress(0, col);
    worksheet[cellAddress].Value = dataGridView1.Columns[col].HeaderText;
    worksheet[cellAddress].Style.Font.Bold = true;
    worksheet[cellAddress].Style.SetBackgroundColor("#4472C4");
    worksheet[cellAddress].Style.Font.FontColor = "#FFFFFF";
}

스타일링된 헤더 행은 수신자가 수동으로 서식을 적용할 필요 없이 내보낸 파일을 즉시 보고에 사용할 수 있게 해줍니다. IronXL 셀 스타일링 참조에서 스타일 속성 전체 목록을 확인하세요.

무료 체험판으로 시작하는 방법은?

IronXL은 이 글에 설명된 내보내기 워크플로우를 포함한 모든 기능을 테스트할 수 있는 무료 체험판을 제공합니다. 위에 제시된 NuGet 명령 중 하나로 패키지를 설치하고, IronXL 라이선스 페이지에서 체험판 키를 생성한 다음 첫 번째 라이브러리 호출 전에 애플리케이션에 설정하세요:

IronXl.License.LicenseKey = "YOUR-LICENSE-KEY-HERE";

IronXl.License.LicenseKey = "YOUR-LICENSE-KEY-HERE";

체험판은 완전한 기능을 갖춘 Excel 파일을 생성하며 사용 가능한 기능에 제한을 두지 않습니다. 프로덕션 배포를 위해서는 라이선싱 옵션이 단일 개발자, 팀 및 로열티 무료 재배포를 포함합니다.

관련 내보내기 시나리오의 경우, IronXL이 DataTables를 직접 Excel로 내보내는 것, Excel 파일을 DataGridViews로 읽는 것, 및 내보낸 데이터로 차트를 생성하는 것을 어떻게 처리하는지 탐색하세요.