OleDb와 IronXL 사용하여 C#에서 DataTable을 Excel로 내보내기

데이터 테이블 내보내기용 IronXL은 어떻게 설치합니까?

내보내기 코드를 작성하기 전에 프로젝트에 IronXL을 추가하십시오. Visual Studio에서 패키지 관리자 콘솔을 열고 다음을 실행하세요:

Install-Package IronXL
dotnet add package IronXL

Install-Package IronXL
dotnet add package IronXL

IronXL은 Microsoft Office, Access Database Engine 또는 COM 상호 운용 계층에 종속되지 않습니다. 패키지가 설치되면 Windows, Linux, macOS, Docker, Azure와 AWS에서 동일한 코드를 단 한 줄도 변경하지 않고 실행할 수 있습니다.

개발자는 왜 여전히 Excel 내보내기에 올레디비를 사용할까?

.NET Framework의 일부로 이미 올레디비가 Excel 자동화의 기본 선택이 되었습니다. 개발자들은 이미 ADO.NET을 알고 있었기 때문에, 올레디비Connection, 올레디비Command, 그리고 올레디비DataAdapter을 사용하여 Excel에 쓰는 것은 자연스럽게 느껴졌습니다. 서드파티 패키지가 필요하지 않았으며, CREATE TABLE와 INSERT INTO의 SQL과 유사한 구문은 데이터베이스 프로그래밍에 익숙한 누구에게나 의도를 명확하게 했습니다.

여기 데이터 테이블을 올레디비를 사용하여 내보내는 전통적인 패턴이 있습니다:

using System.Data;
using System.Data.올레디비;

// Build a sample DataTable
DataTable dataTable = new DataTable("Products");
dataTable.Columns.Add("ProductID", typeof(int));
dataTable.Columns.Add("ProductName", typeof(string));
dataTable.Columns.Add("Price", typeof(decimal));
dataTable.Rows.Add(1, "Widget", 29.99m);
dataTable.Rows.Add(2, "Gadget", 49.99m);
dataTable.Rows.Add(3, "Gizmo", 19.99m);

// 올레디비 connection string -- file must already exist on disk
string filename = @"C:\Output\Products.xlsx";
string connectionString =
    $"Provider=Microsoft.ACE.OLEDB.12.0;Data Source={filename};" +
    "Extended Properties='Excel 12.0 Xml;HDR=YES'";

using 올레디비Connection connection = new(connectionString);
connection.Open();

// Create the sheet structure with SQL DDL
string create = "CREATE TABLE [Sheet1$] (ProductID INT, ProductName CHAR(255), Price DOUBLE)";
using (var createCmd = new 올레디비Command(create, connection))
    createCmd.Execute아니요nQuery();

// Insert rows one at a time
string insert = "INSERT INTO [Sheet1$] (ProductID, ProductName, Price) VALUES (?, ?, ?)";
using 올레디비Command insertCmd = new(insert, connection);
insertCmd.Parameters.Add(new 올레디비Parameter("ProductID", 올레디비Type.Integer));
insertCmd.Parameters.Add(new 올레디비Parameter("ProductName", 올레디비Type.VarChar, 255));
insertCmd.Parameters.Add(new 올레디비Parameter("Price", 올레디비Type.Double));

foreach (DataRow row in dataTable.Rows)
{
    insertCmd.Parameters[0].Value = row["ProductID"];
    insertCmd.Parameters[1].Value = row["ProductName"];
    insertCmd.Parameters[2].Value = row["Price"];
    insertCmd.Execute아니요nQuery();
}

using System.Data;
using System.Data.올레디비;

// Build a sample DataTable
DataTable dataTable = new DataTable("Products");
dataTable.Columns.Add("ProductID", typeof(int));
dataTable.Columns.Add("ProductName", typeof(string));
dataTable.Columns.Add("Price", typeof(decimal));
dataTable.Rows.Add(1, "Widget", 29.99m);
dataTable.Rows.Add(2, "Gadget", 49.99m);
dataTable.Rows.Add(3, "Gizmo", 19.99m);

