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

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

WorkBook.LoadCSV kullanarak CSV verilerini doğrudan bir çalışma kitabı yapısına aktarmak en basit yaklaşımdır. Bu tek bir metot, ayrıştırmayı, ayırıcı algılamayı ve veri organizasyonunu otomatik olarak halleder -- StreamReader oluşturmanıza veya her bir dize satırını elle işlemenize gerek yoktur.

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

Install-Package IronXL
dotnet add package IronXL

Install-Package IronXL
dotnet add package IronXL

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 Kullanımı ile Karşılaştırıldığında Nasıl?

IronXL'ın ortadan kaldırdığı karmaşıklığı anlamak, değerini netleştirir. Manuel CSV ayrıştırma, basit görünüyor olsa da herhangi bir projede hızla sorunlu hale gelen çoklu köşe durumlarının ele alınmasını 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 Ayırıcıları Nasıl Ele Alınır?

CSV dosyaları her zaman virgül ayırıcı olarak kullanmaz. Avrupa sistemi dışa aktarımları, ondalık sayılarda virgüller bulunduğundan genellikle noktalı virgül kullanır. Çeşitli uygulamalardan ve eski sistemlerden gelen veri dışa aktarımlarında Tab ile ayrılmış değerler (TSV) ve boru ile sınırlı dosyalar düzenli olarak görünür.

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ı olarak herhangi bir tek karakter veya kaçış sekansını kabul eder. Sekme karakterleri \t kaçış sekansını kullanır. Yüklendikten sonra, veri yapısı orijinal formattan bağımsız olarak tutarlı kalır, böylece farklı ayırıcılarla birden çok kaynaktan gelen CSV dosyalarını işlemek kolaylaşır. Çoğu CSV dosyası için varsayılan değer bir virgüldür, ancak bu esneklik, bir projenin karşılaştığı tüm varyasyonları halleder.

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

CSV verilerini DataTable'e dönüştürmek, veritabanı işlemleriyle, UI uygulamalarında veri bağlamayla ve LINQ sorgularıyla entegrasyon sağlar. ToDataTable yöntemi, 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 true sütun başlıkları mı yoksa false veri mi olacağını belirler. true olarak ayarlandığında, elde edilen DataTable sütunları, CSV dosyasından sütun başlık adlarını taşır, bu sayede row["Name"] gibi başlık adlarını kullanarak sezgisel veri erişimi sağlar.

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

IronXL'nin öne çıkan yeteneklerinden biri, CSV verilerini uygun Excel formatlarına dönüştürmektir. Bu, formüller, biçimlendirme, grafikler ve başlangıçta düz CSV verilerine birden fazla çalışma sayfası eklemeyi sağlar -- bu, yalnızca CSV çıktısı ile elde edemediğiniz bir şeydir.

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 metodu, dosya uzantısına dayalı olarak çıkış formatını otomatik olarak belirler. XLSX, Excel 2007 ve sonrası ile uyumlu modern Office Open XML dosyaları oluştururken, XLS eski uygulamalar için legacy İkili Değiş Tokuş Dosya Formatı belgeleri üretir.

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

Tüm kayıtlar arasından yineleme yapmanın ötesinde, IronXL, tanıdık Excel tarzı adresleme kullanarak doğrudan hücre erişimi sağlar. Bu, hedeflenmiş veri çıkarımı ve farklı veri türleri arasında tür güvenli değer alımı sağ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 satır indeks pozisyonları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 özgül erişimciler sağlar. Bu erişimciler ayrıştırmayı ve dönüşümü otomatik olarak halleder, her şeyi dize değerleri olarak depolamaya kıyasla manuel tür dönüşümünü ortadan kaldırır.

A2:A10 gibi gösterimlerle yapılan aralık seçimi, yinelemeyi, toplu işlemleri ve toplu işlemleri destekleyen bir Range nesnesi döndürür. Bu, büyük CSV dosyalarından belirli sütunlar veya dikdörtgen veri bölgeleri çıkartırken değerli olur. Örneğin, belirli bir sütundan değerler listesi oluşturabilir veya başka bir dosyaya filtrelenmiş veriler yazabilirsiniz. Daha fazla kalıp için IronXL aralık kılavuzuna bakın.

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

Üretim uygulamaları, dosya işlemleri etrafında koruyucu kod gerektirir. CSV okuma, birkaç nedenden dolayı başarısız olabilir: dosya mevcut değildir, erişim reddedilir, veriler hatalıdır 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, çevreler arasında 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 kümesini bir defada belleğe yüklemek pratik olmayabilir. IronXL tüm dosyayı WorkBook nesnesine okur ve tüm veriyi bellekte tutar. Büyük çaplı ETL (Çıkar, Dönüştür, Yükle) senaryoları için CSV'yi bölerek kaynak dosyayı yüklemeden önce işlemek veya bir StreamReader dan satırları aktarmak ve parçalara ayırıp ayrı çalışma kitaplarına yazmak pratik bir stratejidir.

IronXL Excel dosyalarını okuma kılavuzu, büyük iş yükleri için performans dikkate alınması gereken hususları kapsar. Özellikle CSV için, CSV formatının satır bazlı yapısı, veri seti tek bir bellek yüklemesi için çok büyük olduğunda basit bir File.ReadAllLines ile manuel toplu işlemeyi tahmin edilebilir bellek ayak izi sağlar.

Sıradaki Adımlarınız Neler?

.NET'te CSV dosyalarını okuma, doğru yaklaşımı kullanarak minimum çaba gerektirir. IronXL'nin LoadCSV metodu, 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 bir metot çağrısı ile Excel veya DataTable'ye dönüştürür. Bir ASP.NET Core uygulaması, bir .NET Core Web API veya konsol projesi inşa ediyor olun, kütüphane başından sonuna kadar CSV işlemini basitleştirir.

Burada öğrendiklerinizi genişletmek için daha fazla IronXL yeteneğini keşfedin:

• IronXL ürün sayfası -- tam özellik listesi ve lisanslama
• Excel dosyalarını C# ile nasıl okunur -- CSV yetenekleri XLSX/XLS'e genişletin
• Excel dosyalarını C# ile nasıl yazılır -- elektronik tabloları programatik olarak oluşturun ve dışa aktarın
• DataTable ve DataSet dışa aktarımı -- ADO.NET iş akışlarına bağlanın
• IronXL lisanslama -- dağıtım için lisanslama seçenekleri

Ücretsiz denemeyi başlatın ve IronXL'nin .NET projelerinizde CSV dosyalarını okumayı nasıl kolaylaştırdığını deneyimleyin. Üretim dağıtımı için lisanslama seçenekleri, sınırsız kullanım hakları ve bir yıl destek içerir.