C# içinde Bir CSV Dosyası Nasıl DataTable'a Okunur

CSV'den DataTable'ye Dönüştürme Neden Önemlidir?

CSV'den DataTable'ye dönüşüm, geliştiricilerin virgülle ayrılmış değerleri daha fazla işleme için yapılandırılmış objelere dönüştürmelerine izin verir. İster envanter verisi, müşteri kayıtları veya işlem günlükleri ile uğraşıyor olun, CSV'yi etkili bir şekilde DataTable'ye dönüştürmek önemlidir. İlk satırı sütun başlıkları olarak kullanarak, DataTable sütunlarını veritabanı tablosu şemanızla hizalayabilirsiniz, bu da Excel'den DataSet işlemleri için mükemmel hale getirir.

Geleneksel yaklaşımlar genellikle büyük dosyalar, farklı ayırıcılar veya bellek yönetimi ile mücadele eder. IronXL bu zorlukları ortadan kaldırır ve ekstra kod gerektirmeden farklı ayırıcıları, tırnak içindeki alanları ve gömülü virgülleri ele alır. IronXL'nin CSV okuma yetenekleri yaygın ağrı noktalarını ortadan kaldırırken veri doğrulama ve dosya boyutu kontrolü gibi ek özellikler sağlar.

IronXL Nasıl Kurulur?

IronXL ile başlamak, basit bir NuGet paketi kurulumu gerektirir. Visual Studio'da NuGet Paket Yöneticisi Konsolunu açın ve şunu çalıştırın:

Install-Package IronXL.Excel

Ya da .NET CLI'yı tercih ediyorsanız:

dotnet add package IronXL.Excel

Kurulum tamamlandığında, IronXL ad alanını projenize ekleyin:

using IronXL;
using System.Data;

using IronXL;
using System.Data;

Imports IronXL
Imports System.Data

Bu, hiçbir Excel bağımlılığı olmadan tüm CSV işlem yeteneklerine erişim sağlar. Daha fazla ayrıntı için IronXL belgelendirmesi ve NuGet kurulumu kılavuzu'na bakın.

Bir CSV Dosyasını DataTable'ye Nasıl Dönüştürürsünüz?

IronXL'deki ana iş akışı, sadece birkaç satır kod içerir. CSV dosyasını okuma ve C# 10+'da üst düzey ifadeleri kullanarak DataTable'ye dönüştürme şekli şöyledir:

using IronXL;
using System.Data;

// Load CSV file into a WorkBook object
WorkBook workbook = WorkBook.LoadCSV("sales_data.csv",
    fileFormat: ExcelFileFormat.XLSX);

// Access the default worksheet
WorkSheet worksheet = workbook.DefaultWorkSheet;

// Convert to DataTable with headers
DataTable dataTable = worksheet.ToDataTable(true);

// Display the data
foreach (DataRow row in dataTable.Rows)
{
    foreach (var item in row.ItemArray)
    {
        Console.Write($"{item}\t");
    }
    Console.WriteLine();
}

using IronXL;
using System.Data;

// Load CSV file into a WorkBook object
WorkBook workbook = WorkBook.LoadCSV("sales_data.csv",
    fileFormat: ExcelFileFormat.XLSX);

// Access the default worksheet
WorkSheet worksheet = workbook.DefaultWorkSheet;

// Convert to DataTable with headers
DataTable dataTable = worksheet.ToDataTable(true);

// Display the data
foreach (DataRow row in dataTable.Rows)
{
    foreach (var item in row.ItemArray)
    {
        Console.Write($"{item}\t");
    }
    Console.WriteLine();
}

Imports IronXL
Imports System.Data

' Load CSV file into a WorkBook object
Dim workbook As WorkBook = WorkBook.LoadCSV("sales_data.csv", fileFormat:=ExcelFileFormat.XLSX)

' Access the default worksheet
Dim worksheet As WorkSheet = workbook.DefaultWorkSheet

' Convert to DataTable with headers
Dim dataTable As DataTable = worksheet.ToDataTable(True)

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

LoadCSV metodu, tırnak içindeki alanları ve gömülü virgülleri ele alarak CSV dosyanızı otomatik olarak ayrıştırır. fileFormat parametresi, IronXL'nin CSV verilerini dahili olarak nasıl yorumlayacağını belirler, bu sayede Excel uyumlu bir yapı olarak ele alınmasını sağlar. Yüklendikten sonra, ToDataTable(true) metodu çalışma sayfasını bir DataTable'ye dönüştürür, true parametresi ilk satırın sütun başlıkları olarak kullanılmasını belirtir. Bu, CSV başlıklarınıza uygun adlandırılmış sütunlarla temiz, yapılandırılmış bir DataTable ortaya çıkarır. Daha gelişmiş manipülasyon seçeneklerini keşfetmek için tam IronXL nasıl yapılır kılavuzu'na bakın.

