IronXL kullanarak C#'da Excel Verilerini Nasıl İçe Alırsınız

IronXL Nasıl Kurulur ve Excel İçe Aktarımına Nasıl Başlanır?

C#'ta Excel içe aktarma, IronXL ile sadece dakikalar alır. Excel kütüphanesi eski XLS ve modern XLSX formatlarını işler, yanı sıra CSV, TSV ve diğer elektronik tablo formatları da. Microsoft.Office.Interop.Excel gibi çözümlere güvenmeyen IronXL, herhangi bir .NET veya .NET Core platformunda bağımsız olarak çalışır.

IronXL'yi NuGet Paket Yöneticisi veya .NET CLI aracılığıyla kurun. Ayrıca Visual Studio'da NuGet Paketlerini Yönetme iletişim kutusunu kullanarak 'IronXL' arayabilirsiniz:

Install-Package IronXL
dotnet add package IronXL

Install-Package IronXL
dotnet add package IronXL

IronXL NuGet kurulum kılavuzuna bakarak, sürüm uyumluluğu ve bağımlılık notları dahil olmak üzere tam kurulum detaylarına ulaşın. Ek bir çalışma zamanı bağımlılığı veya Office bileşeni gerekmez -- paket kendi kendine yeterlidir. Paket kurulduktan sonra, Excel verilerini içe aktarmak basittir:

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);

Imports IronXL

' Load any Excel file
Dim workBook As WorkBook = WorkBook.Load("ProductData.xlsx")
' Access the first worksheet
Dim sheet As WorkSheet = workBook.WorkSheets(0)
' Read a cell value
Dim value As String = sheet("B1").StringValue
Console.WriteLine(value)

Bu kod, temel iş akışını gösterir: bir çalışma kitabını yükleme, bir çalışma sayfasına erişme ve hücre değerlerini okuma. WorkBook.Load() yöntemi, dosya formatını otomatik olarak algılar -- ister XLS, ister XLSX, isterse CSV olsun. Sezgisel indeksleyici sözdizimi sheet["B1"] hücrelere erişimi dizilerle çalışmak kadar doğal hale getirir. Kullanılabilir üyeler ve aşırı yüklemeler için tam referansa, IronXL API dokümantasyonu sayfasından ulaşabilirsiniz.

Excel Verilerini C# Nesnelerine Nasıl Okursunuz?

Gerçek uygulamaların tek hücre değerlerinden fazlasına ihtiyaçı vardır. IronXL, tüm veri setlerini içe aktarma ve bunları kullanışlı C# nesnelerine dönüştürmede mükemmeldir. Yapılandırılmış Excel verilerini içe aktarmanız gerektiğinde, kütüphane, doğrudan alan modellerinizle eşleşen birçok yöntem sunar.

Aşağıdaki örnek bir çalışma sayfasından satırları okur ve her bir satırı yazılmış bir Product nesnesine eşler:

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}"
    );
}

Imports IronXL

' Load the Excel file
Dim workBook As WorkBook = WorkBook.Load("ProductData.xlsx")
Dim sheet As WorkSheet = workBook.DefaultWorkSheet

' Map rows to typed objects
Dim products As New List(Of Product)()
For Each row In sheet.Rows
    Dim product As New Product With {
        .Id = row.Columns(0).IntValue,
        .Name = row.Columns(1).StringValue,
        .Price = row.Columns(2).DecimalValue,
        .IsAvailable = row.Columns(3).BoolValue
    }
    products.Add(product)
Next

For Each product In products
    Console.WriteLine(
        $"Id: {product.Id}, Name: {product.Name}, " &
        $"Price: {product.Price}, Available: {product.IsAvailable}"
    )
Next

Yazılmış özellikler -- IntValue, StringValue, DecimalValue ve BoolValue -- tür dönüşümünü otomatik olarak işler. Bu yaklaşım, karışık veri türleri olan sütunlarla çalışırken manuel ayrıştırmayı azaltır ve hataları azaltır. Birçok geliştirici Stack Overflow'da bu tür güvenli yaklaşımı Excel veri ithalatında takdir ederler.

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);
}

