C# içinde CSV dosyaları ile çalışmak, basit satır ayrımı işleme işinden daha fazlasını yönetebilecek bir kütüphane gerektirir. Güvenilir kodlama algılama, doğru sınırlayıcı yönetimi, güçlü tipleme ve ideal olarak CSV ile Excel arasında veri taşıma yeteneğine sahip olmanız gerekir, iki ayrı bağımlılığı sürdürmeden. IronXL, tüm bunları tek bir .NET kütüphanesinde sağlar -- Microsoft Office gerektirmez, COM geçişkesi yok ve kırılgan çözümler yok. İster sunucudaki düz veri dosyalarını işleyin, bir veri hattı oluşturun veya kullanıcılara bir hesap tablosu indirme sunun, IronXL size her format için tutarlı bir API sunar.

C# Elektronik Tablo Kütüphanesi Nasıl Kurulur?

IronXL'nin kurulumu NuGet üzerinden bir dakikadan az sürer. Visual Studio Paket Yöneticisi Konsolu'nu açın ve aşağıdaki komutu çalıştırın veya herhangi bir terminalden .NET CLI kullanın:

Install-Package IronXL.Excel

Paket kurulduktan sonra, çalışmak istediğiniz herhangi bir dosyada alan adını ekleyin:

using IronXL;

using IronXL;

Imports IronXL

Imports IronXL

IronXL, .NET Framework 4.6.2+ ve tüm modern .NET sürümlerini (Core, 5, 6, 7, 8, 9 ve 10) hedefler. Windows, Linux ve macOS üzerinde çalışır, hem masaüstü araçları hem de konteynerleştirilmiş sunucu iş yükleri için uygundur. Paket kaynakları ve lisans aktivasyonu talimatlarını içeren adım adım kılavuz için IronXL kurulum kılavuzuna göz atın.

C#'da CSV Dosyaları Nasıl Okunur?

IronXL ile bir CSV dosyasını okumak, herhangi bir hesap tablosunu yükleme ile aynı deseni takip eder. Dosya yoluyla WorkBook.Load çağrıldığında IronXL, uzantısından formatı çıkarır -- ek yapılandırma gerekmez:

// Load a CSV file into a WorkBook
WorkBook workBook = WorkBook.Load("sales_data.csv");

// Access the default worksheet
WorkSheet workSheet = workBook.DefaultWorkSheet;

// Read individual cells by Excel-style address
string customerName = workSheet["A2"].StringValue;
decimal orderAmount = workSheet["B2"].DecimalValue;

// Iterate rows, starting at index 1 to skip the header
for (int i = 1; i < workSheet.Rows.Count(); i++)
{
    var row = workSheet.Rows[i];
    Console.WriteLine($"Customer: {row.Columns[0].Value}, Amount: {row.Columns[1].Value}");
}

// Load a CSV file into a WorkBook
WorkBook workBook = WorkBook.Load("sales_data.csv");

// Access the default worksheet
WorkSheet workSheet = workBook.DefaultWorkSheet;

// Read individual cells by Excel-style address
string customerName = workSheet["A2"].StringValue;
decimal orderAmount = workSheet["B2"].DecimalValue;

// Iterate rows, starting at index 1 to skip the header
for (int i = 1; i < workSheet.Rows.Count(); i++)
{
    var row = workSheet.Rows[i];
    Console.WriteLine($"Customer: {row.Columns[0].Value}, Amount: {row.Columns[1].Value}");
}

Imports System

' Load a CSV file into a WorkBook
Dim workBook As WorkBook = WorkBook.Load("sales_data.csv")

' Access the default worksheet
Dim workSheet As WorkSheet = workBook.DefaultWorkSheet

' Read individual cells by Excel-style address
Dim customerName As String = workSheet("A2").StringValue
Dim orderAmount As Decimal = workSheet("B2").DecimalValue

' Iterate rows, starting at index 1 to skip the header
For i As Integer = 1 To workSheet.Rows.Count() - 1
    Dim row = workSheet.Rows(i)
    Console.WriteLine($"Customer: {row.Columns(0).Value}, Amount: {row.Columns(1).Value}")
Next

Imports System