// 올레디비 connection string -- file must already exist on disk
string filename = @"C:\Output\Products.xlsx";
string connectionString =
    $"Provider=Microsoft.ACE.OLEDB.12.0;Data Source={filename};" +
    "Extended Properties='Excel 12.0 Xml;HDR=YES'";

using 올레디비Connection connection = new(connectionString);
connection.Open();

// Create the sheet structure with SQL DDL
string create = "CREATE TABLE [Sheet1$] (ProductID INT, ProductName CHAR(255), Price DOUBLE)";
using (var createCmd = new 올레디비Command(create, connection))
    createCmd.Execute아니요nQuery();

// Insert rows one at a time
string insert = "INSERT INTO [Sheet1$] (ProductID, ProductName, Price) VALUES (?, ?, ?)";
using 올레디비Command insertCmd = new(insert, connection);
insertCmd.Parameters.Add(new 올레디비Parameter("ProductID", 올레디비Type.Integer));
insertCmd.Parameters.Add(new 올레디비Parameter("ProductName", 올레디비Type.VarChar, 255));
insertCmd.Parameters.Add(new 올레디비Parameter("Price", 올레디비Type.Double));

foreach (DataRow row in dataTable.Rows)
{
    insertCmd.Parameters[0].Value = row["ProductID"];
    insertCmd.Parameters[1].Value = row["ProductName"];
    insertCmd.Parameters[2].Value = row["Price"];
    insertCmd.Execute아니요nQuery();
}

이 코드는 각 DataRow를 별도의 데이터베이스 왕복으로 삽입합니다. 대규모 데이터 세트의 경우, 그 루프는 올레디비를 통한 배치 삽입 메커니즘을 사용할 수 없기 때문에 병목이 됩니다. 모든 행은 다음으로 이동하기 전에 모든 SQL 구문 분석, 매개 변수 바인드 및 쓰기 주기를 트리거합니다.

올레디비의 Excel 내보내기에 대한 주요 제한 사항은 무엇입니까?

올레디비가 부족한 이유를 이해하면 팀에게 이전의 정당성을 부여하고 적절한 대체품을 선택할 수 있도록 도와줍니다.

IronXL로 DataTable을 Excel로 내보내는 방법은 무엇입니까?

IronXL은 전체 올레디비 파이프라인을 직접 객체 모델로 대체합니다. 연결 문자열도, SQL 명령도, 드라이버 요구 사항도 없습니다. 당신은 WorkBook을 만들고, WorkSheet을 추가하며 각 셀에 대해 SetCellValue()을 호출합니다:

using IronXL;
using System.Data;

// Build the same DataTable
DataTable dataTable = new DataTable("Products");
dataTable.Columns.Add("ProductID", typeof(int));
dataTable.Columns.Add("ProductName", typeof(string));
dataTable.Columns.Add("Price", typeof(decimal));
dataTable.Rows.Add(1, "Widget", 29.99m);
dataTable.Rows.Add(2, "Gadget", 49.99m);
dataTable.Rows.Add(3, "Gizmo", 19.99m);

// Create a new workbook and worksheet -- no template file needed
WorkBook workbook = WorkBook.Create(ExcelFileFormat.XLSX);
WorkSheet worksheet = workbook.CreateWorkSheet("Products");

// Write column headers into the first row
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].ToString());
    }
}

workbook.SaveAs("Products.xlsx");

using IronXL;
using System.Data;

// Build the same DataTable
DataTable dataTable = new DataTable("Products");
dataTable.Columns.Add("ProductID", typeof(int));
dataTable.Columns.Add("ProductName", typeof(string));
dataTable.Columns.Add("Price", typeof(decimal));
dataTable.Rows.Add(1, "Widget", 29.99m);
dataTable.Rows.Add(2, "Gadget", 49.99m);
dataTable.Rows.Add(3, "Gizmo", 19.99m);

