.NET Core CSV Okuyucuyu IronXL ile Nasıl Kullanırsınız: Pratik Örnekler

Neden IronXL'i .NET Core CSV Okuyucusu Olarak Seçmelisiniz?

.NET Core için bir CSV okuyucu seçerken, IronXL'nin geleneksel CSV ayrıştırma kütüphanelerine göre birçok çekici avantajı vardır. IronXL, geriye dönük uyumluluğu .NET Framework projeleriyle korurken, .NET Core'un modern mimarisiyle entegre olur. Bu çözüm, geliştiricilerin CSV dosya işlemleriyle çalışırken karşılaştıkları yaygın sorunları ortadan kaldırır, bunlar arasında:

• Uluslararası karakter setleri için otomatik kodlama algılama
• Manuel yapılandırma gerektirmeyen akıllı ayırıcı tanıma
• Kilobayttan gigabayta kadar dosyalar için bellek verimli işlem
• Yerleşik veri tipi çıkarımı ve dönüştürme
• Platformlar arası satır başı ve satır besleme yönetimi
• CSV verileriyle çalışırken bile Excel formül desteği
• Windows, Linux ve macOS'ta platformlar arası güvenilirlik

Kapsamlı yapılandırma ve manuel ayrıştırma mantığı gerektiren temel CSV okuyucularından farklı olarak, IronXL ayraçlar içeren tırnaklı alanlar, çok satırlı hücre değerleri ve özel karakterler gibi kenar durumları otomatik olarak işler. Kütüphanenin mimarisi, küçük yapılandırma dosyalarından büyük ölçekli veri işleme görevlerine uygun hale getiren tembel yükleme ve akış yetenekleriyle optimum performans sağlar. IronXL, gerektiğinde başlık satırlarını atlayabilir ve karmaşık veri yapısını verimli bir şekilde bölebilir. IronXL özellikler incelemesi bölümünde daha fazla bilgi edinin.

Miras sistemlerden geçiş yapan geliştiriciler için IronXL, öğrenme eğrisini azaltan ve tepkisel uygulamalar için modern async/await modelleri sunan tanıdık bir API sağlar. Bu, verilerini işleme altyapılarını modernize eden ekipler için ideal bir seçim yapar. API referansları ve yapılandırma seçenekleri için tam IronXL belgelerine bakın.

IronXL'i CSV Dosya Okuma için Nasıl Yükleyebilirsiniz?

Bir konsol uygulaması, ASP.NET Core web uygulaması veya Windows Forms uygulaması geliştiriyor olsanız da, .NET Core projenize IronXL kurmak sadece birkaç saniye sürer. .NET Core'da CSV dosyalarını etkili bir şekilde ayrıştırmak ve CSV verilerini okumaya başlamak için Visual Studio'da Paket Yöneticisi Konsolu'nu açın ve şunu çalıştırın:

Install-Package IronXl.Excel

Install-Package IronXl.Excel

Ya da .NET CLI kullanın:

dotnet add package IronXl.Excel

dotnet add package IronXl.Excel

Alternatif olarak, "IronXl.Excel" aratarak ve yükleme butonuna tıklayarak NuGet Paket Yöneticisi UI'sini kullanabilirsiniz. Bu kütüphane, .NET Core'a geçiş sırasında mevcut .NET Framework projeleriyle entegre olabilir. IronXL NuGet sayfasından doğrudan referans da verebilirsiniz.

Kurulduktan sonra, kodunuza namespace ekleyin:

using IronXL;

using IronXL;

Imports IronXL

Bu kurulum, Microsoft Office veya Interop bağımlılıkları gerektirmeden güçlü CSV okuma yeteneklerine erişmenizi sağlar ve bu da bulut dağıtımı ve Docker konteynerleri için idealdir. Detaylı kurulum talimatları ve yapılandırma ayarları için, IronXL kurulum kılavuzu belgelerine göz atın.

IronXL'in LoadCSV Yöntemi Kullanılarak CSV Dosyaları Nasıl Okunur?