Dönüştürme işlemi ayrıca veri türlerini korur — sayılar sayısal kalır, tarihler doğru bir şekilde ayrıştırılır ve metin alanları biçimlendirmelerini korur. Bu otomatik tür çıkarımı, manuel ayrıştırma yaklaşımlarına kıyasla önemli ölçüde geliştirme süresinden tasarruf sağlar. Özel veri biçimlendirmesi gerektiren senaryolar için, dönüştürmeden önce hücre biçimlendirme uygulayabilirsiniz.

Bir DataTable SQL Server'a Nasıl İthal Edersiniz?

DataTable'nizi bir kez elde ettikten sonra, onu SQL Server'a ithal etmek, SqlBulkCopy kullanarak verimli hale gelir. Aşağıdaki örnek, C# üst düzey ifadelerini kullanır:

using System.Data;
using Microsoft.Data.SqlClient;
using IronXL;

// Create connection string
string connectionString = "Data Source=localhost;Initial Catalog=SalesDB;" +
    "Integrated Security=True;TrustServerCertificate=True;";

// Read CSV into DataTable
WorkBook workbook = WorkBook.LoadCSV("inventory_report.csv");
DataTable dataTable = workbook.DefaultWorkSheet.ToDataTable(true);

// Bulk insert into SQL Server
using SqlConnection connection = new SqlConnection(connectionString);
connection.Open();

using SqlBulkCopy bulkCopy = new SqlBulkCopy(connection);

// Set destination table name
bulkCopy.DestinationTableName = "dbo.Inventory";

// Map DataTable columns to SQL table columns
bulkCopy.ColumnMappings.Add("ProductCode", "product_code");
bulkCopy.ColumnMappings.Add("Quantity", "quantity");
bulkCopy.ColumnMappings.Add("LastUpdated", "last_updated");

// Set batch size for better performance
bulkCopy.BatchSize = 1000;

// Write data to SQL Server
bulkCopy.WriteToServer(dataTable);

Console.WriteLine($"Successfully imported {dataTable.Rows.Count} records");

using System.Data;
using Microsoft.Data.SqlClient;
using IronXL;

// Create connection string
string connectionString = "Data Source=localhost;Initial Catalog=SalesDB;" +
    "Integrated Security=True;TrustServerCertificate=True;";

// Read CSV into DataTable
WorkBook workbook = WorkBook.LoadCSV("inventory_report.csv");
DataTable dataTable = workbook.DefaultWorkSheet.ToDataTable(true);

// Bulk insert into SQL Server
using SqlConnection connection = new SqlConnection(connectionString);
connection.Open();

using SqlBulkCopy bulkCopy = new SqlBulkCopy(connection);

// Set destination table name
bulkCopy.DestinationTableName = "dbo.Inventory";

// Map DataTable columns to SQL table columns
bulkCopy.ColumnMappings.Add("ProductCode", "product_code");
bulkCopy.ColumnMappings.Add("Quantity", "quantity");
bulkCopy.ColumnMappings.Add("LastUpdated", "last_updated");

// Set batch size for better performance
bulkCopy.BatchSize = 1000;

// Write data to SQL Server
bulkCopy.WriteToServer(dataTable);

Console.WriteLine($"Successfully imported {dataTable.Rows.Count} records");

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

' Create connection string
Dim connectionString As String = "Data Source=localhost;Initial Catalog=SalesDB;" &
    "Integrated Security=True;TrustServerCertificate=True;"

' Read CSV into DataTable
Dim workbook As WorkBook = WorkBook.LoadCSV("inventory_report.csv")
Dim dataTable As DataTable = workbook.DefaultWorkSheet.ToDataTable(True)

' Bulk insert into SQL Server
Using connection As New SqlConnection(connectionString)
    connection.Open()

    Using bulkCopy As New SqlBulkCopy(connection)
        ' Set destination table name
        bulkCopy.DestinationTableName = "dbo.Inventory"

        ' Map DataTable columns to SQL table columns
        bulkCopy.ColumnMappings.Add("ProductCode", "product_code")
        bulkCopy.ColumnMappings.Add("Quantity", "quantity")
        bulkCopy.ColumnMappings.Add("LastUpdated", "last_updated")

        ' Set batch size for better performance
        bulkCopy.BatchSize = 1000

        ' Write data to SQL Server
        bulkCopy.WriteToServer(dataTable)
    End Using
