IronXL Kullanarak C# Dilinde CSV Dosyalarını Nasıl Okunur

.NET'te CSV Dosyalarını Okumanın En Kolay Yolu Nedir?

En basit yaklaşım, CSV verilerini doğrudan bir çalışma kitabı yapısına aktarmak için WorkBook.LoadCSV yöntemini kullanmaktır. Bu tek bir yöntem, ayrıştırmayı, ayırıcı algılamayı ve veri organizasyonunu otomatik olarak yönetir -- StreamReader oluşturmaya veya her dize satırını manuel olarak işlemeye gerek yoktur.

IronXL'i Visual Studio'daki NuGet Paket Yöneticisi Konsolu üzerinden yükleyin. .NET projenizi açın ve çalıştırın:

Install-Package IronXL.Excel

using IronXL;

// Load CSV file into a workbook with one method call
WorkBook workbook = WorkBook.LoadCSV("sales_data.csv", fileFormat: ExcelFileFormat.XLSX, listDelimiter: ",");
// Access the default worksheet containing CSV data
WorkSheet sheet = workbook.DefaultWorkSheet;
// Display all rows and CSV columns
foreach (var row in sheet.Rows)
{
    foreach (var cell in row)
    {
        Console.Write(cell.Value + "\t");
    }
    Console.WriteLine();
}

using IronXL;

// Load CSV file into a workbook with one method call
WorkBook workbook = WorkBook.LoadCSV("sales_data.csv", fileFormat: ExcelFileFormat.XLSX, listDelimiter: ",");
// Access the default worksheet containing CSV data
WorkSheet sheet = workbook.DefaultWorkSheet;
// Display all rows and CSV columns
foreach (var row in sheet.Rows)
{
    foreach (var cell in row)
    {
        Console.Write(cell.Value + "\t");
    }
    Console.WriteLine();
}

Imports IronXL

' Load CSV file into a workbook with one method call
Dim workbook As WorkBook = WorkBook.LoadCSV("sales_data.csv", fileFormat:=ExcelFileFormat.XLSX, listDelimiter:=",")
' Access the default worksheet containing CSV data
Dim sheet As WorkSheet = workbook.DefaultWorkSheet
' Display all rows and CSV columns
For Each row In sheet.Rows
    For Each cell In row
        Console.Write(cell.Value & vbTab)
    Next
    Console.WriteLine()
Next

Manuel CSV Ayrıştırması, Bir Kütüphane Kullanmaya Göre Nasıl Karşılaştırılır?

IronXL'in ortadan kaldırdığı karmaşıklığı anlamak, değerini daha net hale getirir. Manuel CSV ayrıştırması, basit görünen ancak herhangi bir projede hızla sorunlu hale gelebilen çeşitli uç durumları yönetmeyi gerektirir.

using System.IO;

// Manual approach -- requires extensive code for basic functionality
string path = "data.csv";
string[] lines = File.ReadAllLines(path);
foreach (string line in lines)
{
    // This breaks when CSV fields contain commas inside quotes
    string[] fields = line.Split(',');
    foreach (string field in fields)
    {
        Console.Write(field.Trim() + "\t");
    }
    Console.WriteLine();
}

using System.IO;

// Manual approach -- requires extensive code for basic functionality
string path = "data.csv";
string[] lines = File.ReadAllLines(path);
foreach (string line in lines)
{
    // This breaks when CSV fields contain commas inside quotes
    string[] fields = line.Split(',');
    foreach (string field in fields)
    {
        Console.Write(field.Trim() + "\t");
    }
    Console.WriteLine();
}

Imports System.IO

' Manual approach -- requires extensive code for basic functionality
Dim path As String = "data.csv"
Dim lines As String() = File.ReadAllLines(path)
For Each line As String In lines
    ' This breaks when CSV fields contain commas inside quotes
    Dim fields As String() = line.Split(","c)
    For Each field As String In fields
        Console.Write(field.Trim() & vbTab)
    Next
    Console.WriteLine()
Next

using IronXL;