' Load a CSV file into a WorkBook
Dim workBook As WorkBook = WorkBook.Load("sales_data.csv")

' Access the default worksheet
Dim workSheet As WorkSheet = workBook.DefaultWorkSheet

' Read individual cells by Excel-style address
Dim customerName As String = workSheet("A2").StringValue
Dim orderAmount As Decimal = workSheet("B2").DecimalValue

' Iterate rows, starting at index 1 to skip the header
For i As Integer = 1 To workSheet.Rows.Count() - 1
    Dim row = workSheet.Rows(i)
    Console.WriteLine($"Customer: {row.Columns(0).Value}, Amount: {row.Columns(1).Value}")
Next

WorkBook nesnesi, tam hesap tablosu modelini ortaya çıkarır. Hücrelere "A2" gibi tanıdık Excel notasyonlarıyla ve yerleşik dönüşüm özellikleriyle -- StringValue, DecimalValue, IntValue, DateTimeValue -- erişilir, böylece tür zorlaması elle yapılmaz.

Ne Tür Hücre Adresleme Seçenekleri Mevcuttur?

Tek hücre erişiminin ötesinde, IronXL aralık notasyonunu ve satır/sütun yinelemesini destekler. Dikdörtgen bir hücre bloğu, workSheet["A2:C10"] gibi bir aralık ifadesi ile adreslenebilir ve düz bir koleksiyon olarak dolaşılabilir. Aşağıda, bilinen bir veri bloğunu iç içe döngüler yazmadan doğrulamak veya dönüştürmek istediğinizde kullanışlıdır:

// Access a range and print each value
foreach (var cell in workSheet["A2:C10"])
{
    Console.WriteLine($"{cell.AddressString}: {cell.Value}");
}

// Access a range and print each value
foreach (var cell in workSheet["A2:C10"])
{
    Console.WriteLine($"{cell.AddressString}: {cell.Value}");
}

' Access a range and print each value
For Each cell In workSheet("A2:C10")
    Console.WriteLine($"{cell.AddressString}: {cell.Value}")
Next

' Access a range and print each value
For Each cell In workSheet("A2:C10")
    Console.WriteLine($"{cell.AddressString}: {cell.Value}")
Next

Dinamik satır sayıları için, workSheet.Rows koleksiyonu yüklenen verileri otomatik olarak yansıtır, bu nedenle satır sayılarının kodlanmasına gerek yoktur. Başlık algılama ve çoklu kodlama dosyaları dahil olmak üzere daha fazla desen için C# CSV okuma eğitimini inceleyin.

CSV Satırlarını Özel Nesnelere Nasıl Eşlersiniz?

Yaygın bir gereksinim, tablolar halinde olan CSV verilerini türlendirilmiş bir koleksiyona dönüştürmektir. Satırları yineleyebilir ve her birini basit bir C# sınıfına yansıtabilirsiniz:

public record SalesRecord(string Customer, decimal Amount, DateTime OrderDate);

WorkBook workBook = WorkBook.Load("sales_data.csv");
WorkSheet workSheet = workBook.DefaultWorkSheet;

var records = new List<SalesRecord>();

// Start at row 1 to skip the header row (row 0)
for (int i = 1; i < workSheet.Rows.Count(); i++)
{
    var row = workSheet.Rows[i];
    records.Add(new SalesRecord(
        Customer: row.Columns[0].StringValue,
        Amount: row.Columns[1].DecimalValue,
        OrderDate: row.Columns[2].DateTimeValue
    ));
}

public record SalesRecord(string Customer, decimal Amount, DateTime OrderDate);

WorkBook workBook = WorkBook.Load("sales_data.csv");
WorkSheet workSheet = workBook.DefaultWorkSheet;

var records = new List<SalesRecord>();

// Start at row 1 to skip the header row (row 0)
for (int i = 1; i < workSheet.Rows.Count(); i++)
{
    var row = workSheet.Rows[i];
    records.Add(new SalesRecord(
        Customer: row.Columns[0].StringValue,
        Amount: row.Columns[1].DecimalValue,
        OrderDate: row.Columns[2].DateTimeValue
    ));
}

