IronXL 사용하여 C#에서 Excel 데이터를 가져오는 방법

IronXL을 설치하고 Excel 가져오기를 시작하는 방법은?

IronXL을 사용하여 C#에서 Excel 가져오기를 시작하는 데 몇 분밖에 걸리지 않습니다. Excel 라이브러리는 레거시 XLS 및 최신 XLSX 형식을 모두 처리하며, CSV, TSV 및 기타 스프레드시트 형식도 지원합니다. IronXL은 Microsoft.Office.Interop.Excel에 의존하는 솔루션과는 달리, 어떤 .NET 또는 .NET Core 플랫폼에서든 독립적으로 실행됩니다.

IronXL을 NuGet 패키지 관리자 또는 .NET CLI를 통해 설치하십시오. Visual Studio에서 NuGet 패키지 관리 대화 상자를 사용하여 "IronXL"을 검색할 수도 있습니다:

Install-Package IronXL
dotnet add package IronXL

Install-Package IronXL
dotnet add package IronXL

전체 설치 세부 사항, 버전 호환성 및 종속성 참고사항을 포함하여, IronXL NuGet 설치 가이드를 참조하십시오. 추가 런타임 종속성이나 Office 구성 요소가 필요하지 않습니다. 패키지는 자체 포함되어 있습니다. 패키지를 설치한 후에는 Excel 데이터를 가져오는 것이 간단합니다:

using IronXL;

// Load any Excel file
WorkBook workBook = WorkBook.Load("ProductData.xlsx");
// Access the first worksheet
WorkSheet sheet = workBook.WorkSheets[0];
// Read a cell value
string value = sheet["B1"].StringValue;
Console.WriteLine(value);

using IronXL;

// Load any Excel file
WorkBook workBook = WorkBook.Load("ProductData.xlsx");
// Access the first worksheet
WorkSheet sheet = workBook.WorkSheets[0];
// Read a cell value
string value = sheet["B1"].StringValue;
Console.WriteLine(value);

이 코드는 기본적인 워크플로우를 보여줍니다: 워크북을 로드하고, 워크시트를 접근하며, 셀 값을 읽습니다. WorkBook.Load() 메서드는 파일 포맷을 자동으로 감지하여 XLS, XLSX 또는 CSV 중 어떤 것인지 결정합니다. 직관적인 인덱서 구문 sheet["B1"]은 배열을 다루는 것처럼 셀에 접근하는 것을 자연스럽게 합니다. 사용 가능한 멤버 및 오버로드에 대한 전체 참조는 IronXL API 문서를 참조하세요.

Excel 데이터를 C# 객체로 읽는 방법은 무엇인가요?

실제 애플리케이션은 단일 셀 값 이상을 필요로 합니다. IronXL은 전체 데이터 세트를 가져와 사용 가능한 C# 객체로 변환하는 데 뛰어납니다. 구조화된 Excel 데이터를 가져올 때, 라이브러리는 도메인 모델에 직접 매핑되는 다양한 방법을 제공합니다.

아래 예제에서는 워크시트에서 행을 읽고 각 행을 형식화된 Product 객체에 매핑합니다:

using IronXL;

// Load the Excel file
WorkBook workBook = WorkBook.Load("ProductData.xlsx");
WorkSheet sheet = workBook.DefaultWorkSheet;

// Map rows to typed objects
var products = new List<Product>();
foreach (var row in sheet.Rows)
{
    var product = new Product
    {
        Id = row.Columns[0].IntValue,
        Name = row.Columns[1].StringValue,
        Price = row.Columns[2].DecimalValue,
        IsAvailable = row.Columns[3].BoolValue
    };
    products.Add(product);
}

foreach (var product in products)
{
    Console.WriteLine(
        $"Id: {product.Id}, Name: {product.Name}, " +
        $"Price: {product.Price}, Available: {product.IsAvailable}"
    );
}

using IronXL;

// Load the Excel file
WorkBook workBook = WorkBook.Load("ProductData.xlsx");
WorkSheet sheet = workBook.DefaultWorkSheet;

// Map rows to typed objects
var products = new List<Product>();
foreach (var row in sheet.Rows)
{
    var product = new Product
    {
        Id = row.Columns[0].IntValue,
        Name = row.Columns[1].StringValue,
        Price = row.Columns[2].DecimalValue,
        IsAvailable = row.Columns[3].BoolValue
    };
    products.Add(product);
}