// IronXL approach -- handles all edge cases automatically
WorkBook workbook = WorkBook.LoadCSV("data.csv", fileFormat: ExcelFileFormat.XLSX, listDelimiter: ",");
var records = workbook.DefaultWorkSheet.Rows;
foreach (var row in records)
{
    foreach (var cell in row)
    {
        Console.Write(cell.Value + "\t");
    }
    Console.WriteLine();
}

using IronXL;

// IronXL approach -- handles all edge cases automatically
WorkBook workbook = WorkBook.LoadCSV("data.csv", fileFormat: ExcelFileFormat.XLSX, listDelimiter: ",");
var records = workbook.DefaultWorkSheet.Rows;
foreach (var row in records)
{
    foreach (var cell in row)
    {
        Console.Write(cell.Value + "\t");
    }
    Console.WriteLine();
}

Imports IronXL

' IronXL approach -- handles all edge cases automatically
Dim workbook As WorkBook = WorkBook.LoadCSV("data.csv", fileFormat:=ExcelFileFormat.XLSX, listDelimiter:=",")
Dim records = workbook.DefaultWorkSheet.Rows
For Each row In records
    For Each cell In row
        Console.Write(cell.Value & vbTab)
    Next
    Console.WriteLine()
Next

Farklı CSV Ayraçları Nasıl Yönetilir?

CSV dosyaları her zaman ayırıcı olarak virgülleri kullanmaz. Avrupa sistemi, virgüller ondalık sayılarda yer aldığında sık sık noktalı virgüller kullanır. Sekme ile ayrılmış değerler (TSV) ve boru ile ayrılmış dosyalar, çeşitli uygulamalar ve eski sistemlerden veri çıkarmalarında düzenli olarak ortaya çıkar.

using IronXL;

// Reading a semicolon-delimited file (common in European exports)
WorkBook euroData = WorkBook.LoadCSV("german_report.csv", fileFormat: ExcelFileFormat.XLSX, listDelimiter: ";");
// Reading a tab-separated file
WorkBook tsvData = WorkBook.LoadCSV("exported_data.tsv", fileFormat: ExcelFileFormat.XLSX, listDelimiter: "\t");
// Reading a pipe-delimited file
WorkBook pipeData = WorkBook.LoadCSV("legacy_system.csv", fileFormat: ExcelFileFormat.XLSX, listDelimiter: "|");
// Access data identically regardless of original delimiter
WorkSheet sheet = euroData.DefaultWorkSheet;
int rowsCount = sheet.RowCount;
Console.WriteLine($"Loaded {rowsCount} rows with {sheet.ColumnCount} CSV columns");

using IronXL;

// Reading a semicolon-delimited file (common in European exports)
WorkBook euroData = WorkBook.LoadCSV("german_report.csv", fileFormat: ExcelFileFormat.XLSX, listDelimiter: ";");
// Reading a tab-separated file
WorkBook tsvData = WorkBook.LoadCSV("exported_data.tsv", fileFormat: ExcelFileFormat.XLSX, listDelimiter: "\t");
// Reading a pipe-delimited file
WorkBook pipeData = WorkBook.LoadCSV("legacy_system.csv", fileFormat: ExcelFileFormat.XLSX, listDelimiter: "|");
// Access data identically regardless of original delimiter
WorkSheet sheet = euroData.DefaultWorkSheet;
int rowsCount = sheet.RowCount;
Console.WriteLine($"Loaded {rowsCount} rows with {sheet.ColumnCount} CSV columns");

Imports IronXL

' Reading a semicolon-delimited file (common in European exports)
Dim euroData As WorkBook = WorkBook.LoadCSV("german_report.csv", fileFormat:=ExcelFileFormat.XLSX, listDelimiter:=";")
' Reading a tab-separated file
Dim tsvData As WorkBook = WorkBook.LoadCSV("exported_data.tsv", fileFormat:=ExcelFileFormat.XLSX, listDelimiter:=vbTab)
' Reading a pipe-delimited file
Dim pipeData As WorkBook = WorkBook.LoadCSV("legacy_system.csv", fileFormat:=ExcelFileFormat.XLSX, listDelimiter:="|")
' Access data identically regardless of original delimiter
Dim sheet As WorkSheet = euroData.DefaultWorkSheet
Dim rowsCount As Integer = sheet.RowCount
Console.WriteLine($"Loaded {rowsCount} rows with {sheet.ColumnCount} CSV columns")