Imports System
Imports System.Collections.Generic

Public Class SalesRecord
    Public Property Customer As String
    Public Property Amount As Decimal
    Public Property OrderDate As DateTime

    Public Sub New(customer As String, amount As Decimal, orderDate As DateTime)
        Me.Customer = customer
        Me.Amount = amount
        Me.OrderDate = orderDate
    End Sub
End Class

Dim workBook As WorkBook = WorkBook.Load("sales_data.csv")
Dim workSheet As WorkSheet = workBook.DefaultWorkSheet

Dim records As New List(Of SalesRecord)()

' Start at row 1 to skip the header row (row 0)
For i As Integer = 1 To workSheet.Rows.Count() - 1
    Dim row = workSheet.Rows(i)
    records.Add(New SalesRecord(
        Customer:=row.Columns(0).StringValue,
        Amount:=row.Columns(1).DecimalValue,
        OrderDate:=row.Columns(2).DateTimeValue
    ))
Next

Imports System
Imports System.Collections.Generic

Public Class SalesRecord
    Public Property Customer As String
    Public Property Amount As Decimal
    Public Property OrderDate As DateTime

    Public Sub New(customer As String, amount As Decimal, orderDate As DateTime)
        Me.Customer = customer
        Me.Amount = amount
        Me.OrderDate = orderDate
    End Sub
End Class

Dim workBook As WorkBook = WorkBook.Load("sales_data.csv")
Dim workSheet As WorkSheet = workBook.DefaultWorkSheet

Dim records As New List(Of SalesRecord)()

' Start at row 1 to skip the header row (row 0)
For i As Integer = 1 To workSheet.Rows.Count() - 1
    Dim row = workSheet.Rows(i)
    records.Add(New SalesRecord(
        Customer:=row.Columns(0).StringValue,
        Amount:=row.Columns(1).DecimalValue,
        OrderDate:=row.Columns(2).DateTimeValue
    ))
Next

Bu yaklaşım, ayrıştırma mantığını iş mantığından temiz bir şekilde ayırır ve her kaydı uygulamanızın geri kalanında güçlü bir şekilde türlendirilmiş hale getirir.

CSV Dosyalarını C#'da Nasıl Yazarız?

Sıfırdan bir CSV dosyası oluşturmak üç adım içerir: bir WorkBook oluşturmak, bir WorkSheet doldurmak ve SaveAsCsv çağrısı yapmak. Süreç, herhangi bir elektronik tabloyu nasıl inşa edeceğinizi yansıtır, bu da API'yı çıktı formatından bağımsız olarak tutarlı kılar:

// Create a new workbook and worksheet
WorkBook workBook = WorkBook.Create();
WorkSheet workSheet = workBook.CreateWorkSheet("inventory");

// Write header row
workSheet["A1"].Value = "Product";
workSheet["B1"].Value = "Quantity";
workSheet["C1"].Value = "Price";

// Write data rows
workSheet["A2"].Value = "Widget A";
workSheet["B2"].Value = 250;
workSheet["C2"].Value = 9.99;

workSheet["A3"].Value = "Gadget B";
workSheet["B3"].Value = 120;
workSheet["C3"].Value = 24.50;

// Export to CSV
workBook.SaveAsCsv("inventory.csv");

// Create a new workbook and worksheet
WorkBook workBook = WorkBook.Create();
WorkSheet workSheet = workBook.CreateWorkSheet("inventory");

// Write header row
workSheet["A1"].Value = "Product";
workSheet["B1"].Value = "Quantity";
workSheet["C1"].Value = "Price";

// Write data rows
workSheet["A2"].Value = "Widget A";
workSheet["B2"].Value = 250;
workSheet["C2"].Value = 9.99;

workSheet["A3"].Value = "Gadget B";
workSheet["B3"].Value = 120;
workSheet["C3"].Value = 24.50;

// Export to CSV
workBook.SaveAsCsv("inventory.csv");

' Create a new workbook and worksheet
Dim workBook As WorkBook = WorkBook.Create()
Dim workSheet As WorkSheet = workBook.CreateWorkSheet("inventory")