foreach (var product in products)
{
    Console.WriteLine(
        $"Id: {product.Id}, Name: {product.Name}, " +
        $"Price: {product.Price}, Available: {product.IsAvailable}"
    );
}

형식화된 속성인 IntValue, StringValue, DecimalValue, 및 BoolValue는 타입 변환을 자동으로 처리합니다. 이 접근법은 수동 구문 분석을 제거하고 혼합 데이터 유형의 열을 처리할 때 오류를 줄여줍니다. Stack Overflow의 많은 개발자들이 Excel 데이터 가져오기에 대해 이 타입 안전한 접근법을 높이 평가합니다.

using IronXL;

WorkBook workBook = WorkBook.Load("ProductData.xlsx");
WorkSheet sheet = workBook.DefaultWorkSheet;

// Read a named cell range
Range dataRange = sheet["A1:D5"];

// Calculate aggregates directly on a range
decimal sum = sheet["C1:C5"].Sum();
Console.WriteLine($"Sum of C1:C5: {sum}");

decimal max = sheet["C1:C5"].Max(c => c.DecimalValue);
Console.WriteLine($"Max of C1:C5: {max}");

// Filter using LINQ
var highValueOrders = dataRange
    .Where(cell => cell.DecimalValue > 100)
    .Select(cell => cell.Value)
    .ToList();

Console.WriteLine("Orders above 100:");
foreach (var order in highValueOrders)
{
    Console.WriteLine(order);
}

using IronXL;

WorkBook workBook = WorkBook.Load("ProductData.xlsx");
WorkSheet sheet = workBook.DefaultWorkSheet;

// Read a named cell range
Range dataRange = sheet["A1:D5"];

// Calculate aggregates directly on a range
decimal sum = sheet["C1:C5"].Sum();
Console.WriteLine($"Sum of C1:C5: {sum}");

decimal max = sheet["C1:C5"].Max(c => c.DecimalValue);
Console.WriteLine($"Max of C1:C5: {max}");

// Filter using LINQ
var highValueOrders = dataRange
    .Where(cell => cell.DecimalValue > 100)
    .Select(cell => cell.Value)
    .ToList();

Console.WriteLine("Orders above 100:");
foreach (var order in highValueOrders)
{
    Console.WriteLine(order);
}

Excel을 C#의 DataTable로 변환하는 방법은?

DataTable 변환은 데이터베이스 작업 및 데이터 바인딩 시나리오에 필수적입니다. IronXL은 Excel에서 DataSet 또는 DataTable로의 변환을 처리하는 내장 메서드를 제공합니다. 이 기능은 Excel 스프레드시트를 SQL Server 또는 다른 관계형 데이터베이스에 가져와야 할 때 특히 유용합니다. 결과 객체가 표준 System.Data.DataTable이기 때문에 데이터 액세스 레이어의 변경 없이도 ADO.NET 호환 코드 경로와 함께 작동합니다.

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

// Load Excel file
WorkBook workBook = WorkBook.Load("inventory.xlsx");
// Select the first worksheet
WorkSheet sheet = workBook.WorkSheets.First();

// Convert to DataTable -- first row becomes column headers
DataTable dataTable = sheet.ToDataTable(true);

// Use SqlBulkCopy to insert directly into SQL Server
string connectionString = "Data Source=.;Initial Catalog=InventoryDB;Integrated Security=True;";
using (SqlBulkCopy bulkCopy = new SqlBulkCopy(connectionString))
{
    bulkCopy.DestinationTableName = "Inventory";
    bulkCopy.WriteToServer(dataTable);
}

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

// Load Excel file
WorkBook workBook = WorkBook.Load("inventory.xlsx");
// Select the first worksheet
WorkSheet sheet = workBook.WorkSheets.First();

// Convert to DataTable -- first row becomes column headers
DataTable dataTable = sheet.ToDataTable(true);

// Use SqlBulkCopy to insert directly into SQL Server
string connectionString = "Data Source=.;Initial Catalog=InventoryDB;Integrated Security=True;";
using (SqlBulkCopy bulkCopy = new SqlBulkCopy(connectionString))
{
    bulkCopy.DestinationTableName = "Inventory";
    bulkCopy.WriteToServer(dataTable);
}

ToDataTable() 메서드는 첫 번째 행이 헤더를 포함하고 있는지 여부를 나타내는 불리언 매개변수를 받습니다. true로 설정하면 IronXL은 첫 번째 행의 값을 자동으로 열 이름으로 사용합니다. 결과 DataTable은 ADO.NET, Entity Framework 및 데이터 바인딩 컨트롤과 추가 설정 없이 통합됩니다.