LoadCSV içindeki listDelimiter parametresi, alan ayırıcısı olarak herhangi bir tek karakter veya kaçış dizisini kabul eder. Sekme karakterleri \t kaçış dizisini kullanır. Yüklemeden sonra, veri yapısı orijinal format ne olursa olsun tutarlı kalır, birçok kaynaktan gelen ve değişen ayırıcılarla CSV dosyalarını işlemeyi kolaylaştırır. Çoğu CSV dosyası için varsayılan değer bir virgüldür, ancak bu esneklik, bir projenin karşılaştığı her türlü varyasyonu işleme kapasitesine sahiptir.

CSV'yi DataTable'ye Dönüştürmenin En İyi Yöntemleri Nelerdir?

CSV verilerini bir DataTable'ye dönüştürmek, veritabanı işlemleriyle entegrasyona, UI uygulamalarında veri bağlama ve LINQ sorgularına olanak tanır. ToDataTable metodu bu dönüşümü tek bir çağrıyla gerçekleştirir.

using IronXL;
using System.Data;

// Load CSV and convert to DataTable
WorkBook workbook = WorkBook.LoadCSV("customers.csv", ExcelFileFormat.XLSX, ",");
WorkSheet sheet = workbook.DefaultWorkSheet;
// Convert worksheet to DataTable -- true parameter uses CSV header as column names
DataTable dataTable = sheet.ToDataTable(true);
// DataTable is now ready for database operations, binding, or LINQ queries
Console.WriteLine($"DataTable created with {dataTable.Columns.Count} columns:");
foreach (DataColumn column in dataTable.Columns)
{
    // Property names from CSV header become column names
    Console.WriteLine($"  - {column.ColumnName}");
}
Console.WriteLine($"\nTotal records: {dataTable.Rows.Count}");
// Access data using standard DataTable syntax
foreach (DataRow row in dataTable.Rows)
{
    // Access by column index or name attribute
    string name = row["Name"].ToString();
    string email = row["Email"].ToString();
    Console.WriteLine($"Customer: {name}, Email: {email}");
}

using IronXL;
using System.Data;

// Load CSV and convert to DataTable
WorkBook workbook = WorkBook.LoadCSV("customers.csv", ExcelFileFormat.XLSX, ",");
WorkSheet sheet = workbook.DefaultWorkSheet;
// Convert worksheet to DataTable -- true parameter uses CSV header as column names
DataTable dataTable = sheet.ToDataTable(true);
// DataTable is now ready for database operations, binding, or LINQ queries
Console.WriteLine($"DataTable created with {dataTable.Columns.Count} columns:");
foreach (DataColumn column in dataTable.Columns)
{
    // Property names from CSV header become column names
    Console.WriteLine($"  - {column.ColumnName}");
}
Console.WriteLine($"\nTotal records: {dataTable.Rows.Count}");
// Access data using standard DataTable syntax
foreach (DataRow row in dataTable.Rows)
{
    // Access by column index or name attribute
    string name = row["Name"].ToString();
    string email = row["Email"].ToString();
    Console.WriteLine($"Customer: {name}, Email: {email}");
}

Imports IronXL
Imports System.Data

' Load CSV and convert to DataTable
Dim workbook As WorkBook = WorkBook.LoadCSV("customers.csv", ExcelFileFormat.XLSX, ",")
Dim sheet As WorkSheet = workbook.DefaultWorkSheet
' Convert worksheet to DataTable -- true parameter uses CSV header as column names
Dim dataTable As DataTable = sheet.ToDataTable(True)
' DataTable is now ready for database operations, binding, or LINQ queries
Console.WriteLine($"DataTable created with {dataTable.Columns.Count} columns:")
For Each column As DataColumn In dataTable.Columns
    ' Property names from CSV header become column names
    Console.WriteLine($"  - {column.ColumnName}")
Next
Console.WriteLine(vbCrLf & $"Total records: {dataTable.Rows.Count}")
' Access data using standard DataTable syntax
For Each row As DataRow In dataTable.Rows
    ' Access by column index or name attribute
    Dim name As String = row("Name").ToString()
    Dim email As String = row("Email").ToString()
    Console.WriteLine($"Customer: {name}, Email: {email}")