IronXL, CSV dosya işlemini LoadCSV yöntemi ile kolaylaştırır, bu yöntem CSV başlıklarını, CSV sütunlarını ve CSV satırlarını verimli bir şekilde işler, aşağıdaki örnekte gösterildiği gibi:

// Load CSV file into a WorkBook object for .NET Core CSV reading
var workbook = WorkBook.LoadCSV("Budget.csv",
    fileFormat: ExcelFileFormat.XLSX,
    listDelimiter: ",");
// Access the default worksheet containing parsed CSV data
WorkSheet worksheet = workbook.DefaultWorkSheet;
// Read specific cell values with type-safe methods
string cellValue = worksheet["A1"].StringValue;
// Iterate through a range for bulk CSV data processing
foreach (var cell in worksheet["A1:C10"])
{
    Console.WriteLine($"Cell {cell.AddressString}: {cell.Text}");
}

// Load CSV file into a WorkBook object for .NET Core CSV reading
var workbook = WorkBook.LoadCSV("Budget.csv",
    fileFormat: ExcelFileFormat.XLSX,
    listDelimiter: ",");
// Access the default worksheet containing parsed CSV data
WorkSheet worksheet = workbook.DefaultWorkSheet;
// Read specific cell values with type-safe methods
string cellValue = worksheet["A1"].StringValue;
// Iterate through a range for bulk CSV data processing
foreach (var cell in worksheet["A1:C10"])
{
    Console.WriteLine($"Cell {cell.AddressString}: {cell.Text}");
}

Imports IronXL

' Load CSV file into a WorkBook object for .NET Core CSV reading
Dim workbook = WorkBook.LoadCSV("Budget.csv", fileFormat:=ExcelFileFormat.XLSX, listDelimiter:=",")

' Access the default worksheet containing parsed CSV data
Dim worksheet As WorkSheet = workbook.DefaultWorkSheet

' Read specific cell values with type-safe methods
Dim cellValue As String = worksheet("A1").StringValue

' Iterate through a range for bulk CSV data processing
For Each cell In worksheet("A1:C10")
    Console.WriteLine($"Cell {cell.AddressString}: {cell.Text}")
Next

LoadCSV yöntemi, optimize edilmiş bellek akış yönetimi kullanılarak bellekte CSV veri yapınızı temsil eden bir WorkBook nesnesi oluşturur. fileFormat parametresi, işleme için dahili formatı belirtirken, listDelimiter CSV dosyanızda kullanılan CSV ayırıcı karakterini tanımlar -- sekmeyle ayrılmış dosyaları ve boru ile ayrılmış formatları destekler.

public record Customer(string Name, int Age, string City)
{
    public bool IsValid() => !string.IsNullOrEmpty(Name) && Age > 0;
}

// Parse CSV rows into typed objects
var customers = new List<Customer>();
for (int row = 2; row <= worksheet.RowCount; row++)
{
    var customer = new Customer(
        Name: worksheet[$"A{row}"].StringValue,
        Age:  worksheet[$"B{row}"].IntValue,
        City: worksheet[$"C{row}"].StringValue
    );
    if (customer.IsValid())
        customers.Add(customer);
}
// Output the records
foreach (var record in customers)
{
    Console.WriteLine($"Customer: {record.Name}, Age: {record.Age}, City: {record.City}");
}

public record Customer(string Name, int Age, string City)
{
    public bool IsValid() => !string.IsNullOrEmpty(Name) && Age > 0;
}

// Parse CSV rows into typed objects
var customers = new List<Customer>();
for (int row = 2; row <= worksheet.RowCount; row++)
{
    var customer = new Customer(
        Name: worksheet[$"A{row}"].StringValue,
        Age:  worksheet[$"B{row}"].IntValue,
        City: worksheet[$"C{row}"].StringValue
    );
    if (customer.IsValid())
        customers.Add(customer);
}
// Output the records
foreach (var record in customers)
{
    Console.WriteLine($"Customer: {record.Name}, Age: {record.Age}, City: {record.City}");
}

Imports System
Imports System.Collections.Generic