End Using

Console.WriteLine($"Successfully imported {dataTable.Rows.Count} records")

SqlBulkCopy sınıfı, büyük ölçekli veri ithalatları için güçlü performans sağlar. ColumnMappings koleksiyonu, veri şemanızda esneklik sağlamak üzere DataTable sütunlarını farklı adlarla veritabanı sütunlarına eşler. BatchSize özelliği, tümünü bir defada yüklemek yerine kayıtları parça parça işleyerek bellek kullanımını optimize eder. IronXL'nin ithalat ve ihracat yetenekleri hakkında daha fazla bilgi edinin.

Ek veri bütünlüğü için, toplu kopya işlemleri etrafında işlem desteği uygulamayı düşünün. Bu, hata oluştuğunda kısmi ithalatların geri alınabilmesini sağlar. Ayrıca veri ithalatı öncesi verileri önceden doğrulamak için IronXL'nin Excel dosyası yazma özelliklerini kullanabilirsiniz.

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

Tüm CSV dosyaları virgüller kullanmaz. IronXL, çeşitli ayırıcıları işler, bu da onu uluslararası veri formatları veya eski sistemler için pratik hale getirir:

using IronXL;
using System;
using System.Data;
using System.IO;

// --- Tab-delimited file ---
string tsvPath = "export_data.tsv";
WorkBook tsvWorkbook = WorkBook.LoadCSV(tsvPath, ExcelFileFormat.XLSX, "\t");

// --- Semicolon-delimited file ---
string semiPath = "european_data.csv";
string tempCsv = Path.Combine(Path.GetTempPath(), "european_data_comma.csv");

// Replace semicolons with commas for proper parsing
string[] lines = File.ReadAllLines(semiPath);
for (int i = 0; i < lines.Length; i++)
{
    lines[i] = lines[i].Replace(';', ',');
}
File.WriteAllLines(tempCsv, lines);

WorkBook semiWorkbook = WorkBook.LoadCSV(tempCsv, ExcelFileFormat.XLSX);

// Print tab-delimited results
DataTable tsvTable = tsvWorkbook.DefaultWorkSheet.ToDataTable(true);
Console.WriteLine("--- Tab-delimited File ---");
foreach (DataColumn col in tsvTable.Columns)
    Console.Write($"{col.ColumnName}\t");
Console.WriteLine();
foreach (DataRow row in tsvTable.Rows)
{
    foreach (var item in row.ItemArray)
        Console.Write($"{item}\t");
    Console.WriteLine();
}

// Print semicolon-delimited results
DataTable semiTable = semiWorkbook.DefaultWorkSheet.ToDataTable(true);
Console.WriteLine("\n--- Semicolon-delimited File ---");
foreach (DataColumn col in semiTable.Columns)
    Console.Write($"{col.ColumnName}\t");
Console.WriteLine();
foreach (DataRow row in semiTable.Rows)
{
    foreach (var item in row.ItemArray)
        Console.Write($"{item}\t");
    Console.WriteLine();
}

using IronXL;
using System;
using System.Data;
using System.IO;

// --- Tab-delimited file ---
string tsvPath = "export_data.tsv";
WorkBook tsvWorkbook = WorkBook.LoadCSV(tsvPath, ExcelFileFormat.XLSX, "\t");

// --- Semicolon-delimited file ---
string semiPath = "european_data.csv";
string tempCsv = Path.Combine(Path.GetTempPath(), "european_data_comma.csv");

// Replace semicolons with commas for proper parsing
string[] lines = File.ReadAllLines(semiPath);
for (int i = 0; i < lines.Length; i++)
{
    lines[i] = lines[i].Replace(';', ',');
}
File.WriteAllLines(tempCsv, lines);

WorkBook semiWorkbook = WorkBook.LoadCSV(tempCsv, ExcelFileFormat.XLSX);

// Print tab-delimited results
DataTable tsvTable = tsvWorkbook.DefaultWorkSheet.ToDataTable(true);
Console.WriteLine("--- Tab-delimited File ---");
foreach (DataColumn col in tsvTable.Columns)
    Console.Write($"{col.ColumnName}\t");
Console.WriteLine();
foreach (DataRow row in tsvTable.Rows)
{
    foreach (var item in row.ItemArray)
        Console.Write($"{item}\t");
    Console.WriteLine();
}

// Print semicolon-delimited results
DataTable semiTable = semiWorkbook.DefaultWorkSheet.ToDataTable(true);
Console.WriteLine("\n--- Semicolon-delimited File ---");
foreach (DataColumn col in semiTable.Columns)
    Console.Write($"{col.ColumnName}\t");