Next

ToDataTable içindeki boolean parametre, ilk satırın sütun başlıkları (true) mı yoksa veri (false) mi olması gerektiğini belirler. true olarak ayarlandığında, sonuç DataTable'in sütunları, CSV dosyasındaki başlık adlarını taşır, bu da row["Name"] gibi sütun adlarını kullanarak sezgisel veri erişimine olanak tanır.

CSV Dosyaları Excel Formatına Nasıl Dönüştürülür?

IronXL'in göze çarpan yeteneklerinden biri, CSV verilerini uygun Excel formatlarına dönüştürmesidir. Bu, orijinal düz CSV verilerine formüller, formatlama, grafikler ve birden fazla çalışma sayfası eklemeyi mümkün kılar -- sadece CSV çıktısıyla başaramayacağınız bir şey.

using IronXL;

// Load CSV data from file path
string path = "quarterly_sales.csv";
WorkBook workbook = WorkBook.LoadCSV(path, ExcelFileFormat.XLSX, ",");
// Save as Excel XLSX format -- creates a new Excel file
workbook.SaveAs("quarterly_sales.xlsx");
// Alternative: Save as legacy XLS format for older Excel versions
workbook.SaveAs("quarterly_sales.xls");
Console.WriteLine("CSV successfully converted to Excel format");

using IronXL;

// Load CSV data from file path
string path = "quarterly_sales.csv";
WorkBook workbook = WorkBook.LoadCSV(path, ExcelFileFormat.XLSX, ",");
// Save as Excel XLSX format -- creates a new Excel file
workbook.SaveAs("quarterly_sales.xlsx");
// Alternative: Save as legacy XLS format for older Excel versions
workbook.SaveAs("quarterly_sales.xls");
Console.WriteLine("CSV successfully converted to Excel format");

Imports IronXL

' Load CSV data from file path
Dim path As String = "quarterly_sales.csv"
Dim workbook As WorkBook = WorkBook.LoadCSV(path, ExcelFileFormat.XLSX, ","c)
' Save as Excel XLSX format -- creates a new Excel file
workbook.SaveAs("quarterly_sales.xlsx")
' Alternative: Save as legacy XLS format for older Excel versions
workbook.SaveAs("quarterly_sales.xls")
Console.WriteLine("CSV successfully converted to Excel format")

SaveAs yöntemi, çıktı formatını dosya uzantısına göre otomatik olarak belirler. XLSX, Excel 2007 ve sonrasıyla uyumlu modern Office Open XML dosyaları oluştururken XLS, daha eski uygulamalar için eski İkili Değişim Dosya Formatı belgeleri üretir.

CSV Verilerindeki Belirli Hücre Değerlerine Nasıl Erişirsiniz?

Tüm kayıtlar üzerinden döngüye girmenin ötesinde, IronXL, tanıdık Excel tarzı adresleme kullanarak doğrudan hücre erişimi sağlar. Bu, farklı veri türleri üzerinde hedeflenmiş veri çıkarımı ve güvenli tipte değer elde etmeyi mümkün kılar.

using IronXL;

WorkBook workbook = WorkBook.LoadCSV("inventory.csv", ExcelFileFormat.XLSX, ",");
WorkSheet sheet = workbook.DefaultWorkSheet;
// Access specific cells using Excel-style addresses by index
string productName = sheet["A2"].StringValue;
int quantity = sheet["B2"].IntValue;
decimal price = sheet["C2"].DecimalValue;
Console.WriteLine($"Product: {productName}");
Console.WriteLine($"Quantity: {quantity}");
Console.WriteLine($"Price: ${price:F2}");
// Access a range of cells -- return records from column A
var productRange = sheet["A2:A10"];
Console.WriteLine("\nAll products:");
foreach (var cell in productRange)
{
    Console.WriteLine($"  - {cell.StringValue}");
}

using IronXL;

