IronXL 사용하여 C#에서 데이터셋을 Excel로 변환하는 방법

DataSet을 엑셀로 변환하는 것이 왜 중요한가요?

.NET에서 DataSet은 행, 열, 및 관계가 있는 하나 이상의 DataTables을 포함하는 메모리 내 데이터 캐시를 나타냅니다. DataSets을 엑셀로 변환하면 다음을 가능하게 합니다:

• 비즈니스 보고: 데이터베이스 쿼리를 이해관계자를 위한 형식화된 스프레드시트로 변환합니다.
• 데이터 보관: 장기 저장 및 분석을 위해 응용 프로그램 데이터를 내보냅니다.
• 크로스 플랫폼 호환성: 사용자가 응용 프로그램에 액세스할 수 없는 경우 데이터를 공유합니다.
• 향상된 시각화: Excel의 내장 차트 및 분석 도구가 최종 사용자에게 제공됩니다.

IronXL은 서버나 개발 컴퓨터에 Excel이 설치되지 않아도 변환을 수행하는 직관적인 API를 제공하여 이 과정을 간소화합니다. 이 라이브러리는 .NET Framework 4.6.2 이상, .NET Core 및 .NET 5부터 .NET 10까지 지원하여, Linux 컨테이너 및 클라우드 환경에 배포된 현대 응용 프로그램에 적합합니다. 지원되는 플랫폼에 대한 자세한 내용은 IronXL 기능 페이지를 방문하세요.

IronXL을 .NET 프로젝트에 설치하는 방법은 무엇입니까?

IronXL 설정은 몇 분이면 완료됩니다. Visual Studio를 열어 프로젝트로 이동한 후 NuGet 패키지 관리자를 통해 IronXL을 설치하세요. 전체 설정 지침은 IronXL 시작 가이드를 참조하십시오.

패키지 관리자 콘솔 또는 .NET CLI를 사용하여 다음 중 하나를 실행하십시오:

Install-Package IronXl.Excel
dotnet add package IronXl.Excel

Install-Package IronXl.Excel
dotnet add package IronXl.Excel

또한, NuGet 패키지 관리자 UI에서 'IronXl.Excel'을 검색하고 설치를 클릭하십시오. 패키지가 자동으로 다운로드되고 필요한 모든 종속성이 구성됩니다. 추가 설치 옵션은 IronXL NuGet 설치 가이드에서 찾을 수 있습니다.

설치가 완료되면 IronXL 네임스페이스를 C# 파일에 추가하십시오:

using IronXL;
using System.Data;

using IronXL;
using System.Data;

이러한 임포트를 실행하면 DataSets을 엑셀 파일로 변환할 준비가 됩니다. 기업 환경에서는 적절한 배포 구성을 보장하기 위해 라이선스 옵션 및 체험판 라이선스 페이지를 검토하십시오.

using IronXL;
using System.Data;

// Create a sample DataSet with product information
DataSet dataSet = new DataSet("ProductData");

// Create a DataTable for products
DataTable productsTable = new DataTable("Products");
productsTable.Columns.Add("ProductID", typeof(int));
productsTable.Columns.Add("ProductName", typeof(string));
productsTable.Columns.Add("Price", typeof(decimal));
productsTable.Columns.Add("InStock", typeof(bool));

// Add sample rows
productsTable.Rows.Add(1, "Laptop", 999.99m, true);
productsTable.Rows.Add(2, "Mouse", 19.99m, true);
productsTable.Rows.Add(3, "Keyboard", 49.99m, false);
productsTable.Rows.Add(4, "Monitor", 299.99m, true);
productsTable.Rows.Add(5, "Headphones", 79.99m, true);

// Add the DataTable to the DataSet
dataSet.Tables.Add(productsTable);

// Export DataSet to Excel using IronXL
WorkBook workBook = WorkBook.Create(ExcelFileFormat.XLSX);
WorkBook.LoadWorkSheetsFromDataSet(dataSet, workBook);

// Save the Excel file
workBook.SaveAs("ProductData.xlsx");

using IronXL;
using System.Data;

// Create a sample DataSet with product information
DataSet dataSet = new DataSet("ProductData");

// Create a DataTable for products
DataTable productsTable = new DataTable("Products");
productsTable.Columns.Add("ProductID", typeof(int));
productsTable.Columns.Add("ProductName", typeof(string));
productsTable.Columns.Add("Price", typeof(decimal));
productsTable.Columns.Add("InStock", typeof(bool));

