IronXL ile CsvWriter Arasındaki Bir Karşılaştırma

IronXL Özellik Seti

• XLS/XLSX/CSV/TSV'den veri yükleme, okuma ve düzenleme
• Kaydetme ve dışa aktarma — XLS/XLSX/CSV/TSV/JSON'a
• Aralıklar — kolay kullanım için Çalışma Sayfası ["A1:B10"] söz dizimi. Aralıkları kolaylıkla birleştirin ve oluşturun.
• Sıralama — aralıklar, sütunlar ve satırları sıralayın.
• Stil — hücre görsel stilleri, yazı tipi, boyut, arka plan deseni, kenarlık, hizalama ve sayı formatları.

CsvWriter Özellikleri

• Hızlı: son derece hızlı performans için kuvvetli sınıflar derler
• Esnek: yazarken muhafazakâr, okurken liberal
• Kullanımı kolay: okumak ve yazmak, GetRecords<t>() ve WriteRecords(records) kadar basittir
• Yüksek derecede yapılandırılabilir
• Linux modu
• Düşük bellek kullanımı

2.1. NuGet paketleriyle Visual Studio Kullanarak

Visual Studio, projelerinizde NuGet paketlerini yüklemek için NuGet Paket Yöneticisi sağlar. Buna Proje Menüsü aracılığıyla veya Çözüm Gezgini'nde projenize sağ tıklayabilirsiniz.

Paket-Yönet-NuGet-Paketi

• Şimdi, arama sekmesinden -> IronXL.Excel'i arayın -> Kur

IronXL'i ara

• Tamamladık.

2.2. NuGet Paketini Doğrudan İndir

Bu, NuGet sitesine doğrudan gidip paketi indirerek yapılabilir. Adımlar şunlardır:

• Navigate to https://www.nuget.org/packages/IronXL.Excel
• "Paket İndir"i seçin
• İndirilen paketi çift tıklayın
• Paket yüklenecek
• Visual Studio projenizi yeniden yükleyin ve kullanmaya başlayın

2.3. DLL ile Manuel Kurulum

IronXL C# Kütüphanesini indirip yüklemenin bir başka yöntemi, Geliştirici Komut İstemi aracılığıyla IronXLNuGet paketini yüklemek için aşağıdaki adımları kullanmaktır.

• Geliştirici Komut İstemini açın — genellikle Visual Studio klasöründe bulunur.
• Aşağıdaki komutu yazın:

  Install-Package IronXL.Excel

• Enter'a basın
• Bu, paketi indirecek ve kuracaktır
• Visual Studio projenizi yeniden yükleyin ve kullanmaya başlayın

2.4. Gerekli Using Direktiflerini Ekleyin

1. Çözüm Gezgini'nde Program.cs dosyasını sağ tıklayın ve ardından Kodu Görüntüle'yi tıklayın.
2. Kodu dosyasının üstüne aşağıdaki using direktiflerini ekleyin:

using IronXL;

using IronXL;

Imports IronXL

Hepsi tamam! IronXL indirildi, kuruldu ve kullanıma hazır. Ancak, bundan önce CsvHelper'ı kurmalıyız.

3.1. NuGet Paket Yöneticisi Konsolunu Kullanarak

CSVWriter ile çalışmak için CsvHelper C# Kütüphanesini indirip kurmanız gerekir. Bunu yapmak için, NuGet paketini Developer Command Prompt üzerinden yüklemek üzere aşağıdaki adımları kullanın.

• Geliştirici Komut İstemini açın — genellikle Visual Studio klasöründe bulunur.
• Aşağıdaki komutu yazın:

  Install-Package CsvHelper -Version 27.2.1

• Enter'a basın
• Bu, paketi indirecek ve kuracaktır
• Visual Studio projenizi yeniden yükleyin ve kullanmaya başlayın
• Uygulama için CsvHelper.CsvWriter yöntem detayını kontrol edin

3.2. Doğrudan İndirme