// Create a new workbook and worksheet -- no template file needed
WorkBook workbook = WorkBook.Create(ExcelFileFormat.XLSX);
WorkSheet worksheet = workbook.CreateWorkSheet("Products");

// Write column headers into the first row
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].ToString());
    }
}

workbook.SaveAs("Products.xlsx");

WorkBook.Create(ExcelFileFormat.XLSX)은 메모리에서 새 워크북을 구축합니다. 사전에 파일이 존재할 필요는 없습니다. CreateWorkSheet("Products")은 이름이 지정된 탭을 추가합니다. 중첩된 루프는 DataTable의 행 및 열 개수를 정확히 반영하며, 각 셀에 하나의 값을 씁니다. SaveAs()은 워크북을 완전히 적법한 XLSX 파일로 디스크에 플러시합니다.

DataTable 내보낼 때 셀 서식을 어떻게 추가합니까?

기본 내보내기 후 가장 일반적인 요구 사항 중 하나는 헤더 행에 스타일을 적용하여 데이터 행과 구별하는 것입니다. IronXL은 올레디비가 일치시킬 수 없는 전체 스타일 API를 노출합니다:

using IronXL;
using IronXl.Styles;
using System.Data;

DataTable dataTable = new DataTable("Products");
dataTable.Columns.Add("ProductID", typeof(int));
dataTable.Columns.Add("ProductName", typeof(string));
dataTable.Columns.Add("Price", typeof(decimal));
dataTable.Rows.Add(1, "Widget", 29.99m);
dataTable.Rows.Add(2, "Gadget", 49.99m);
dataTable.Rows.Add(3, "Gizmo", 19.99m);

WorkBook workbook = WorkBook.Create(ExcelFileFormat.XLSX);
WorkSheet worksheet = workbook.CreateWorkSheet("Products");

// Write and style the header row
for (int col = 0; col < dataTable.Columns.Count; col++)
{
    var headerCell = worksheet[$"{(char)('A' + col)}1"];
    headerCell.Value = dataTable.Columns[col].ColumnName;
    headerCell.Style.Font.Bold = true;
    headerCell.Style.BackgroundColor = "#4472C4";
    headerCell.Style.Font.FontColor = "#FFFFFF";
}

// Write data rows with price column formatted as currency
for (int row = 0; row < dataTable.Rows.Count; row++)
{
    for (int col = 0; col < dataTable.Columns.Count; col++)
    {
        var cell = worksheet[$"{(char)('A' + col)}{row + 2}"];
        cell.Value = dataTable.Rows[row][col].ToString();

        // Apply currency format to the Price column
        if (dataTable.Columns[col].ColumnName == "Price")
            cell.FormatString = "$#,##0.00";
    }
}

// Auto-size columns so content is not clipped
worksheet.AutoSizeColumn(0);
worksheet.AutoSizeColumn(1);
worksheet.AutoSizeColumn(2);

workbook.SaveAs("ProductsStyled.xlsx");

using IronXL;
using IronXl.Styles;
using System.Data;

DataTable dataTable = new DataTable("Products");
dataTable.Columns.Add("ProductID", typeof(int));
dataTable.Columns.Add("ProductName", typeof(string));
dataTable.Columns.Add("Price", typeof(decimal));
dataTable.Rows.Add(1, "Widget", 29.99m);
dataTable.Rows.Add(2, "Gadget", 49.99m);
dataTable.Rows.Add(3, "Gizmo", 19.99m);

WorkBook workbook = WorkBook.Create(ExcelFileFormat.XLSX);
WorkSheet worksheet = workbook.CreateWorkSheet("Products");

// Write and style the header row
for (int col = 0; col < dataTable.Columns.Count; col++)
{
    var headerCell = worksheet[$"{(char)('A' + col)}1"];
    headerCell.Value = dataTable.Columns[col].ColumnName;
    headerCell.Style.Font.Bold = true;
    headerCell.Style.BackgroundColor = "#4472C4";
    headerCell.Style.Font.FontColor = "#FFFFFF";
}