// Add sample rows
productsTable.Rows.Add(1, "Laptop", 999.99m, true);
productsTable.Rows.Add(2, "Mouse", 19.99m, true);
productsTable.Rows.Add(3, "Keyboard", 49.99m, false);
productsTable.Rows.Add(4, "Monitor", 299.99m, true);
productsTable.Rows.Add(5, "Headphones", 79.99m, true);

// Add the DataTable to the DataSet
dataSet.Tables.Add(productsTable);

// Export DataSet to Excel using IronXL
WorkBook workBook = WorkBook.Create(ExcelFileFormat.XLSX);
WorkBook.LoadWorkSheetsFromDataSet(dataSet, workBook);

// Save the Excel file
workBook.SaveAs("ProductData.xlsx");

// Save as legacy XLS format
workBook.SaveAs("ProductData.xls");

// Save as CSV (comma-separated values)
workBook.SaveAsCsv("ProductData.csv");

// Save as TSV (tab-separated values)
workBook.SaveAs("ProductData.tsv");

// Save as legacy XLS format
workBook.SaveAs("ProductData.xls");

// Save as CSV (comma-separated values)
workBook.SaveAsCsv("ProductData.csv");

// Save as TSV (tab-separated values)
workBook.SaveAs("ProductData.tsv");

데이터베이스 데이터를 Excel로 직접 내보내려면 어떻게 해야 하나요?

실제 적용에서는 SQL 데이터베이스에서 데이터를 내보내는 것이 종종 필요합니다. 다음 예제는 데이터베이스를 쿼리하고 C# 최상위 문을 사용하여 결과를 Excel로 내보냅니다:

using IronXL;
using System.Data;
using System.Data.SqlClient;

string connectionString = "Data Source=server;Initial Catalog=SampleDB;Integrated Security=True";
string query = "SELECT OrderID, CustomerName, OrderDate, TotalAmount FROM Orders WHERE OrderDate >= '2024-01-01'";

DataSet dataSet = new DataSet();

// Populate DataSet from database
using (SqlConnection connection = new SqlConnection(connectionString))
{
    using (SqlDataAdapter adapter = new SqlDataAdapter(query, connection))
    {
        adapter.Fill(dataSet, "Orders");
    }
}

// Create Excel workbook and load data
WorkBook workBook = WorkBook.Create();
WorkBook.LoadWorkSheetsFromDataSet(dataSet, workBook);

// Auto-size columns for readability
WorkSheet worksheet = workBook.WorkSheets[0];
for (int i = 0; i < worksheet.Columns.Count(); i++)
{
    worksheet.AutoSizeColumn(i);
}

// Save with timestamp in filename
string fileName = $"OrdersExport_{DateTime.Now:yyyyMMdd_HHmmss}.xlsx";
workBook.SaveAs(fileName);

using IronXL;
using System.Data;
using System.Data.SqlClient;

string connectionString = "Data Source=server;Initial Catalog=SampleDB;Integrated Security=True";
string query = "SELECT OrderID, CustomerName, OrderDate, TotalAmount FROM Orders WHERE OrderDate >= '2024-01-01'";

DataSet dataSet = new DataSet();

// Populate DataSet from database
using (SqlConnection connection = new SqlConnection(connectionString))
{
    using (SqlDataAdapter adapter = new SqlDataAdapter(query, connection))
    {
        adapter.Fill(dataSet, "Orders");
    }
}

// Create Excel workbook and load data
WorkBook workBook = WorkBook.Create();
WorkBook.LoadWorkSheetsFromDataSet(dataSet, workBook);

// Auto-size columns for readability
WorkSheet worksheet = workBook.WorkSheets[0];
for (int i = 0; i < worksheet.Columns.Count(); i++)
{
    worksheet.AutoSizeColumn(i);
}

// Save with timestamp in filename
string fileName = $"OrdersExport_{DateTime.Now:yyyyMMdd_HHmmss}.xlsx";
workBook.SaveAs(fileName);

이 예는 데이터베이스 쿼리에서 엑셀 파일로의 완전한 워크플로를 보여줍니다. SqlDataAdapter가 쿼리 결과로 DataSet을 채우고, IronXL이 이를 포맷된 엑셀 파일로 변환합니다. 자동 크기 조정 기능은 수동으로 열 너비를 조정하지 않고도 모든 데이터를 볼 수 있도록 보장합니다. 더 큰 데이터셋을 처리하려면 Excel을 DataSet으로 변환하는 방법 안내서 및 워크북으로 데이터 가져오기를 참조하세요.