Public Class Customer
    Public Property Name As String
    Public Property Age As Integer
    Public Property City As String

    Public Sub New(name As String, age As Integer, city As String)
        Me.Name = name
        Me.Age = age
        Me.City = city
    End Sub

    Public Function IsValid() As Boolean
        Return Not String.IsNullOrEmpty(Name) AndAlso Age > 0
    End Function
End Class

' Parse CSV rows into typed objects
Dim customers As New List(Of Customer)()
For row As Integer = 2 To worksheet.RowCount
    Dim customer As New Customer(
        Name:=worksheet($"A{row}").StringValue,
        Age:=worksheet($"B{row}").IntValue,
        City:=worksheet($"C{row}").StringValue
    )
    If customer.IsValid() Then
        customers.Add(customer)
    End If
Next

' Output the records
For Each record In customers
    Console.WriteLine($"Customer: {record.Name}, Age: {record.Age}, City: {record.City}")
Next

Farklı Ayraçlarınızı Nasıl Yönetirsiniz ve DataTable'a Nasıl Dönüştürürsünüz?

Gerçek dünya CSV dosya formatları, genellikle virgüllerin ötesinde çeşitli ayraçlar kullanır ve esnek yönetim gerektirir. IronXL, otomatik ayıraç algılama ile bunu zarif bir şekilde yönetir:

// Load CSV with semicolon delimiter
WorkBook workbook = WorkBook.LoadCSV("products.csv",
    fileFormat: ExcelFileFormat.XLSX,
    listDelimiter: ";");
WorkSheet worksheet = workbook.DefaultWorkSheet;
// Convert to DataTable for database operations
DataTable dataTable = worksheet.ToDataTable(true);
// Process the DataTable
foreach (DataRow row in dataTable.Rows)
{
    Console.WriteLine($"Product: {row["ProductName"]}, Price: {row["Price"]}");
}

// Load CSV with semicolon delimiter
WorkBook workbook = WorkBook.LoadCSV("products.csv",
    fileFormat: ExcelFileFormat.XLSX,
    listDelimiter: ";");
WorkSheet worksheet = workbook.DefaultWorkSheet;
// Convert to DataTable for database operations
DataTable dataTable = worksheet.ToDataTable(true);
// Process the DataTable
foreach (DataRow row in dataTable.Rows)
{
    Console.WriteLine($"Product: {row["ProductName"]}, Price: {row["Price"]}");
}

Imports IronXL
Imports System.Data

' Load CSV with semicolon delimiter
Dim workbook As WorkBook = WorkBook.LoadCSV("products.csv", fileFormat:=ExcelFileFormat.XLSX, listDelimiter:=";")
Dim worksheet As WorkSheet = workbook.DefaultWorkSheet
' Convert to DataTable for database operations
Dim dataTable As DataTable = worksheet.ToDataTable(True)
' Process the DataTable
For Each row As DataRow In dataTable.Rows
    Console.WriteLine($"Product: {row("ProductName")}, Price: {row("Price")}")
Next

ToDataTable yöntemi, çalışma sayfası verilerini bir .NET DataTable türüne dönüştürür, boole parametresi ilk satırın kolon başlıkları olarak kullanılıp kullanılmayacağını belirtir. Bu dönüşüm, veritabanı işlemleri, ASP.NET Core uygulamalarında veri bağlama veya SQL Server entegrasyonu için mevcut DataTable işleme mantığının uygulanması gerektiğinde özellikle yararlıdır. Ortaya çıkan DataTable, veri türlerini ve şema bilgisini korur ve etkili toplu ekleme işlemleri için doğrudan SqlBulkCopy ile kullanılabilir.

CSV'i DataTable'a import etme ve veritabanı entegrasyonu hakkında detaylı kılavuzlarda daha fazla bilgi edinin.

// Load a DataTable from your data source
DataTable exportTable = GetProcessedData(); // your data source method

// Create a new workbook and populate it from the DataTable
WorkBook outputWorkbook = WorkBook.Create(ExcelFileFormat.XLSX);
WorkSheet outputSheet = outputWorkbook.DefaultWorkSheet;

// Write headers from DataTable columns
for (int col = 0; col < exportTable.Columns.Count; col++)
{
    outputSheet[0, col].Value = exportTable.Columns[col].ColumnName;
}