' Write header row
workSheet("A1").Value = "Product"
workSheet("B1").Value = "Quantity"
workSheet("C1").Value = "Price"

' Write data rows
workSheet("A2").Value = "Widget A"
workSheet("B2").Value = 250
workSheet("C2").Value = 9.99D

workSheet("A3").Value = "Gadget B"
workSheet("B3").Value = 120
workSheet("C3").Value = 24.5D

' Export to CSV
workBook.SaveAsCsv("inventory.csv")

' Create a new workbook and worksheet
Dim workBook As WorkBook = WorkBook.Create()
Dim workSheet As WorkSheet = workBook.CreateWorkSheet("inventory")

' Write header row
workSheet("A1").Value = "Product"
workSheet("B1").Value = "Quantity"
workSheet("C1").Value = "Price"

' Write data rows
workSheet("A2").Value = "Widget A"
workSheet("B2").Value = 250
workSheet("C2").Value = 9.99D

workSheet("A3").Value = "Gadget B"
workSheet("B3").Value = 120
workSheet("C3").Value = 24.5D

' Export to CSV
workBook.SaveAsCsv("inventory.csv")

SaveAsCsv, sınırlayıcı yerleştirmeyi, virgül içeren alanların tırnaklanmasını ve yeni satır normalleştirmesini yönetir. Bunların hiçbirini elle yönetmeniz gerekmiyor. IronXL, Excel veya pandas gibi son kullanımların sayıları metin dizeleri olarak değil, sayı olarak okuması için ihracat sırasında sayısal türleri korur.

Bir DataTable'ı CSV'ye Nasıl Aktarırsınız?

Birçok uygulama, bir veri tabanından verileri bir DataTable içine çeker. IronXL, bir arama ile bir çalışma sayfasına tüm DataTable ekleyebilir, böylece toplu dışa aktarmalar kolaylaşır:

DataTable dataTable = GetProductsFromDatabase();

WorkBook workBook = WorkBook.Create();
WorkSheet workSheet = workBook.CreateWorkSheet("products");

workSheet.InsertDataTable(dataTable, "A1");

workBook.SaveAsCsv("products.csv");

DataTable dataTable = GetProductsFromDatabase();

WorkBook workBook = WorkBook.Create();
WorkSheet workSheet = workBook.CreateWorkSheet("products");

workSheet.InsertDataTable(dataTable, "A1");

workBook.SaveAsCsv("products.csv");

IRON VB CONVERTER ERROR developers@ironsoftware.com

IRON VB CONVERTER ERROR developers@ironsoftware.com

InsertDataTable metodu, DataTable şemasından sütun başlıklarını yazar ve sizin belirttiğiniz adresten başlayarak tüm satırları doldurur. Daha büyük veri kümeleri için bu, satırlar arasında elle döngü yapmak yerine çok daha verimlidir. Özelleştirilmiş ayırıcılar ve kodlama ayarları gibi seçenekleri içeren CSV ihracat belgelerini kontrol edin.

CSV ve Excel Arasında Dönüşüm Yapımı C#'da Nasıl Olur?

IronXL'nin sağladığı en değerli olanaklardan biri, CSV ve Excel formatları arasında çift yönlü dönüşümdür. API simetriktir -- Load desteklenen herhangi bir formatı okur ve Save yöntemleri ailesi hedef formatınıza yazar:

// Convert CSV to Excel
WorkBook csvWorkBook = WorkBook.Load("data.csv");
csvWorkBook.SaveAs("data.xlsx");

// Convert Excel back to CSV
WorkBook xlsxWorkBook = WorkBook.Load("report.xlsx");
xlsxWorkBook.SaveAsCsv("report.csv");

// Convert CSV to Excel
WorkBook csvWorkBook = WorkBook.Load("data.csv");
csvWorkBook.SaveAs("data.xlsx");

// Convert Excel back to CSV
WorkBook xlsxWorkBook = WorkBook.Load("report.xlsx");
xlsxWorkBook.SaveAsCsv("report.csv");

' Convert CSV to Excel
Dim csvWorkBook As WorkBook = WorkBook.Load("data.csv")
csvWorkBook.SaveAs("data.xlsx")