Imports IronXL

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

' Read a named cell range
Dim dataRange As Range = sheet("A1:D5")

' Calculate aggregates directly on a range
Dim sum As Decimal = sheet("C1:C5").Sum()
Console.WriteLine($"Sum of C1:C5: {sum}")

Dim max As Decimal = sheet("C1:C5").Max(Function(c) c.DecimalValue)
Console.WriteLine($"Max of C1:C5: {max}")

' Filter using LINQ
Dim highValueOrders = dataRange _
    .Where(Function(cell) cell.DecimalValue > 100) _
    .Select(Function(cell) cell.Value) _
    .ToList()

Console.WriteLine("Orders above 100:")
For Each order In highValueOrders
    Console.WriteLine(order)
Next

C#'ta Excel Nasıl DataTable'a Dönüştürülür?

DataTable dönüştürme, veri tabanı işlemleri ve veri bağlama senaryoları için esastır. IronXL, Excel'den DataSet veya DataTable'a dönüştürmeyi ele alan yerleşik yöntemler sağlar. Bu özellik, Excel elektronik tablolarını SQL Server veya diğer ilişkisel veritabanlarına içe aktarmanız gerektiğinde özellikle kullanışlıdır. Sonuç nesnesi bir standart System.Data.DataTable olduğundan, veri erişim katmanınızı değiştirmeden herhangi bir ADO.NET uyumlu kod yoluyla çalışır.

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);
}

Imports IronXL
Imports System.Data
Imports System.Data.SqlClient

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

' Convert to DataTable -- first row becomes column headers
Dim dataTable As DataTable = sheet.ToDataTable(True)

' Use SqlBulkCopy to insert directly into SQL Server
Dim connectionString As String = "Data Source=.;Initial Catalog=InventoryDB;Integrated Security=True;"
Using bulkCopy As New SqlBulkCopy(connectionString)
    bulkCopy.DestinationTableName = "Inventory"
    bulkCopy.WriteToServer(dataTable)
End Using

ToDataTable() yöntemi, ilk satırın başlık içerip içermediğini gösteren bir boolean parametresini kabul eder. true ayarlandığında, IronXL otomatik olarak ilk satır değerlerini sütun adları olarak kullanır. Ortaya çıkan DataTable, herhangi bir ek yapılandırma gerektirmeden ADO.NET, Entity Framework ve veri bağlama denetimleriyle entegre olur.

Dönüştürme işlemi üzerinde daha fazla kontrol için DataTable'ı manuel olarak oluşturabilirsiniz:

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();
}

Imports IronXL
Imports System.Data

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

' Build DataTable manually for custom column types or validation
Dim customTable As New DataTable()

For col As Integer = 0 To sheet.ColumnCount - 1
    customTable.Columns.Add($"Column{col + 1}", GetType(String))
Next

For Each row In sheet.Rows
    Dim dataRow = customTable.NewRow()
    For col As Integer = 0 To sheet.ColumnCount - 1
        dataRow(col) = If(row.Columns(col).Value, DBNull.Value)
    Next
    customTable.Rows.Add(dataRow)
Next

' Print headers
For Each column As DataColumn In customTable.Columns
    Console.Write($"{column.ColumnName}" & vbTab)
Next
Console.WriteLine()

' Print data rows
For Each row As DataRow In customTable.Rows
    For Each item In row.ItemArray
        Console.Write($"{item}" & vbTab)
    Next
    Console.WriteLine()
Next

Bu yaklaşım, ithalat sırasında tam esneklik sağlar. Null değerleri graceful bir şekilde DBNull.Value olarak dönüştürülerek veritabanı sütun kısıtlamalarıyla uyumluluk sağlanır. Verileri dosyalara yazma konusunda daha fazla rehberlik için IronXL excel dosya yazma kılavuzuna bakın.

Formüller, Çok Sayfalı Çalışma Kitapları ve Entity Framework ile Nasıl Çalışılır?