NuGet web sitesinden indir: https://www.nuget.org/packages/CsvHelper/

4.1. Bir CSV Dosyasını Excel Formatına Dönüştürme

Süreç oldukça basit ve kolaydır. Genellikle bir satır kod ile yapılır.

CSV'den Excel formatlarına:

// Load the CSV file and specify the format and delimiter
WorkBook workbook = WorkBook.LoadCSV("test.csv", fileFormat: ExcelFileFormat.XLSX, ListDelimiter: ",");
// Get the default worksheet
WorkSheet ws = workbook.DefaultWorkSheet;

// Save the workbook as an Excel file
workbook.SaveAs("CsvToExcelConversion.xlsx");

// Load the CSV file and specify the format and delimiter
WorkBook workbook = WorkBook.LoadCSV("test.csv", fileFormat: ExcelFileFormat.XLSX, ListDelimiter: ",");
// Get the default worksheet
WorkSheet ws = workbook.DefaultWorkSheet;

// Save the workbook as an Excel file
workbook.SaveAs("CsvToExcelConversion.xlsx");

' Load the CSV file and specify the format and delimiter
Dim workbook As WorkBook = WorkBook.LoadCSV("test.csv", fileFormat:= ExcelFileFormat.XLSX, ListDelimiter:= ",")
' Get the default worksheet
Dim ws As WorkSheet = workbook.DefaultWorkSheet

' Save the workbook as an Excel file
workbook.SaveAs("CsvToExcelConversion.xlsx")

4.2. Dönüştürülmüş CSV Dosyalarını IronXL Kullanarak Okuma ve İşleme

IronXL WorkBook sınıfı bir Excel sayfasını temsil eder. Bir Excel Dosyasını C# kullanarak açmak için WorkBook.Load kullanırız ve Excel dosyasının (.xlsx) yolunu belirleriz. Dosyayı okumak için kullanıldığı basit bir satırlık kod aşağıdadır:

// Load WorkBook
var workbook = WorkBook.Load(@"Spreadsheets\\sample.xlsx");

// Load WorkBook
var workbook = WorkBook.Load(@"Spreadsheets\\sample.xlsx");

' Load WorkBook
Dim workbook = WorkBook.Load("Spreadsheets\\sample.xlsx")

Her WorkBook birden fazla WorkSheet nesnesi içerebilir. Bunlar, Excel belgesindeki çalışma sayfalarını temsil eder. Çalışma kitabı çalışma sayfaları içeriyorsa, onları şu şekilde adlarına göre alabilirsiniz:

// Open Sheet for reading
var worksheet = workbook.GetWorkSheet("sheetnamegoeshere");

// Open Sheet for reading
var worksheet = workbook.GetWorkSheet("sheetnamegoeshere");

' Open Sheet for reading
Dim worksheet = workbook.GetWorkSheet("sheetnamegoeshere")

Hücre değerlerini okuma kodu:

// Read from Ranges of cells elegantly.
foreach (var cell in worksheet["A2:A10"])
{
    Console.WriteLine("Cell {0} has value '{1}'", cell.AddressString, cell.Text);
}

// Read from Ranges of cells elegantly.
foreach (var cell in worksheet["A2:A10"])
{
    Console.WriteLine("Cell {0} has value '{1}'", cell.AddressString, cell.Text);
}

' Read from Ranges of cells elegantly.
For Each cell In worksheet("A2:A10")
	Console.WriteLine("Cell {0} has value '{1}'", cell.AddressString, cell.Text)
Next cell

Çalışma kitabını ve çalışma sayfasını yükledikten ve okuduktan sonra, aşağıdaki kod örneği, formülleri değiştirmek veya belirli hücrelere formül uygulamak için kullanılabilir. Kod şöyle devam ediyor:

// Set Formulas
worksheet["A1"].Formula = "Sum(B8:C12)";
worksheet["B8"].Formula = "=C9/C11";
worksheet["G30"].Formula = "Max(C3:C7)";