' Convert Excel back to CSV
Dim xlsxWorkBook As WorkBook = WorkBook.Load("report.xlsx")
xlsxWorkBook.SaveAsCsv("report.csv")

' Convert CSV to Excel
Dim csvWorkBook As WorkBook = WorkBook.Load("data.csv")
csvWorkBook.SaveAs("data.xlsx")

' Convert Excel back to CSV
Dim xlsxWorkBook As WorkBook = WorkBook.Load("report.xlsx")
xlsxWorkBook.SaveAsCsv("report.csv")

Bu dönüşümler veri bütünlüğünü korur. Sayısal değerler sayısal kalır, tarih alanları türlerini korur ve formül sonuçları yazmadan önce hesaplanır. Çok sayfalı bir Excel dosyasını CSV'ye dönüştürdüğünüzde, IronXL her bir çalışma sayfası için ayrı bir CSV dosyası oluşturur:

WorkBook multiSheetWorkBook = WorkBook.Load("quarterly_report.xlsx");

// Produces: quarterly_report.Sheet1.csv, quarterly_report.Sheet2.csv, etc.
multiSheetWorkBook.SaveAsCsv("quarterly_report.csv");

WorkBook multiSheetWorkBook = WorkBook.Load("quarterly_report.xlsx");

// Produces: quarterly_report.Sheet1.csv, quarterly_report.Sheet2.csv, etc.
multiSheetWorkBook.SaveAsCsv("quarterly_report.csv");

Dim multiSheetWorkBook As WorkBook = WorkBook.Load("quarterly_report.xlsx")

' Produces: quarterly_report.Sheet1.csv, quarterly_report.Sheet2.csv, etc.
multiSheetWorkBook.SaveAsCsv("quarterly_report.csv")

Dim multiSheetWorkBook As WorkBook = WorkBook.Load("quarterly_report.xlsx")

' Produces: quarterly_report.Sheet1.csv, quarterly_report.Sheet2.csv, etc.
multiSheetWorkBook.SaveAsCsv("quarterly_report.csv")

Bu davranış, raporlama hatlarında, alt kullanıcıların her dosya başına bir konu beklediği durumlarda özellikle faydalıdır. CSV yazma eğitimi ayırıcı karakterini belirleme ve ihracat sırasında hangi sayfaların dahil edileceğini kontrol etme gibi ek seçenekler içerir.

İlk Adım:

Ücretsiz Başlayın

Neden Sadece CSV Kütüphaneleri Gerçek Projeler İçin Yetersiz Kalır?

Many C# developers start with CsvHelper or the TextFieldParser from Microsoft.VisualBasic. Her ikisi de yalnızca CSV ile çalışan iş akışları için yetenekli araçlardır. Aradaki fark, gereksinimler genişlediğinde ortaya çıkar: bir hissedar CSV yerine Excel indirmesi talep eder, finans formüllerin korunmasını ister veya güvenlik politikası şifre korumalı dosyalar gerektirir. Bu noktada, yalnızca CSV kütüphanesi sizi ikinci bir bağımlılık eklemek ve iki ayrı entegrasyon yolunu sürdürmek zorunda bırakır. Birleşik bir elektronik tablo kütüphanesi, bu ayrımı en baştan ortadan kaldırır.

Birleşik Bir Kütüphanenin Sağladığı Ek Elektronik Tablo Özellikleri Nelerdir?

Format dönüşümünün ötesinde, hem CSV hem de Excel'i ele alan bir kütüphane, projeler büyüdükçe faydalı hale gelen elektronik tablo işlemleri sunar. Özellikle IronXL ile şunları elde edersiniz:

• Formül değerlendirme -- =SUM(B2:B10) gibi formülleri hücrelere yazabilir ve hesaplanan sonucu Excel olmadan geri okuyabilirsiniz.
• Hücre ve menzil stilleme -- IronXL stil API'sini kullanarak yazı tipi ağırlıklarını, arka plan renklerini, sayı formatlarını ve kenarları uygulayın.
• Şifre koruması -- WorkBook.Load("secure.xlsx", "password") ile şifrelenmiş çalışma kitaplarını açabilir ve yeni dosyaları şifreleme ile kaydedebilirsiniz.
• Adlandırılmış aralıklar -- Excel'de yaptığınız gibi adlandırılmış bölgeler tanımlayın ve referans verin, bu da formül yazımını ve veri doğrulamasını basitleştirir.
• Büyük dosya desteği -- IronXL, tüm dosyayı bir kerede belleğe yüklemeden yönetilen kodda veri işler, bu da on binlerce satırlı dosyalar için bile bellek kullanımını tahmin edilebilir tutar.