IronXL, temel okumanın ötesine geçerek gerçek dünya senaryoları için özellikler sunar. Kütüphane Excel formüllerini korur, hesaplamaların dinamik olarak değerlendirilebilmesini sağlar. Karmaşık Excel çalışma kitapları ile çalışan geliştiriciler için bu, ithalat süreci boyunca veri bütünlüğünü korur.

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)"

Imports IronXL

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

' Read the evaluated result of a formula cell
Dim calculatedTotal As Decimal = sheet("E10").DecimalValue
Console.WriteLine($"Total: {calculatedTotal}")

' Read the formula string itself
Dim formula As String = 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.");

Imports IronXL

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

' Skip the header row, map remaining rows to entity objects
Dim products = sheet.Rows _
    .Skip(1) _
    .Select(Function(row) New Product With {
        .Name = row.Columns(0).StringValue,
        .Price = row.Columns(1).DecimalValue
    }) _
    .ToList()

Using context As New AppDbContext()
    Await context.Products.AddRangeAsync(products)
    Await context.SaveChangesAsync()
End Using

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

Veri İthalatında Hücre Formatlamasını Nasıl Ele Alırsınız?

Excel dosyalarını ithal ettiğinizde, hücre formatlamasını korumak veya incelemek çoğu zaman ham değerleri okumak kadar önemlidir. IronXL, her hücre için yazı tipi, renk, hizalama ve kenar özelliklerini açığa çıkarır, böylece doğrulama kuralları uygulayabilir veya programatik olarak stilleri yeniden üretebilirsiniz. Bu, özellikle görsel formatlamanın anlamsal anlam taşıdığı raporlar için kullanışlıdır - örneğin, renkli hücreler risk seviyelerini gösterir veya kalın satırlar toplamları işaret eder.

Örneğin, hücrelerin kalın metin içerip içermediğini kontrol etmek isteyebilirsiniz - bir satırın özet veya toplam satır olduğunu belirten yaygın bir işaret - ithal edilen veri setinize dahil edip etmeyeceğinize karar vermeden önce:

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}");
}

Imports IronXL

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

For Each row In sheet.Rows
    Dim firstCell = row.Columns(0)

    ' Skip rows where the first cell is bold (typically header or total rows)
    If firstCell.Style.Font.Bold Then
        Continue For
    End If

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

Hücre ve aralık formatlaması üzerine tam bir referans için, sayı format dizeleri ve arka plan rengi erişimi dahil, IronXL hücre formatlama kılavuzuna bakın. İşleme sonrası çıktı dosyalarına birleştirme işlemleri de uygulayabilirsiniz - IronXL hücre birleştirme kılavuzuna bakın.

Projeleriniz İçin Doğru IronXL Lisansını Nasıl Seçersiniz?

IronXL, projenizin ölçeğine uygun esnek lisanslama seçenekleri sunar. Değerlendirme için ücretsiz deneme lisansı mevcuttur, geliştirme sırasında herhangi bir zaman kısıtlaması olmadan tüm özelliklere erişim sağlar. Deneme, çıkış dosyalarına bir filigran ekler, geçerli bir üretim lisansı ile kaldırılır.

Üretim uygulamaları geliştiren ekipler için IronXL lisanslaması bireysel geliştiriciler, ekipler ve organizasyon genelindeki dağıtımlar için seçenekler içerir. Tüm üretim lisansları şunları içerir:

• Telif ücreti olmadan yeniden dağıtım hakları
• IronXL geliştirme ekibinden öncelikli destek
• Lisans süresi boyunca tüm güncel ve küçük sürüm güncellemelerine erişim

IronXL'yi diğer Excel kütüphaneleriyle birlikte değerlendiriyorsanız, IronXL özellik genel özeti, her kademede neyin dahil olduğuna dair ayrıntılı bir döküm sağlar.

Bugün projenizde IronXL kullanmaya başlamak için IronXL ürün sayfasını ziyaret edin veya kuruluma yönelik kılavuzlar, nasıl yapılır makaleleri ve kütüphanedeki her özelliği kapsayan API referansları içeren IronXL belgeleri ile doğrudan başlayın.