WorkBook workbook = WorkBook.LoadCSV("inventory.csv", ExcelFileFormat.XLSX, ",");
WorkSheet sheet = workbook.DefaultWorkSheet;
// Access specific cells using Excel-style addresses by index
string productName = sheet["A2"].StringValue;
int quantity = sheet["B2"].IntValue;
decimal price = sheet["C2"].DecimalValue;
Console.WriteLine($"Product: {productName}");
Console.WriteLine($"Quantity: {quantity}");
Console.WriteLine($"Price: ${price:F2}");
// Access a range of cells -- return records from column A
var productRange = sheet["A2:A10"];
Console.WriteLine("\nAll products:");
foreach (var cell in productRange)
{
    Console.WriteLine($"  - {cell.StringValue}");
}

Imports IronXL

Dim workbook As WorkBook = WorkBook.LoadCSV("inventory.csv", ExcelFileFormat.XLSX, ",")
Dim sheet As WorkSheet = workbook.DefaultWorkSheet
' Access specific cells using Excel-style addresses by index
Dim productName As String = sheet("A2").StringValue
Dim quantity As Integer = sheet("B2").IntValue
Dim price As Decimal = sheet("C2").DecimalValue
Console.WriteLine($"Product: {productName}")
Console.WriteLine($"Quantity: {quantity}")
Console.WriteLine($"Price: ${price:F2}")
' Access a range of cells -- return records from column A
Dim productRange = sheet("A2:A10")
Console.WriteLine(vbCrLf & "All products:")
For Each cell In productRange
    Console.WriteLine($"  - {cell.StringValue}")
Next

Hücre adresleme, harflerin CSV sütunlarını (A, B, C) ve sayılarının satır indeks konumlarını (1, 2, 3) temsil ettiği Excel konvansiyonlarını takip eder. Cell sınıfı, StringValue, IntValue, DecimalValue, BoolValue ve DateTimeValue gibi tür-spesifik erişim sağlar. Bu erişiciler, her şeyi dize değerleri olarak saklamaya kıyasla, otomatik olarak ayrıştırma ve dönüşüm yaparak manuel tip dökümü ihtiyacını ortadan kaldırır.

A2:A10 gibi bir gösterim kullanarak aralık seçimi, yineleme, toplama fonksiyonları ve toplu işlemleri destekleyen bir Aralık nesnesi döndürür. Bu, büyük CSV dosyalarından belirli sütunların veya dikdörtgen veri bölgelerinin çıkarılmasında değerli olur. Örneğin, belirli bir sütundan değerlerin bir listesini oluşturabilir veya filtrelenen verileri başka bir dosyaya yazabilirsiniz. Daha fazla desen için IronXL aralık kılavuzuna göz atın.

CSV Dosyalarını Okurken Hataları Nasıl Yönetirsiniz?

Üretim uygulamaları, dosya işlemleri etrafında savunma kodu gerektirir. CSV okuma, birkaç nedenden dolayı başarısız olabilir: dosya mevcut değildir, erişim reddedilmiştir, veri hatalı biçimlendirilmiştir veya çok büyük dosyalar için bellek yetersizdir. IronXL çağrılarını try/catch bloklarına sarmak ve yüklemeden önce yolları doğrulamak, ortamlarda güvenilir davranış sağlar.

using IronXL;
using System.IO;

string filePath = "customers.csv";
if (!File.Exists(filePath))
{
    Console.WriteLine($"File not found: {filePath}");
    return;
}
try
{
    WorkBook workbook = WorkBook.LoadCSV(filePath, ExcelFileFormat.XLSX, ",");
    WorkSheet sheet = workbook.DefaultWorkSheet;
    DataTable dataTable = sheet.ToDataTable(true);
    Console.WriteLine($"Loaded {dataTable.Rows.Count} records successfully.");
}
catch (IronXL.Exceptions.IronXLException ex)
{
    Console.WriteLine($"IronXL parsing error: {ex.Message}");
}
catch (IOException ex)
{
    Console.WriteLine($"File access error: {ex.Message}");
}
catch (Exception ex)
{
    Console.WriteLine($"Unexpected error: {ex.Message}");
}

using IronXL;
using System.IO;