하나의 엑셀 파일에서 여러 DataTables을 어떻게 처리하나요?

관련된 데이터를 작업할 때, 단일 DataSet은 여러 DataTables을 포함할 수 있습니다. IronXL은 각 테이블을 별도의 워크시트로 자동 변환합니다:

using IronXL;
using System.Data;

DataSet dataSet = new DataSet("CompanyData");

// Create Employees table
DataTable employeesTable = new DataTable("Employees");
employeesTable.Columns.Add("EmployeeID", typeof(int));
employeesTable.Columns.Add("Name", typeof(string));
employeesTable.Columns.Add("Department", typeof(string));
employeesTable.Rows.Add(1, "John Smith", "Sales");
employeesTable.Rows.Add(2, "Jane Doe", "Marketing");

// Create Departments table
DataTable departmentsTable = new DataTable("Departments");
departmentsTable.Columns.Add("DepartmentName", typeof(string));
departmentsTable.Columns.Add("Budget", typeof(decimal));
departmentsTable.Rows.Add("Sales", 100000m);
departmentsTable.Rows.Add("Marketing", 75000m);

// Add both tables to DataSet
dataSet.Tables.Add(employeesTable);
dataSet.Tables.Add(departmentsTable);

// Convert to Excel -- each DataTable becomes a worksheet
WorkBook workBook = WorkBook.Create();
WorkBook.LoadWorkSheetsFromDataSet(dataSet, workBook);

// Rename worksheets for clarity
workBook.WorkSheets[0].Name = "Employee List";
workBook.WorkSheets[1].Name = "Department Budgets";

workBook.SaveAs("CompanyData.xlsx");

using IronXL;
using System.Data;

DataSet dataSet = new DataSet("CompanyData");

// Create Employees table
DataTable employeesTable = new DataTable("Employees");
employeesTable.Columns.Add("EmployeeID", typeof(int));
employeesTable.Columns.Add("Name", typeof(string));
employeesTable.Columns.Add("Department", typeof(string));
employeesTable.Rows.Add(1, "John Smith", "Sales");
employeesTable.Rows.Add(2, "Jane Doe", "Marketing");

// Create Departments table
DataTable departmentsTable = new DataTable("Departments");
departmentsTable.Columns.Add("DepartmentName", typeof(string));
departmentsTable.Columns.Add("Budget", typeof(decimal));
departmentsTable.Rows.Add("Sales", 100000m);
departmentsTable.Rows.Add("Marketing", 75000m);

// Add both tables to DataSet
dataSet.Tables.Add(employeesTable);
dataSet.Tables.Add(departmentsTable);

// Convert to Excel -- each DataTable becomes a worksheet
WorkBook workBook = WorkBook.Create();
WorkBook.LoadWorkSheetsFromDataSet(dataSet, workBook);

// Rename worksheets for clarity
workBook.WorkSheets[0].Name = "Employee List";
workBook.WorkSheets[1].Name = "Department Budgets";

workBook.SaveAs("CompanyData.xlsx");

당신의 DataSet의 각 DataTable은 엑셀 파일의 별도 워크시트가 되어 당신의 데이터의 논리적 분리를 유지합니다. 이 방법은 단일 파일 내에서 서로 다른 데이터 범주에 대한 별도의 워크시트가 필요한 보고서를 작성하는 데 특히 유용합니다.

Excel 내보내기에 서식을 추가하는 방법은?

IronXL은 기본 서식을 자동으로 처리하지만, 추가 스타일링으로 Excel 내보내기를 강화하여 전문적인 보고서를 만들 수 있습니다:

using IronXL;

// Assume workBook is already populated from DataSet
WorkSheet worksheet = workBook.WorkSheets[0];

// Style the header row
IronXl.Range headerRange = worksheet.GetRange("A1:D1");
headerRange.Style.Font.Bold = true;
headerRange.Style.BackgroundColor = "#4472C4";
headerRange.Style.Font.Color = "#FFFFFF";

// Format currency column (column C, rows 2 onward)
for (int rowIndex = 1; rowIndex < worksheet.RowCount; rowIndex++)
{
    worksheet[$"C{rowIndex + 1}"].FormatString = "$#,##0.00";
}