// Write rows
for (int row = 0; row < exportTable.Rows.Count; row++)
{
    for (int col = 0; col < exportTable.Columns.Count; col++)
    {
        outputSheet[row + 1, col].Value = exportTable.Rows[row][col]?.ToString();
    }
}

// Save as CSV
outputWorkbook.SaveAsCsv("output.csv", delimiter: ",");
Console.WriteLine("Export complete.");

// Load a DataTable from your data source
DataTable exportTable = GetProcessedData(); // your data source method

// Create a new workbook and populate it from the DataTable
WorkBook outputWorkbook = WorkBook.Create(ExcelFileFormat.XLSX);
WorkSheet outputSheet = outputWorkbook.DefaultWorkSheet;

// Write headers from DataTable columns
for (int col = 0; col < exportTable.Columns.Count; col++)
{
    outputSheet[0, col].Value = exportTable.Columns[col].ColumnName;
}

// Write rows
for (int row = 0; row < exportTable.Rows.Count; row++)
{
    for (int col = 0; col < exportTable.Columns.Count; col++)
    {
        outputSheet[row + 1, col].Value = exportTable.Rows[row][col]?.ToString();
    }
}

// Save as CSV
outputWorkbook.SaveAsCsv("output.csv", delimiter: ",");
Console.WriteLine("Export complete.");

Imports System.Data

' Load a DataTable from your data source
Dim exportTable As DataTable = GetProcessedData() ' your data source method

' Create a new workbook and populate it from the DataTable
Dim outputWorkbook As WorkBook = WorkBook.Create(ExcelFileFormat.XLSX)
Dim outputSheet As WorkSheet = outputWorkbook.DefaultWorkSheet

' Write headers from DataTable columns
For col As Integer = 0 To exportTable.Columns.Count - 1
    outputSheet(0, col).Value = exportTable.Columns(col).ColumnName
Next

' Write rows
For row As Integer = 0 To exportTable.Rows.Count - 1
    For col As Integer = 0 To exportTable.Columns.Count - 1
        outputSheet(row + 1, col).Value = exportTable.Rows(row)(col)?.ToString()
    Next
Next

' Save as CSV
outputWorkbook.SaveAsCsv("output.csv", delimiter:=","c)
Console.WriteLine("Export complete.")

CSV ve Excel Formatları Arasında Nasıl Dönüşüm Yapılır?

IronXL'in öne çıkan özelliklerinden biri, CSV'yi Excel'e dönüştürme ve Excel'i CSV'ye dönüştürme yeteneğidir, bu da veri göç projeleri için çok önemlidir. Aşağıdaki örnek bu yeteneği gösterir:

// Load CSV and save as Excel
WorkBook csvWorkbook = WorkBook.LoadCSV("report.csv",
    fileFormat: ExcelFileFormat.XLSX,
    listDelimiter: ",");
// Save as Excel file
csvWorkbook.SaveAs("report.xlsx");
// Or load Excel and export to CSV
WorkBook excelWorkbook = WorkBook.Load("data.xlsx");
excelWorkbook.SaveAsCsv("exported_data.csv", delimiter: ",");

// Load CSV and save as Excel
WorkBook csvWorkbook = WorkBook.LoadCSV("report.csv",
    fileFormat: ExcelFileFormat.XLSX,
    listDelimiter: ",");
// Save as Excel file
csvWorkbook.SaveAs("report.xlsx");
// Or load Excel and export to CSV
WorkBook excelWorkbook = WorkBook.Load("data.xlsx");
excelWorkbook.SaveAsCsv("exported_data.csv", delimiter: ",");

Imports IronXL

' Load CSV and save as Excel
Dim csvWorkbook As WorkBook = WorkBook.LoadCSV("report.csv", fileFormat:=ExcelFileFormat.XLSX, listDelimiter:=",")

' Save as Excel file
csvWorkbook.SaveAs("report.xlsx")

' Or load Excel and export to CSV
Dim excelWorkbook As WorkBook = WorkBook.Load("data.xlsx")
excelWorkbook.SaveAsCsv("exported_data.csv", delimiter:=",")