Console.WriteLine();
foreach (DataRow row in semiTable.Rows)
{
    foreach (var item in row.ItemArray)
        Console.Write($"{item}\t");
    Console.WriteLine();
}

Imports IronXL
Imports System
Imports System.Data
Imports System.IO

' --- Tab-delimited file ---
Dim tsvPath As String = "export_data.tsv"
Dim tsvWorkbook As WorkBook = WorkBook.LoadCSV(tsvPath, ExcelFileFormat.XLSX, ControlChars.Tab)

' --- Semicolon-delimited file ---
Dim semiPath As String = "european_data.csv"
Dim tempCsv As String = Path.Combine(Path.GetTempPath(), "european_data_comma.csv")

' Replace semicolons with commas for proper parsing
Dim lines As String() = File.ReadAllLines(semiPath)
For i As Integer = 0 To lines.Length - 1
    lines(i) = lines(i).Replace(";"c, ","c)
Next
File.WriteAllLines(tempCsv, lines)

Dim semiWorkbook As WorkBook = WorkBook.LoadCSV(tempCsv, ExcelFileFormat.XLSX)

' Print tab-delimited results
Dim tsvTable As DataTable = tsvWorkbook.DefaultWorkSheet.ToDataTable(True)
Console.WriteLine("--- Tab-delimited File ---")
For Each col As DataColumn In tsvTable.Columns
    Console.Write($"{col.ColumnName}{ControlChars.Tab}")
Next
Console.WriteLine()
For Each row As DataRow In tsvTable.Rows
    For Each item In row.ItemArray
        Console.Write($"{item}{ControlChars.Tab}")
    Next
    Console.WriteLine()
Next

' Print semicolon-delimited results
Dim semiTable As DataTable = semiWorkbook.DefaultWorkSheet.ToDataTable(True)
Console.WriteLine(vbCrLf & "--- Semicolon-delimited File ---")
For Each col As DataColumn In semiTable.Columns
    Console.Write($"{col.ColumnName}{ControlChars.Tab}")
Next
Console.WriteLine()
For Each row As DataRow In semiTable.Rows
    For Each item In row.ItemArray
        Console.Write($"{item}{ControlChars.Tab}")
    Next
    Console.WriteLine()
Next

Bu kod, farklı sınırlayıcılara sahip CSV dosyalarını IronXL WorkBook objelerine yüklemeyi göstermektedir. Tab ile ayrılmış dosyalar "\t" ayırıcı olarak kullanılmak suretiyle okunur, noktalı virgülle ayrılmış dosyalar ise yüklemeden önce standart CSV formatına dönüştürülür. Daha karmaşık dosya format senaryoları için, Excel verilerini çeşitli formatlara dışa aktarma üzerinde de fikir edinebilirsiniz.

IronXL'nin CSV'nin Ötesindeki Desteklenen Özellikleri Nelerdir?

IronXL, CSV okumanın ötesine çok daha fazlasını kapsar. Kütüphane, C#'ta Excel ve elektronik tablo işlemlerinin tüm spektrumunu ele alır ve veri merkezli uygulamalar için tek bir bağımlılıktır.

Bir Sonraki Adımlar Nelerdir?

IronXL, CSV veritabanı ithalatlarını basit, güvenilir bir sürece dönüştürür. Sadece birkaç satır kod ile:

• LoadCSV özelliğini kullanarak herhangi bir dosya yolundan CSV dosyalarını okuyabilirsiniz
• CSV verilerini uygun veri formatıyla bir DataTable'ye dönüştürün
• Sütun başlıklarını koruyun ve otomatik ayrıştırma yoluyla DataTable sütunları
• Yığın işlemler kullanarak milyonlarca satırı bir veritabanı tablosuna verimli bir şekilde ithal etme

Kütüphane, CSV ayrıştırma, bellek yönetimi ve veri türü dönüşümlerinin karmaşıklıklarını ele alır, böylece iş mantığınıza odaklanmanızı sağlar, dosya işleme ayrıntılarına değil. ASP.NET uygulamaları geliştiriyor, Blazor ile çalışıyor veya .NET 10 masaüstü uygulamaları geliştiriyorsanız, IronXL tüm platformlarda tutarlı, güvenilir CSV işlemleri sağlar.

Başlamaya hazır mısınız? IronXL belgeleri her özelliği derinlemesine kapsar ve bir deneme lisansı, tam kütüphaneyi değerlendirmenize izin verir.