// Add borders to the data range
IronXl.Range dataRange = worksheet.GetRange($"A1:D{worksheet.RowCount}");
dataRange.Style.Border.TopBorder.Type = IronXl.Styles.BorderType.Thin;
dataRange.Style.Border.BottomBorder.Type = IronXl.Styles.BorderType.Thin;

workBook.SaveAs("FormattedExport.xlsx");

using IronXL;

// Assume workBook is already populated from DataSet
WorkSheet worksheet = workBook.WorkSheets[0];

// Style the header row
IronXl.Range headerRange = worksheet.GetRange("A1:D1");
headerRange.Style.Font.Bold = true;
headerRange.Style.BackgroundColor = "#4472C4";
headerRange.Style.Font.Color = "#FFFFFF";

// Format currency column (column C, rows 2 onward)
for (int rowIndex = 1; rowIndex < worksheet.RowCount; rowIndex++)
{
    worksheet[$"C{rowIndex + 1}"].FormatString = "$#,##0.00";
}

// Add borders to the data range
IronXl.Range dataRange = worksheet.GetRange($"A1:D{worksheet.RowCount}");
dataRange.Style.Border.TopBorder.Type = IronXl.Styles.BorderType.Thin;
dataRange.Style.Border.BottomBorder.Type = IronXl.Styles.BorderType.Thin;

workBook.SaveAs("FormattedExport.xlsx");

이러한 서식 옵션은 평범한 데이터 내보내기를 전문적으로 보이는 스프레드시트로 변환합니다. 스타일링 기능에는 글꼴 속성, 색상, 테두리 및 숫자 형식이 포함되어 있어 조직의 보고 기준에 맞는 내보내기를 생성할 수 있습니다. 셀 수준의 서식에 대한 자세한 내용은 IronXL 셀 서식 안내서를 참조하십시오.

배포 전에 알아야 할 사항은?

생산에 DataSet-to-Excel 파이프라인을 배포하기 전에 다음 사항들을 확인하십시오:

라이센스: 제작 용도로 IronXL은 유효한 라이센스 키가 필요합니다. 무료 체험 라이센스로 시작하고 필요한 경우 유료 플랜으로 업그레이드할 수 있습니다. 라이센스 등급은 IronXL 라이센스 페이지에 자세히 나와 있습니다.

오류 처리: 워크북 생성 및 파일 저장 작업 주변에 시도-잡기 블록을 구현하십시오. IronXL에 전달하기 전에 테이블과 열이 널이 아님을 확인하여 DataSet 내용을 검증하십시오. 생산 환경에서 문제를 진단할 수 있는 충분한 컨텍스트로 실패를 기록하십시오.

파일 경로 관리: 컨테이너화된 환경에서는 출력 경로를 위해 환경 변수 또는 볼륨 마운트를 사용하십시오. 모든 배포 대상에 존재하지 않을 수 있는 하드코딩 경로를 피하십시오. 다음은 컨테이너 친화적인 패턴입니다:

using IronXL;

string outputPath = Environment.GetEnvironmentVariable("EXCEL_OUTPUT_PATH") ?? "/app/output";
string fileName = System.IO.Path.Combine(outputPath, $"Export_{Guid.NewGuid()}.xlsx");
workBook.SaveAs(fileName);

using IronXL;

string outputPath = Environment.GetEnvironmentVariable("EXCEL_OUTPUT_PATH") ?? "/app/output";
string fileName = System.IO.Path.Combine(outputPath, $"Export_{Guid.NewGuid()}.xlsx");
workBook.SaveAs(fileName);

플랫폼 지원: 대상 환경이 IronXL 기능 페이지에 나열되어 있는지 확인하십시오. IronXL은 Windows, Linux, macOS, Docker, AWS, Azure를 기본적으로 지원합니다.

핵심 이점 요약:

• Microsoft Office 종속성 없음 -- 서버 및 컨테이너 배치에 적합
• 여러 Excel 형식(XLSX, XLS, CSV, TSV) 지원
• 자동 워크시트 생성 DataTables
• 클라우드 및 컨테이너 배치에 대한 크로스 플랫폼 호환성
• 직관적인 API는 전체 DataSets을 변환하는 데 최소한의 코드를 요구합니다

차트 생성, 공식 지원, 고급 서식 지정과 같은 추가 기능을 탐색하려면 IronXL 문서 및 IronXL 사용 방법 라이브러리를 방문하세요.