Bu çift yönlü dönüşüm, veri bütünlüğünü korurken çeşitli dosya dönüşüm senaryoları için format esnekliği sağlar. SaveAs yöntemi, dosya uzantısından istenen formatı otomatik olarak algılar, çalışma sayfası yönetimi ile XLSX, XLS ve diğer Excel formatlarını destekler. SaveAsCsv kullanarak CSV kaydedilirken, gereksinimlerinize uygun özel ayırıcılar ve metin kodlaması belirtebilirsiniz.

Bu özellik, veri değişimi için belirli dosya formatlarını gerektiren sistemlerle bütünleştirirken değerlidir. Diğer kütüphanelerden geçiş yapan veya manuel ayrıştırma alternatiflerini değerlendiren geliştiriciler için, IronXL'nin Stack Overflow'da tartışılan popüler alternatiflerle ve .NET topluluğundaki performans hususları ile karşılaştırmasına bakın. Daha fazla dosya formatı dönüşüm desenleri için Excel elektronik tablo dönüştürme kılavuzuna göz atın.

WorkBook workbook = WorkBook.LoadCSV("large-dataset.csv",
    fileFormat: ExcelFileFormat.XLSX,
    listDelimiter: ",");
WorkSheet worksheet = workbook.DefaultWorkSheet;

int batchSize = 1000;
int totalRows = worksheet.RowCount;

for (int start = 1; start <= totalRows; start += batchSize)
{
    int end = Math.Min(start + batchSize - 1, totalRows);
    for (int row = start; row <= end; row++)
    {
        string id   = worksheet[$"A{row}"].StringValue;
        string name = worksheet[$"B{row}"].StringValue;
        // Process each record here
        Console.WriteLine($"Row {row}: {id} - {name}");
    }
    Console.WriteLine($"Processed batch {start}-{end}");
}

WorkBook workbook = WorkBook.LoadCSV("large-dataset.csv",
    fileFormat: ExcelFileFormat.XLSX,
    listDelimiter: ",");
WorkSheet worksheet = workbook.DefaultWorkSheet;

int batchSize = 1000;
int totalRows = worksheet.RowCount;

for (int start = 1; start <= totalRows; start += batchSize)
{
    int end = Math.Min(start + batchSize - 1, totalRows);
    for (int row = start; row <= end; row++)
    {
        string id   = worksheet[$"A{row}"].StringValue;
        string name = worksheet[$"B{row}"].StringValue;
        // Process each record here
        Console.WriteLine($"Row {row}: {id} - {name}");
    }
    Console.WriteLine($"Processed batch {start}-{end}");
}

Imports System

Dim workbook As WorkBook = WorkBook.LoadCSV("large-dataset.csv", fileFormat:=ExcelFileFormat.XLSX, listDelimiter:=",")
Dim worksheet As WorkSheet = workbook.DefaultWorkSheet

Dim batchSize As Integer = 1000
Dim totalRows As Integer = worksheet.RowCount

For start As Integer = 1 To totalRows Step batchSize
    Dim [end] As Integer = Math.Min(start + batchSize - 1, totalRows)
    For row As Integer = start To [end]
        Dim id As String = worksheet($"A{row}").StringValue
        Dim name As String = worksheet($"B{row}").StringValue
        ' Process each record here
        Console.WriteLine($"Row {row}: {id} - {name}")
    Next
    Console.WriteLine($"Processed batch {start}-{end}")
Next

IronXL, Kurumsal CSV İşleme için Hangi Gelişmiş Özellikleri Sunar?

IronXL, birim testi desteği ve hata ayıklama araçları dahil, temel CSV ayrıştırıcıların ötesine geçen kurumsal düzeyde özellikler sunar. Kütüphane, Windows, Linux, macOS üzerinde ve Docker konteynerlerinde çalışan platformlar arası uyumluluk sunar - modern .NET Core dağıtımları ve mikroservis mimarisi için esaslıdır. Microsoft'un belgelerine göre, platformlar arası destek, bulut tabanlı uygulamalar ve Azure dağıtımı için kritik öneme sahiptir.

