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

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

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

• Uluslararası karakter setler için otomatik kodlama algılama
• Elle yapılandırma gerektirmeyen akıllı ayraç tanıma
• Kilobayttan gigabayta kadar dosyalar için bellek etkin işleme
• Dahili veri türü çıkarımı ve dönüştürme
• Platformlar arası satır sonu ve satır besleme işleme
• CSV verileriyle çalışırken bile Excel formül desteği
• Windows, Linux ve macOS üzerinde platformlar arası güvenilirlik

Kapsamlı yapılandırma ve manuel ayrıştırma mantığı gerektiren temel CSV okuyucuların aksine, IronXL kenar durumları otomatik olarak ele alır -- örneğin, ayraç içeren tırnak içindeki alanlar, çok satırlı hücre değerleri ve özel karakterler. Kütüphanenin mimarisi, tembel yükleme ve akış yetenekleri aracılığıyla yasal performans sağlamaktadır, bu da onu küçük yapılandırma dosyaları ve büyük ölçekli veri işleme görevleri için uygun hale getirir. IronXL gerektiğinde başlık satırlarını atlayabilir ve karmaşık veri yapılarını verimli bir şekilde bölebilir. Daha fazla bilgi edinmek için IronXL özellikler genel bakışı'na bakın.

Geçmiş sistemlerden geçiş yapan geliştiriciler için, IronXL yerleşik async/await desenleri sunarken öğrenme eğrisini azaltan tanıdık bir API sunar. Bu, veri 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 belgelerini görün.

CSV Dosya Okuma İçin IronXL Nasıl Kurulur?

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

Install-Package IronXL.Excel

Veya .NET CLI kullanın:

dotnet add package IronXL.Excel

Alternatif olarak, NuGet Paket Yöneticisi UI'yi kullanarak "IronXL.Excel" arayın ve yükle'ye tıklayın. Bu kütüphane, .NET Core'a geçiş sırasında mevcut .NET Framework projeleriyle entegre olur. Ayrıca, doğrudan IronXL NuGet sayfası'ndan referans alabilirsiniz.

Yükledikten sonra, ad alanını kodunuza ekleyin:

using IronXL;

using IronXL;

Imports IronXL

Bu yapılandırma, Microsoft Office veya Interop bağımlılıkları gerektirmeden güçlü CSV okuma yeteneklerine erişim sağlar ve 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 bakın.

IronXL'in LoadCSV Metodunu Kullanarak CSV Dosyaları Nasıl Okunur?

IronXL, CSV dosya işlemlerini LoadCSV yöntemi ile kolaylaştırır; bu yöntem, CSV başlıkları, CSV sütunları 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ışı işlemesi kullanarak, bellek içinde CSV veri yapınızı temsil eden bir WorkBook nesnesi oluşturur. fileFormat parametresi, işleme için iç formatı belirtir; listDelimiter ise CSV dosyanızda kullanılan CSV ayırıcı karakterini tanımlar -- sekmeyle sınırlı dosyaları ve boru karakteri ile sınırlı 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ı Ayırıcıları Nasıl Ele Alırsınız ve Bir DataTable'a Nasıl Dönüştürebilirsiniz?

Gerçek dünya CSV dosya formatları, virgüllerin ötesinde genellikle çeşitli ayırıcılar kullanır ve esnek bir ele alma gerektirir. IronXL, otomatik ayraç 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 formatına dönüştürür, ve boolean parametresi ilk satırın sütun başlıkları olarak kullanılıp kullanılmayacağını belirtir. Bu dönüşüm, özellikle veri tabanı işlemleri için, ASP.NET Core uygulamalarında veri bağlama veya SQL Server entegrasyonu için mevcut DataTable işleme mantığını uygulamanız gerektiğinde kullanışlıdır. Ortaya çıkan DataTable, veri türleri ve şema bilgilerini korur ve verimli toplu ekleme işlemleri için SqlBulkCopy ile doğrudan kullanılabilir.

CSV'yi DataTable'a İçe Aktarma ve veritabanı entegrasyonu hakkında daha fazla bilgi için detaylı kılavuzlara bakın.

// 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üştürülür?

IronXL'in öne çıkan özelliklerinden biri CSV'den Excel'e dönüştürme ve Excel'den CSV'ye dönüşüm olup, veri taşıma projeleri için oldukça önemlidir. Aşağıdaki örnek bu yeteneği göstermektedir:

// 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, çeşitli dosya dönüştürme senaryoları için format esnekliği sağlarken veri bütünlüğünü korur. SaveAs yöntemi, dosya uzantısından istenen formatı otomatik olarak algılar ve XLSX, XLS ve diğer Excel formatlarını çalışma sayfası yönetimi ile destekler. SaveAsCsv kullanarak CSV kaydederken, gereksinimlerinizi karşılamak için özel ayırıcılar ve metin kodlaması belirleyebilirsiniz.

Bu özellik, belirli dosya formatlarının veri değişimi için gerekli olduğu sistemlerle entegre ederken paha biçilmezdir. Diğer kütüphanelerden geçiş yapan veya manuel ayrıştırma alternatiflerini değerlendiren geliştiriciler için, IronXL'in Stack Overflow'da tartışılan popüler alternatiflerle ve .NET topluluğundaki performans hususları ile karşılaştırmasına bakın. Başka dosya biçimi dönüşüm desenleri için, Excel hesap tablosu 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

Enterprise CSV İşleme İçin IronXL'in Hangi Gelişmiş Özellikleri Var?

IronXL, birim test desteği ve hata ayıklama araçları dahil olmak üzere temel CSV ayrıştırıcılarından farklı kılan kurumsal sınıf özellikler sağlar. Kütüphane, Windows, Linux, macOS ve Docker konteynerlerinde çalışarak çapraz platform uyumluluğu sunar -- modern .NET Core dağıtımları ve mikro hizmet mimarisi için gereklidir. Microsoft belgelendirmeye göre, çapraz platform desteği, bulut yerel 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 de içerir ve en yeni .NET sürümleri ve güvenlik yamalarıyla uyumluluğu sağlar. Bu ticari destek, üretim ortamlarında açık kaynak kütüphanelerinin eksik kalabileceği görev kritik uygulamalar için güvenilirlik sağlar. Kütüphane, optimize edilmiş bellek yönetimi aracılığıyla büyük veri kümelerini etkili bir şekilde işler ve aşağıdaki gibi gelişmiş senaryoları destekler:

Ölçeklenebilirlik ve yük dengeleme gerektiren üretim dağıtımları için, IronXL'in lisanslama modeli, tek projeler, ekipler ve kurumsal genel kullanım seçenekleriyle esneklik sunar -- bunların tümü kaynak kodu erişimi ve telif ücretsiz yeniden dağıtım hakları içerir. Lisans satın alın ve filigran olmadan tam işlevselliğe erişin.

// 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.");

' Apply license key at application startup
IronXL.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 Bir Deneme ile Nasıl Başlanır?

IronXL, .NET Core uygulamalarında CSV okuma ve yazma işlemlerini basitleştirirken, veri analizi, raporlama ve otomasyon görevleri dahil karmaşık senaryoları ele alma esnekliği sağlar. Kullanımı kolay API, Excel format desteği ve kurumsal özelliklerle birleştirilmiş, veri analizi, raporlama ve otomasyon görevlerini güvenli bir şekilde işleme yeteneği vadeden geliştiriciler için güvenilir bir seçimdir. Kütüphanenin formatlar arasında dönüştürme, çeşitli ayraçları işleme, veri temizleme ve mevcut .NET veri yapılarına entegrasyon yeteneği, geliştirme süresini önemli ölçüde azaltırken kodu sürdürülebilir tutar.

CSV dosyalarını işlemeye hazır mısınız? IronXL'in ücretsiz deneme sürümünü bugün indirin ve kütüphanenin veri işleme iş akışlarınızı profesyonel düzeyde CSV ayrıştırma kabiliyetleriyle nasıl dönüştürdüğünü görün. Üretim kullanımı için, profesyonel destek, belgelendirme ve .NET projelerinizde devam eden güncellemeler içeren lisans seçeneklerini keşfedin.

Daha fazla okuma için ek kaynaklar:

• Excel dosyalarının C# konsol uygulamasında nasıl okunacağı
• C# CSV dosyası oluşturma eğitimine
• DataTable'dan Excel'e Veri Aktarmada C#
• IronXL nesne referansı API'si
• Linux, macOS, Docker ve AWS'de başlayın