string filePath = "customers.csv";
if (!File.Exists(filePath))
{
    Console.WriteLine($"File not found: {filePath}");
    return;
}
try
{
    WorkBook workbook = WorkBook.LoadCSV(filePath, ExcelFileFormat.XLSX, ",");
    WorkSheet sheet = workbook.DefaultWorkSheet;
    DataTable dataTable = sheet.ToDataTable(true);
    Console.WriteLine($"Loaded {dataTable.Rows.Count} records successfully.");
}
catch (IronXL.Exceptions.IronXLException ex)
{
    Console.WriteLine($"IronXL parsing error: {ex.Message}");
}
catch (IOException ex)
{
    Console.WriteLine($"File access error: {ex.Message}");
}
catch (Exception ex)
{
    Console.WriteLine($"Unexpected error: {ex.Message}");
}

Imports IronXL
Imports System.IO

Dim filePath As String = "customers.csv"
If Not File.Exists(filePath) Then
    Console.WriteLine($"File not found: {filePath}")
    Return
End If

Try
    Dim workbook As WorkBook = WorkBook.LoadCSV(filePath, ExcelFileFormat.XLSX, ",")
    Dim sheet As WorkSheet = workbook.DefaultWorkSheet
    Dim dataTable As DataTable = sheet.ToDataTable(True)
    Console.WriteLine($"Loaded {dataTable.Rows.Count} records successfully.")
Catch ex As IronXL.Exceptions.IronXLException
    Console.WriteLine($"IronXL parsing error: {ex.Message}")
Catch ex As IOException
    Console.WriteLine($"File access error: {ex.Message}")
Catch ex As Exception
    Console.WriteLine($"Unexpected error: {ex.Message}")
End Try

Bellek Sorunları Olmadan Büyük CSV Dosyalarını Nasıl Okursunuz?

Yüz binlerce satır içeren dosyalar için, tüm veri setini bir kerede belleğe yüklemek pratik olmayabilir. IronXL, tüm dosyayı bellekte tüm verileri tutan bir WorkBook nesnesine okur. Büyük ölçekli ETL (Çıkart, Dönüştür, Yükle) senaryoları için, kaynak dosyayı yüklemeden önce bölerek CSV'yi toplu işlemlerle işlemek veya bir StreamReader'den satır akışı yaparak ayrı çalışma kitaplarına parça yazmak pratik bir stratejidir.

IronXL dokümantasyonu, büyük iş yükleri için performans hususlarını kapsar. CSV özelinde, CSV formatının satır-satır yapısı, veri seti tek bir bellekte yükleme için çok büyük olduğunda, manuel toplama ile basit bir File.ReadAllLines tahmin edilebilir hafıza ayak izi sağlar.

Sonraki Adımlarınız Neler?

Doğru yaklaşımı kullanırken, .NET'te CSV dosyalarını okumak için minimale çaba gerektirir. IronXL'nin LoadCSV yöntemi, ayrıştırma karmaşıklığını otomatik olarak yönetir, çeşitli ayırıcıları destekler, yapısal verilere anında erişim sağlar ve tek yöntem çağrılarıyla Excel veya DataTable'a dönüştürür. ASP.NET Core uygulaması, bir .NET Core Web API veya bir konsol projesi oluşturuyor olun, kütüphane CSV işleme sürecini baştan sona basitleştirir.

Burada öğrendiklerinizi genişletmek için IronXL yeteneklerinden daha fazlasını keşfedin:

• IronXL ürün sayfası -- tam özellik listesi ve lisanslama
• C#'da Excel dosyalarını nasıl okursunuz -- CSV becerilerinizi XLSX/XLS'e genişletin
• C#'da Excel dosyalarını yazma -- tablo oluşturma ve dışa aktarma işlemlerini programlı olarak gerçekleştirin
• DataTable ve DataSet dışa aktarma -- ADO.NET iş akışlarına bağlanın
• IronXL lisanslama -- dağıtım için lisanslama seçenekleri

Ücretsiz bir deneme başlatın ve IronXL'in .NET projelerinizde CSV dosyalarını nasıl basitleştirdiğini deneyimleyin. Üretim dağıtımı için, lisanslama seçenekleri süresiz kullanım hakları ve bir yıllık destek içerir.