// Write data rows with price column formatted as currency
for (int row = 0; row < dataTable.Rows.Count; row++)
{
    for (int col = 0; col < dataTable.Columns.Count; col++)
    {
        var cell = worksheet[$"{(char)('A' + col)}{row + 2}"];
        cell.Value = dataTable.Rows[row][col].ToString();

        // Apply currency format to the Price column
        if (dataTable.Columns[col].ColumnName == "Price")
            cell.FormatString = "$#,##0.00";
    }
}

// Auto-size columns so content is not clipped
worksheet.AutoSizeColumn(0);
worksheet.AutoSizeColumn(1);
worksheet.AutoSizeColumn(2);

workbook.SaveAs("ProductsStyled.xlsx");

이는 파란색 헤더 행, 흰색 헤더 텍스트, 달러 기호와 소수점 두 자리로 표시된 가격 값을 포함한 파일을 생성합니다. 셀 글꼴 크기 가이드 및 테두리 및 정렬 참조는 사용 가능한 전체 스타일 옵션 세트를 설명합니다.

ASP.NET에서 DataTable을 Excel로 내보내는 방법은?

웹 애플리케이션에서는 보통 워크북을 직접 브라우저로 스트리밍하고 디스크에 저장하지 않습니다. IronXL은 workbook.ToByteArray()을 통해서 이것을 지원하며, 이진 콘텐츠를 반환하여 HTTP 응답에 쓸 수 있습니다:

// In an ASP.NET controller action
WorkBook workbook = WorkBook.Create(ExcelFileFormat.XLSX);
WorkSheet worksheet = workbook.CreateWorkSheet("Report");

// Assume dataTable is populated from your data source
for (int col = 0; col < dataTable.Columns.Count; col++)
    worksheet.SetCellValue(0, col, dataTable.Columns[col].ColumnName);

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].ToString());

byte[] fileBytes = workbook.ToByteArray();
return File(fileBytes, "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet", "Report.xlsx");

// In an ASP.NET controller action
WorkBook workbook = WorkBook.Create(ExcelFileFormat.XLSX);
WorkSheet worksheet = workbook.CreateWorkSheet("Report");

// Assume dataTable is populated from your data source
for (int col = 0; col < dataTable.Columns.Count; col++)
    worksheet.SetCellValue(0, col, dataTable.Columns[col].ColumnName);

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].ToString());

byte[] fileBytes = workbook.ToByteArray();
return File(fileBytes, "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet", "Report.xlsx");

ASP.NET DataTable 내보내기 Excel 튜토리얼은 ASP.NET 애플리케이션의 전체 컨트롤러 및 뷰 배선을 안내합니다. DataTable을 Excel로 변환하는 C# 가이드는 다중 시트 내보내기 및 DataSet 지원을 포함한 추가 시나리오를 다룹니다.

열 데이터 유형을 내보낼 때 어떻게 처리합니까?

DataTable 열이 숫자 또는 날짜 값을 포함하는 경우, 문자열로 쓰면 Excel이 셀을 텍스트로 처리하여 정렬, 필터링 및 수식 참조를 비활성화합니다. IronXL은 .ToString()을 호출하지 않고 값을 직접 전달할 때 원래의 유형을 유지합니다:

WorkBook workbook = WorkBook.Create(ExcelFileFormat.XLSX);
WorkSheet worksheet = workbook.CreateWorkSheet("TypedData");

DataTable table = new DataTable();
table.Columns.Add("ID", typeof(int));
table.Columns.Add("Amount", typeof(decimal));
table.Columns.Add("Date", typeof(DateTime));
table.Rows.Add(1, 1500.75m, new DateTime(2025, 6, 15));
table.Rows.Add(2, 3200.00m, new DateTime(2025, 7, 4));

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