IronXL özellikler sayfası desteklenen işlemlerin tam listesini içerir.

IronXL Çapraz Platform Dağıtımları Nasıl Yönetir?

Elektronik tablo kütüphanelerinde yinelenen bir zorluk, platforma özgü davranıştır. COM interop'a bağımlı kütüphaneler yalnızca Windows'ta çalışır ve Office'ten kabuk kullanan kütüphaneler bir Office kurulumu gerektirir. IronXL tamamen yönetilen koddur ve yerel bağımlılıklar yoktur, bu yüzden aynı ikili dosya Linux konteynerlerinde, macOS geliştirme makinelerinde ve Windows sunucularında değişiklik yapmadan çalışır. Bu, Azure, AWS, Docker veya herhangi bir .NET 10 hedefe dağıtmayı basitleştirir.

Dapper veya Entity Framework Core gibi araçlarla veri hatları oluşturan geliştiriciler için IronXL, serileştirme katmanı olarak doğal bir şekilde uyar -- CSV girişlerini okuyun, ORM ile işleyin, sonucu XLSX veya CSV olarak ihraç edin. Ticari kullanım için mevcut lisans katmanlarını açıklayan IronXL lisans sayfası.

Sonraki Adımlarınız Neler?

IronXL, herhangi bir .NET 10 uygulamasında CSV ve Excel dosyalarını okuma, yazma ve dönüştürme için tek bir tutarlı API sağlar. Temel avantajlar basittir: Ofis bağımlılığı olmadan, çapraz platform desteği, hücre değerleri için güçlü tip tanımı ve gereksinimler değiştiğinde yalnızca CSV projelerinden tam elektronik tablo işlevselliğine doğru doğrudan bir yol.

Derinlemesine gitmeye hazır olduğunuzda, mevcut projenizle en alakalı olan konularla başlayın. Eğer esas olarak CSV ithalat hatlarıyla uğraşıyorsanız, yukarıda ele alınan okuma ve eşleme desenleri gerçek dünya senaryolarının çoğunu yönetir. Çıktı gereksinimleriniz değişiyorsa -- bazen alt script'ler için CSV, bazen son kullanıcılar için XLSX -- format dönüşüm bölümü her iki formatı da tek bir kod tabanıyla nasıl sunacağınızı gösterir.

Raporlama sistemleri oluşturan veya veri tabanlarından sonuçları dışa aktaran ekipler için InsertDataTable yaklaşımı iyi ölçeklenir ve satır bazında hücre atamasının performans yükünü önler. Bunu hücre stillendirmeyle birleştirerek kullanıcıların Excel'de doğrudan açabileceği raporlar üretin ve formatlama değişikliklerine gerek kalmadan.

İlerlemek için şu adımları izleyin:

1. Install-Package IronXL veya dotnet add package IronXL kullanarak kütüphaneyi NuGet ile kurun.
2. IronXL başlangıç kılavuzundaki hızlı başlangıcı izleyin ve ilk CSV dosyanızı yükleyin.
3. Aynı projede her iki formata da ihtiyacınız olduğunda CSV'den Excel'e dönüştürme eğitimini keşfedin.
4. IronXL nesne referansında API referansı için ileri seviye hücre işlemleri, formül desteği ve stil kılavuzu tarayın.
5. Ücretsiz bir denemeye başlayın IronXL deneme lisans sayfasında -- kredi kartı gerekmez, teknik destek içerir.

Diğer Iron Software araçları ile birlikte seçenekleri değerlendiriyorsanız, PDF oluşturma, barkod okuma, OCR ve daha fazlasını içeren Iron Software ürün suite'i aynı lisans modeli ve destek kanalını paylaşır.