// Force recalculate all formula values in all sheets.  
workbook.EvaluateAll();

// Set Formulas
worksheet["A1"].Formula = "Sum(B8:C12)";
worksheet["B8"].Formula = "=C9/C11";
worksheet["G30"].Formula = "Max(C3:C7)";

// Force recalculate all formula values in all sheets.  
workbook.EvaluateAll();

' Set Formulas
worksheet("A1").Formula = "Sum(B8:C12)"
worksheet("B8").Formula = "=C9/C11"
worksheet("G30").Formula = "Max(C3:C7)"

' Force recalculate all formula values in all sheets.  
workbook.EvaluateAll()

4.3. Excel belgesini tekrar CSV Dosyasına Kaydetme

IronXL ile CSV dosyaları yazmak kolay bir süreçtir. Aşağıdaki kod, sadece SaveAsCsv metodunu kullanarak Excel dosyasını CSV formatında kaydeder.

// Load the workbook
WorkBook wb = WorkBook.Load("Normal_Excel_File.xlsx");
// Save as .csv file
wb.SaveAsCsv("SaveAsCSV.csv", ",");
// Saved as : SaveAsCSV.Sheet1.csv

// Load the workbook
WorkBook wb = WorkBook.Load("Normal_Excel_File.xlsx");
// Save as .csv file
wb.SaveAsCsv("SaveAsCSV.csv", ",");
// Saved as : SaveAsCSV.Sheet1.csv

' Load the workbook
Dim wb As WorkBook = WorkBook.Load("Normal_Excel_File.xlsx")
' Save as .csv file
wb.SaveAsCsv("SaveAsCSV.csv", ",")
' Saved as : SaveAsCSV.Sheet1.csv

5.1. Basit Bir Konsol Uygulaması Oluşturma

Visual Studio kullanarak sağlanan ayırıcı ile basit bir CSVWriter konsol uygulaması oluşturun. Proje oluşturulduktan sonra, bir Kişi sınıfı oluşturmanın bir sonraki adımıdır:

public class Person
{
    public int Id { get; set; }
    public string Name { get; set; }
    public bool IsLiving { get; set; }
}

public class Person
{
    public int Id { get; set; }
    public string Name { get; set; }
    public bool IsLiving { get; set; }
}

Public Class Person
	Public Property Id() As Integer
	Public Property Name() As String
	Public Property IsLiving() As Boolean
End Class

Ana yöntem içinde, şimdi bir Kişi nesneleri listesi oluşturalım ve bunu CSV dosyasına yazacağız:

var myPersonObjects = new List<Person>()
{
    new Person { Id = 1, IsLiving = true, Name = "John" },
    new Person { Id = 2, IsLiving = true, Name = "Steve" },
    new Person { Id = 3, IsLiving = true, Name = "James" }
};

var myPersonObjects = new List<Person>()
{
    new Person { Id = 1, IsLiving = true, Name = "John" },
    new Person { Id = 2, IsLiving = true, Name = "Steve" },
    new Person { Id = 3, IsLiving = true, Name = "James" }
};

Dim myPersonObjects = New List(Of Person)() From {
	New Person With {
		.Id = 1,
		.IsLiving = True,
		.Name = "John"
	},
	New Person With {
		.Id = 2,
		.IsLiving = True,
		.Name = "Steve"
	},
	New Person With {
		.Id = 3,
		.IsLiving = True,
		.Name = "James"
	}
}

5.2. Varsayılan Ayarlarla C# ile Bir CSV Dosyasına Yazma

CsvHelper, CSVWriter yöntemi ile C#'da CSV yazmanın standart bir yolu haline gelmiştir ve kullanımı oldukça kolaydır:

using (var writer = new StreamWriter("filePersons.csv"))
using (var csv = new CsvWriter(writer, CultureInfo.InvariantCulture))
{
    csv.WriteRecords(myPersonObjects);
}