// Write typed values -- no .ToString() conversion
for (int row = 0; row < table.Rows.Count; row++)
{
    worksheet.SetCellValue(row + 1, 0, (int)table.Rows[row]["ID"]);
    worksheet.SetCellValue(row + 1, 1, (double)(decimal)table.Rows[row]["Amount"]);
    worksheet[$"C{row + 2}"].Value = (DateTime)table.Rows[row]["Date"];
    worksheet[$"C{row + 2}"].FormatString = "yyyy-MM-dd";
}

workbook.SaveAs("TypedData.xlsx");

WorkBook workbook = WorkBook.Create(ExcelFileFormat.XLSX);
WorkSheet worksheet = workbook.CreateWorkSheet("TypedData");

DataTable table = new DataTable();
table.Columns.Add("ID", typeof(int));
table.Columns.Add("Amount", typeof(decimal));
table.Columns.Add("Date", typeof(DateTime));
table.Rows.Add(1, 1500.75m, new DateTime(2025, 6, 15));
table.Rows.Add(2, 3200.00m, new DateTime(2025, 7, 4));

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

// Write typed values -- no .ToString() conversion
for (int row = 0; row < table.Rows.Count; row++)
{
    worksheet.SetCellValue(row + 1, 0, (int)table.Rows[row]["ID"]);
    worksheet.SetCellValue(row + 1, 1, (double)(decimal)table.Rows[row]["Amount"]);
    worksheet[$"C{row + 2}"].Value = (DateTime)table.Rows[row]["Date"];
    worksheet[$"C{row + 2}"].FormatString = "yyyy-MM-dd";
}

workbook.SaveAs("TypedData.xlsx");

이제 Excel은 Amount 열을 숫자로 정렬할 수 있고 Date 열을 날짜 선택기로 필터링할 수 있습니다. 추가 데이터 형식 패턴에 대해서는 셀 데이터 형식 설정 가이드를 참조하세요. 내보낸 후 데이터를 다시 읽어야 하는 경우 Excel에서 DataTable로 튜토리얼이 역방향 작업을 다룹니다.

IronXL을 어떻게 테스트하고 라이선스합니까?

IronXL은 체험판 라이선스로 개발 시 무료로 사용할 수 있습니다. IronXL의 첫 호출 전에 코드에 키를 적용합니다:

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

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

라이선스 키 적용 가이드는 구성 파일 및 환경 변수를 포함한 모든 배치 옵션을 다루고 있습니다. 클라우드 배포의 경우, Docker 및 Linux 시작 페이지에서 플랫폼별 설정 단계를 다룹니다.

Microsoft는 올레디비 시나리오에 대한 Access Database Engine의 알려진 제한 사항을 문서화하고, NuGet.org는 IronXL 패키지를 전체 버전 기록 및 다운로드 통계와 함께 호스팅합니다. 공식 Open XML SDK 문서는 IronXL이 구현하는 기초적인 XLSX 사양을 설명합니다.

다음 단계는 무엇입니까?

이제 올레디비 드라이버 없이, SQL 구문 없이, 그리고 플랫폼 제한 없이 DataTable을 XLSX 파일로 내보내기 위한 워킹 패턴을 가지고 있습니다. 핵심 워크플로 -- WorkBook.Create(), CreateWorkSheet(), 루프 내에서 SetCellValue(), 그리고 SaveAs() --은 세 행 샘플에서 수십만 행의 데이터 세트로 확장할 수 있습니다.

기존 올레디비 내보내기를 위에서 보여준 기본 IronXL 패턴으로 대체한 후, 데이터 내보내기가 확인되면 스타일링 API를 사용하여 포맷을 추가하세요. IronXL 시작 가이드와 기능 개요는 라이브러리가 지원하는 전체 범위를 이해하기 위한 좋은 다음 읽을 거리입니다. 같은 파이프라인의 일부로 CSV 파일을 작업하는 경우, C# DataTable에서 CSV로 가이드는 동일한 DataTable 객체에서 쉼표로 구분된 출력을 생성하는 방법을 보여줍니다.