변환 과정에 대한 더 많은 제어를 원하면 DataTable을 수동으로 빌드할 수 있습니다:

using IronXL;
using System.Data;

WorkBook workBook = WorkBook.Load("inventory.xlsx");
WorkSheet sheet = workBook.WorkSheets.First();

// Build DataTable manually for custom column types or validation
DataTable customTable = new DataTable();

for (int col = 0; col < sheet.ColumnCount; col++)
{
    customTable.Columns.Add($"Column{col + 1}", typeof(string));
}

foreach (var row in sheet.Rows)
{
    var dataRow = customTable.NewRow();
    for (int col = 0; col < sheet.ColumnCount; col++)
    {
        dataRow[col] = row.Columns[col].Value ?? DBNull.Value;
    }
    customTable.Rows.Add(dataRow);
}

// Print headers
foreach (DataColumn column in customTable.Columns)
{
    Console.Write($"{column.ColumnName}\t");
}
Console.WriteLine();

// Print data rows
foreach (DataRow row in customTable.Rows)
{
    foreach (var item in row.ItemArray)
    {
        Console.Write($"{item}\t");
    }
    Console.WriteLine();
}

using IronXL;
using System.Data;

WorkBook workBook = WorkBook.Load("inventory.xlsx");
WorkSheet sheet = workBook.WorkSheets.First();

// Build DataTable manually for custom column types or validation
DataTable customTable = new DataTable();

for (int col = 0; col < sheet.ColumnCount; col++)
{
    customTable.Columns.Add($"Column{col + 1}", typeof(string));
}

foreach (var row in sheet.Rows)
{
    var dataRow = customTable.NewRow();
    for (int col = 0; col < sheet.ColumnCount; col++)
    {
        dataRow[col] = row.Columns[col].Value ?? DBNull.Value;
    }
    customTable.Rows.Add(dataRow);
}

// Print headers
foreach (DataColumn column in customTable.Columns)
{
    Console.Write($"{column.ColumnName}\t");
}
Console.WriteLine();

// Print data rows
foreach (DataRow row in customTable.Rows)
{
    foreach (var item in row.ItemArray)
    {
        Console.Write($"{item}\t");
    }
    Console.WriteLine();
}

이 접근 방식은 가져오기 시 전체 유연성을 제공합니다. 널 값은 DBNull.Value로 변환하여 데이터베이스 열 제약 조건과 호환성을 보장함으로써 우아하게 처리됩니다. 파일에 데이터를 다시 쓰는 것에 대한 추가 지침은 IronXL Excel 파일 쓰기 가이드를 참조하세요.

수식, 다중 시트 워크북 및 Entity Framework를 어떻게 작업합니까?

IronXL은 보다 복잡한 실제 시나리오를 위한 기능을 지원하여 기본 읽기를 초월합니다. 라이브러리는 Excel 수식을 보존하여 계산을 동적으로 평가할 수 있도록 합니다. 복잡한 Excel 워크북을 다루는 개발자에게 이는 가져오기 과정에서 데이터 무결성을 유지합니다.

using IronXL;

WorkBook workBook = WorkBook.Load("FinancialReport.xlsx");
WorkSheet sheet = workBook.GetWorkSheet("Reports");

// Read the evaluated result of a formula cell
decimal calculatedTotal = sheet["E10"].DecimalValue;
Console.WriteLine($"Total: {calculatedTotal}");

// Read the formula string itself
string formula = sheet["E10"].Formula;
Console.WriteLine($"Formula: {formula}"); // e.g. "=SUM(E2:E9)"

using IronXL;

WorkBook workBook = WorkBook.Load("FinancialReport.xlsx");
WorkSheet sheet = workBook.GetWorkSheet("Reports");

// Read the evaluated result of a formula cell
decimal calculatedTotal = sheet["E10"].DecimalValue;
Console.WriteLine($"Total: {calculatedTotal}");

// Read the formula string itself
string formula = sheet["E10"].Formula;
Console.WriteLine($"Formula: {formula}"); // e.g. "=SUM(E2:E9)"

using IronXL;

WorkBook workBook = WorkBook.Load("ProductData.xlsx");
WorkSheet sheet = workBook.DefaultWorkSheet;

