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

IronXL Özellik Seti

• Yükleme, okuma ve düzenleme — XLS/XLSX/CSV/TSV formatlarında
• Kaydetme ve dışa aktarma — XLS/XLSX/CSV/TSV/JSON formatlarına
• Aralıklar — kulanımı kolay WorkSheet ["A1:B10"] biçimi. Aralıkları sezgisel olarak birleştir ve oluştur.
• Sıralama — aralıkları, sütunları ve satırları sıralayın.
• Stil — hücre görsel stilleri, yazı tipi, boyut, arka plan deseni, kenar, hizalama ve sayı formatları.

CsvWriter Özellikleri

• Hızlı: son derece hızlı performans için sınıfları derleme sırasında oluşturur.
• Esnek: yazarken dikkatli, okurken liberal.
• Kullanımı kolay: okuma ve yazma, GetRecords<t>() ve WriteRecords(records) kadar basit.
• Yüksek ayarlanabilir
• Linux modu
• Düşük bellek kullanımı

2.1. Visual Studio ile NuGet paketlerini Kullanarak

Visual Studio projelerinize NuGet paketlerini yüklemek için NuGet Paket Yöneticisi sağlar. Ona Proje Menüsünden veya Çözüm Gezgini'nde projenize sağ tıklayarak ulaşabilirsiniz.

Seç-Yönet-NuGet-Paketi

• Şimdi, tarama sekmesinden -> IronXl.Excel'i arayın -> Yükleyin.

IronXL'i arayın

• Ve işimiz bitti.

2.2. NuGet Paketini Bir Başına İndirin

Bu, NuGet sitesini direkt ziyaret ederek ve paketi indirerek yapılabilir. Adımlar:

• Navigate tohttps://www.nuget.org/packages/IronXl.Excel
• "Paket İndir" seçin.
• İndirilen pakete çift tıklayın.
• Paket yüklenecektir.
• Visual Studio projenizi yeniden yükleyin ve kullanmaya başlayın.

2.3. DLL ile Manuel Yükleme

IronXL C# Kütüphanesini indirmenin ve kurmanın bir başka yolu daIronXLNuGet paketini Geliştirici Komut İstemcisi aracılığıyla kurmak için aşağıdaki adımları kullanmaktır.

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

  Install-Package IronXl.Excel

• Enter tuşuna basın.
• Bu, paketi indirip yükleyecektir.
• Visual Studio projenizi yeniden yükleyin ve kullanmaya başlayın.

2.4. Gerekli Using Yönergelerini Ekleyin

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

using IronXL;

using IronXL;

Imports IronXL

Hepsi tamam! IronXL indirildi, yüklendi ve kullanıma hazır. Ancak, bundan önce CsvHelper'ı yüklemeliyiz.

3.1. NuGet Paket Yöneticisi Konsolu Kullanarak

CSVWriter ile çalışmak için CsvHelper C# Kütüphanesi'ni indirip yüklemeniz gerekir. Bunun için Geliştirici Komut İstemcisi aracılığıyla NuGet paketini kurmak için aşağıdaki adımları kullanın.

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

  Install-Package CsvHelper -Version 27.2.1

• Enter tuşuna basın.
• Bu, paketi indirip yükleyecektir.
• Visual Studio projenizi yeniden yükleyin ve kullanmaya başlayın.
• CsvHelper.CsvWriter yöntemi detayını uygulama için kontrol edin

3.2. Doğrudan İndirme

Download from the NuGet website: 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 kodla 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. IronXL kullanarak Dönüştürülmüş CSV Dosyalarını Okuma ve Manipülasyon

IronXLWorkBook sınıfı bir Excel sayfasını temsil eder. C# kullanarak bir Excel Dosyası açmak için, WorkBook.Load'u kullanırız ve Excel dosyasının (.xlsx) yolunu belirtiriz. Dosyayı okumak için açmak için kullanılan tek satırlık kod:

// 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çerdiğinde, bunları aşağıdaki gibi adlarıyla 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ükleyip okuduktan sonra, formüllerde değişiklik yapmak veya belirli hücrelere formüller uygulamak için aşağıdaki kod örneği kullanılabilir. Kod şu şekildedir:

// 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 CSV Dosyasına geri kaydetme

CSV dosyalarını yazmak IronXL ile kolay bir süreçtir. Aşağıdaki kod, SaveAsCsv yöntemini kullanarak Excel dosyasını basitçe 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ştur

Visual Studio kullanarak verilen ayraçlı basit bir CSVWriter konsol uygulaması oluşturun. Proje oluşturulduktan sonra sıradaki adım bir Kişi sınıfı oluşturmak:

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öntemde, şimdi bir Kişi nesne listesi oluşturalım, 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. C#'ta Varsayılan Ayarlarla CSV Dosyasına Yazma

CsvHelper, CSVWriter yöntemini kullanarak C# içinde CSV yazmanın standart yolu olarak ortaya çıktı ve kullanımı çok 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ğı gerçeğini aklımızda tutmamız gerekiyor. Bazen verilerin mevcut verilerin üzerine yazılmak yerine bir dosyanın sonuna eklenmesini isteriz. CSVWriter, verilen ayraç ile bu işlemi gerçekleştirmek için bir yöntem sunmaz, çünkü bir dosyanın açılması/yazılması CSVWriter'ın sorumluluğu değildir. Bunu bir FileStream kullanarak ve ardından o FileStream'i kullanarak StreamWriter'ımızı oluşturarak gerçekleştirebiliriz. Bu makalenin kapsamına girmiyor olsa da size bunu nasıl yapacağınızı göstereceğim, çünkü bu herhangi bir uygulamanın ayrılmaz bir parçasıdır.

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 veri eklemek zordur çünkü veri eklediğimizde sıralama değişebilir veya yeni özellikler eklemiş olabiliriz. Ek yaparken bunu hesaba katmamız gerektiğinden mutlaka emin olmalıyız.

Özet

IronXL, bir Excel dosyasını manipüle etmek için gereken her şeyi sunan eksiksiz bir kütüphanedir. Çeşitli formatların XLSX'e, ve aynı şekilde XLSX'den diğer formatlara, örneğin CSV'ye dönüştürülmesine olanak tanır. Bu dönüşüm, kullanıcılara diğer dosya formatlarını kolaylıkla manipüle etme esnekliği sağlar.

Öte yandan, CSVWriter sadece CSV dosya formatlarıyla çalışır ve çok sınırlı seçenekler sunar. Kullanıcılar farklı dosya formatları arasında geçiş yapamazken, IronXL ile geçiş yapabilirler. Tüm kod örnekleri CsvHelper dokümantasyon dosyalarında bulunabilir. Bu belge, projenizde CSVWriter nasıl kullanılır konusunda yönergeler sağlar.

Sonuç

IronXL, birden fazla formatla çalışmayı desteklediği için CSVHelper.CSVWriter karşısında açık bir avantaja sahiptir. Ayrıca, formülleri ve stilleri seçiminize göre uygulayabilirsiniz, .CSVHelper ise yalnızca CSV dosyalarını okumaya ve yazmaya izin verir ve sınırlı seçenekle. Dahası, mevcut bir CSV dosyasına yeni kayıtlar ekleyemezsiniz, çünkü o sadece önceki girişlerin üzerine yazar.