using (var writer = new StreamWriter("filePersons.csv"))
using (var csv = new CsvWriter(writer, CultureInfo.InvariantCulture))
{
    csv.WriteRecords(myPersonObjects);
}

Using writer = New StreamWriter("filePersons.csv")
Using csv = New CsvWriter(writer, CultureInfo.InvariantCulture)
	csv.WriteRecords(myPersonObjects)
End Using
End Using

5.3. Veri Eklemek

Programımızı her çalıştırdığımızda, eski CSV dosyalarının üzerine yazılacağını unutmamamız gerekir. Bazen mevcut verilerin üzerine yazmak yerine dosyanın sonuna veri eklemek isteyebiliriz. CSVWriter, sağlanan ayırıcı ile bir dosya açma/yazma sorumluluğunda olmadığından bunun için bir yöntem sağlamaz. Bunu bir FileStream kullanarak gerçekleştirebiliriz ve ardından bu FileStream kullanarak StreamWriter'ımızı oluşturabiliriz. Bu makalenin kapsamına girmese de, herhangi bir uygulamanın ayrılmaz bir parçası olduğundan bunu nasıl yapacağınızı göstereceğim.

var configPersons = new CsvConfiguration(CultureInfo.InvariantCulture)
{
    HasHeaderRecord = false
};
using (var stream = File.Open("filePersons.csv", FileMode.Append))
using (var writer = new StreamWriter(stream))
using (var csv = new CsvWriter(writer, configPersons))
{
    csv.WriteRecords(myPersonObjects);
}

var configPersons = new CsvConfiguration(CultureInfo.InvariantCulture)
{
    HasHeaderRecord = false
};
using (var stream = File.Open("filePersons.csv", FileMode.Append))
using (var writer = new StreamWriter(stream))
using (var csv = new CsvWriter(writer, configPersons))
{
    csv.WriteRecords(myPersonObjects);
}

Dim configPersons = New CsvConfiguration(CultureInfo.InvariantCulture) With {.HasHeaderRecord = False}
Using stream = File.Open("filePersons.csv", FileMode.Append)
Using writer = New StreamWriter(stream)
Using csv = New CsvWriter(writer, configPersons)
	csv.WriteRecords(myPersonObjects)
End Using
End Using
End Using

Mevcut bir dosyaya ekleme yapmak zordur, ancak ekleme yaptığımızda sıralama değişebilir veya yeni özellikler eklenmiş olabilir. Eklemeler yaparken bunu göz önünde bulundurduğumuzdan emin olmalıyız.

Özet

IronXL, bir Excel dosyasını işlemek için gereken her şeyi sağlayan kapsamlı bir kütüphanedir. Kullanımı kolaydır ve çeşitli formatları XLSX'ye, ve XLSX'den diğer formatlara, örneğin CSV'ye dönüştürme olanağı sağlar. Dönüşüm, kullanıcıların diğer dosya formatlarını da kolayca işleyebilmesini sağlar.

Diğer taraftan, CSVWriter yalnızca CSV dosya formatlarıyla çalışır ve çok sınırlı seçeneklere sahiptir. Kullanıcılar farklı dosya formatları arasında geçiş yapamazken, IronXL ile yapabilirler. Tüm kod örnekleri CsvHelper dökümantasyon dosyalarında bulunabilir. Bu belge, projeinizde CSVWriter'ı nasıl kullanacağınıza dair yönergeler sağlar.

Sonuç

IronXL, birden fazla formatla çalışma desteği sunduğundan CsvHelper.CSVWriter'a göre açık bir avantaja sahiptir. Dahası, formülleri ve stilleri istediğiniz gibi uygulayabilirken, CsvHelper sadece CSV dosyalarını okumayı ve yazmayı sağlar ve sınırlı seçeneklerle. Ayrıca, mevcut bir CSV dosyasına yeni kayıtlar ekleyemezsiniz, çünkü sadece önceki girişlerin üzerine yazar.