// Skip the header row, map remaining rows to entity objects
var products = sheet.Rows
    .Skip(1)
    .Select(row => new Product
    {
        Name = row.Columns[0].StringValue,
        Price = row.Columns[1].DecimalValue
    })
    .ToList();

using var context = new AppDbContext();
await context.Products.AddRangeAsync(products);
await context.SaveChangesAsync();

Console.WriteLine($"Imported {products.Count} products.");

using IronXL;

WorkBook workBook = WorkBook.Load("ProductData.xlsx");
WorkSheet sheet = workBook.DefaultWorkSheet;

// Skip the header row, map remaining rows to entity objects
var products = sheet.Rows
    .Skip(1)
    .Select(row => new Product
    {
        Name = row.Columns[0].StringValue,
        Price = row.Columns[1].DecimalValue
    })
    .ToList();

using var context = new AppDbContext();
await context.Products.AddRangeAsync(products);
await context.SaveChangesAsync();

Console.WriteLine($"Imported {products.Count} products.");

가져오기 시 셀 서식을 어떻게 처리합니까?

Excel 파일을 가져올 때, 셀 서식을 보존하거나 검사하는 것은 원시 값을 읽는 것만큼이나 중요할 때가 많습니다. IronXL은 모든 셀의 폰트, 색상, 정렬 및 테두리 속성을 공개하여 유효성 검사 규칙을 적용하거나 스타일을 프로그래밍 방식으로 재현할 수 있습니다. 이는 시각적인 서식이 의미론적 의미를 갖는 보고서에서 특히 유용합니다. 예를 들어, 위험 수준을 나타내는 색상으로 된 셀 또는 합계를 나타내는 굵은 행.

예를 들어, 셀이 굵은 텍스트를 포함하는지 확인하고 싶을 수 있습니다. 이는 행이 요약 또는 합계 행이라는 일반적인 신호로, 가져온 데이터 집합에 포함할지 여부를 결정하기 전에.

using IronXL;

WorkBook workBook = WorkBook.Load("StyledReport.xlsx");
WorkSheet sheet = workBook.DefaultWorkSheet;

foreach (var row in sheet.Rows)
{
    var firstCell = row.Columns[0];

    // Skip rows where the first cell is bold (typically header or total rows)
    if (firstCell.Style.Font.Bold)
    {
        continue;
    }

    Console.WriteLine($"Data row: {firstCell.StringValue}");
}

using IronXL;

WorkBook workBook = WorkBook.Load("StyledReport.xlsx");
WorkSheet sheet = workBook.DefaultWorkSheet;

foreach (var row in sheet.Rows)
{
    var firstCell = row.Columns[0];

    // Skip rows where the first cell is bold (typically header or total rows)
    if (firstCell.Style.Font.Bold)
    {
        continue;
    }

    Console.WriteLine($"Data row: {firstCell.StringValue}");
}

셀 및 범위 서식에 대한 전체 참조 자료, 숫자 서식 문자열 및 배경색 액세스를 포함하여 IronXL 셀 서식 가이드를 참조하십시오. 처리 후 출력 파일에 병합 작업을 적용할 수도 있습니다 -- IronXL 셀 병합 가이드를 참조하십시오.

프로젝트에 맞는 IronXL 라이센스를 어떻게 선택하나요?

IronXL은 프로젝트의 규모에 맞춰 유연한 라이센스 옵션을 제공합니다. 무료 체험 라이센스는 평가용으로 제공되며 개발 중에는 시간 제한 없이 모든 기능을 사용할 수 있습니다. 체험판은 출력 파일에 워터마크를 추가하며, 유효한 상용 라이센스로 제거됩니다.

상용 애플리케이션을 구축하는 팀의 경우, IronXL 라이센스에는 개별 개발자, 팀, 조직 전체 배포를 위한 옵션이 포함됩니다. 모든 상용 라이센스에는 다음이 포함됩니다:

• 로열티 없는 재배포 권한
• IronXL 개발 팀의 우선 지원
• 라이센스 기간 동안 현재 버전 및 하위 버전 업데이트 액세스

IronXL을 다른 Excel 라이브러리와 함께 평가 중인 경우, IronXL 기능 개요에서 각 티어에 포함된 세부 목록을 확인할 수 있습니다.

오늘 프로젝트에서 IronXL 사용을 시작하려면 IronXL 제품 페이지를 방문하거나 IronXL 문서에서 설정 가이드, 사용법 기사, 라이브러리의 모든 기능을 다루는 API 참조를 시작하세요.