Teknik yeteneklerin ötesinde, IronXL tüm lisanslarla profesyonel destek ve düzenli güncellemeler içerir, en son .NET sürümleri ve güvenlik yamaları ile uyumluluğu sağlar. Bu ticari destek, açık kaynaklı kütüphanelerin üretim ortamlarında yetersiz kalabileceği durumlarda görev kritik uygulamalar için güvenilirliği sağlar. Kütüphane, optimize edilmiş bellek yönetimi yoluyla büyük veri kümelerini etkili bir şekilde ele alır ve aşağıdakiler gibi gelişmiş senaryoları destekler:

Yüksek edinme ve yük dengeleme gerektiren üretim dağıtımları için, IronXL'nin lisanslama modeli, tek projeler, ekipler ve kurumsal çapta kullanım için esneklik sunar - tümü kaynak kodu erişimi ve telif ücretsiz yeniden dağıtım haklarıyla birlikte. Lisans satın al su, damga olmadan tam işlevselliği açar.

// Apply license key at application startup
IronXl.License.LicenseKey = "YOUR-LICENSE-KEY-HERE";

// Then proceed with CSV reading as normal
WorkBook workbook = WorkBook.LoadCSV("data.csv",
    fileFormat: ExcelFileFormat.XLSX,
    listDelimiter: ",");
WorkSheet worksheet = workbook.DefaultWorkSheet;
Console.WriteLine($"Loaded {worksheet.RowCount} rows from CSV.");

// Apply license key at application startup
IronXl.License.LicenseKey = "YOUR-LICENSE-KEY-HERE";

// Then proceed with CSV reading as normal
WorkBook workbook = WorkBook.LoadCSV("data.csv",
    fileFormat: ExcelFileFormat.XLSX,
    listDelimiter: ",");
WorkSheet worksheet = workbook.DefaultWorkSheet;
Console.WriteLine($"Loaded {worksheet.RowCount} rows from CSV.");

Imports IronXl

' Apply license key at application startup
License.LicenseKey = "YOUR-LICENSE-KEY-HERE"

' Then proceed with CSV reading as normal
Dim workbook As WorkBook = WorkBook.LoadCSV("data.csv", fileFormat:=ExcelFileFormat.XLSX, listDelimiter:=",")
Dim worksheet As WorkSheet = workbook.DefaultWorkSheet
Console.WriteLine($"Loaded {worksheet.RowCount} rows from CSV.")

Ücretsiz Deneme ile Nasıl Başlarsınız?

IronXL, .NET Core uygulamalarında CSV okuma ve yazma işlemlerini basitleştirirken, veri analizi, raporlama ve otomasyon görevleri dahil olmak üzere karmaşık senaryoları ele alma esnekliği sağlar. Kendi kendine belgelenen API'si, Excel format desteği ve kurumsal özellikler ile geliştiriciler için kanıtlanmış CSV işleme yetenekleri sunar ve bu, iş parçacığı güvenliği ve eşzamanlı erişim desteği ile güvenilir bir seçimdir. Kutuphanenin formatlar arasında dönüştürme, çeşitli sınırlayıcıları işleme, veri temizleme ve mevcut .NET veri yapıları ile entegrasyon yetenekleri, geliştirme süresini önemli ölçüde azaltırken kodun bakımı kolay tutar.

CSV dosyalarını işlemeye hazır mısınız? Bugün ücretsiz IronXL denemesini indirin ve kutuphanenin profesyonel düzeyde CSV ayrıştırma yetenekleriyle verilerinizi nasıl ele aldığını deneyimleyin. Üretim kullanımı için proje belgeleri, sürekli güncellemeler ve profesyonel destek içeren lisans seçeneklerini keşfedin.

Daha fazla okuma için ek kaynaklar:

• Bir C# konsol uygulamasında Excel dosyalarının nasıl okunacağı
• C# CSV dosya oluşturma eğitimi
• DataTable'dan Excel'e veri aktarma
• IronXL nesne referans API'si
• Linux, macOS, Docker ve AWS için başlayın