Porównanie IronXL i CsvWriter

Zestaw funkcji IronXL

• Wczytuj, przeglądaj i edytuj dane — z plików XLS/XLSX/CSV/TSV
• Zapisywanie i eksportowanie — do formatów XLS/XLSX/CSV/TSV/JSON
• Zakresy — łatwa w użyciu składnia arkusza kalkulacyjnego ["A1:B10"]. Intuicyjnie łącz i twórz zakresy.
• Sortowanie — sortowanie zakresów, kolumn i wierszy.
• Stylizacja — style wizualne komórek, czcionka, rozmiar, wzór tła, obramowanie, wyrównanie i formaty liczb.

Funkcje CsvWriter

• Fast: compiles classes on the fly for extremely fast performance
• Flexible: conservative when writing, liberal when reading
• Easy to use: reading and writing are as simple as GetRecords<t>() and WriteRecords(records)
• Highly configurable
• Linux mode
• Low memory usage

2.1. Korzystanie z programu Visual Studio z pakietami NuGet

Visual Studio udostępnia menedżera pakietów NuGet do instalowania pakietów NuGet w projektach. Dostęp do niego można uzyskać poprzez menu Projekt lub klikając prawym przyciskiem myszy na projekt w Eksploratorze rozwiązań.

Select-Manage-NuGet-Package

• Now, from the browse tab -> search for IronXl.Excel -> Install

Search for IronXL

• And we are done.

2.2. Pobierz pakiet NuGet bezpośrednio

Można to zrobić, odwiedzając bezpośrednio stronę NuGet i pobierając pakiet. Kroki są następujące:

• Navigate tohttps://www.nuget.org/packages/IronXl.Excel
• Select "Download Package"
• Double-click the downloaded package
• The package will be installed
• Reload your Visual Studio project and begin using it

2.3. Ręczna instalacja za pomocą pliku DLL

Innym sposobem pobrania i zainstalowania biblioteki IronXL C# jest wykonanie poniższych kroków w celu zainstalowania pakietu IronXL NuGet za pomocą wiersza poleceń programisty.

• Otwórz wiersz poleceń programisty — zazwyczaj znajduje się on w folderze Visual Studio.
• Wpisz następujące polecenie:

  Install-Package IronXl.Excel

• Press Enter
• This will download and install the package
• Reload your Visual Studio project and begin using it

2.4. Dodaj niezbędne dyrektywy using

1. W Eksploratorze rozwiązań kliknij prawym przyciskiem myszy plik Program.cs, a następnie kliknij opcję Wyświetl kod.
2. Dodaj następujące dyrektywy using na początku pliku kodu:

using IronXL;

using IronXL;

Imports IronXL

Gotowe! IronXL jest pobrany, zainstalowany i gotowy do użycia. However, before that, we should install CsvHelper.

3.1. Using the NuGet Package Manager Console

Aby korzystać z CSVWriter, należy pobrać i zainstalować bibliotekę CsvHelper C#. Aby to zrobić, wykonaj poniższe kroki, aby zainstalować pakiet NuGet za pomocą wiersza poleceń programisty.

• Otwórz wiersz poleceń programisty — zazwyczaj znajduje się on w folderze Visual Studio.
• Wpisz następujące polecenie:

  Install-Package CsvHelper -Version 27.2.1

• Press Enter
• This will download and install the package
• Reload your Visual Studio project and begin using it
• Sprawdź szczegóły metody CsvHelper.CsvWriter w celu wdrożenia

3.2. Direct Download

Download from the NuGet website: https://www.nuget.org/packages/CsvHelper/

4.1. Converting a CSV File to Excel Format

Proces jest dość prosty i łatwy. Zazwyczaj wykonuje się to za pomocą jednej linii kodu.

Formaty CSV do Excel:

// 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. Read and Manipulate Converted CSV Files using IronXL

Klasa IronXLWorkBook reprezentuje arkusz programu Excel. Aby otworzyć plik Excel za pomocą języka C#, używamy metody WorkBook.Load i podajemy ścieżkę do pliku Excel (.xlsx). Poniższy jednowierszowy kod służy do otwarcia pliku w celu odczytu:

// 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")

Każdy obiekt WorkBook może zawierać wiele obiektów WorkSheet. Są to arkusze w dokumencie Excel. Jeśli skoroszyt zawiera arkusze, należy je pobrać według nazwy w następujący sposób:

// 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")

Kod do odczytu wartości komórek:

// 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

Po załadowaniu i przeczytaniu skoroszytu oraz arkusza można użyć poniższego przykładowego kodu, aby wprowadzić zmiany w formułach lub zastosować je do określonych komórek. Kod wygląda następująco:

// 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. Saving the Excel document back to CSV File

Writing CSV files is an easy process with IronXL. Poniższy kod po prostu zapisuje plik Excel w formacie CSV przy użyciu metody SaveAsCsv.

// 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. Utwórz prostą aplikację konsolową

Stwórz prostą aplikację konsolową CSVWriter z podanym separatorem, korzystając z Visual Studio. Po utworzeniu projektu następnym krokiem jest utworzenie klasy Person:

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

W metodzie Main stwórzmy teraz listę obiektów Person, którą zapiszemy do pliku CSV:

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. Zapisywanie do pliku CSV w języku C# przy użyciu ustawień domyślnych

CsvHelper stał się standardowym sposobem zapisywania plików CSV w języku C# przy użyciu metody CSVWriter i jest bardzo łatwy w użyciu:

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. Dodawanie danych

Musimy pamiętać, że za każdym razem, gdy uruchomimy nasz program, stare pliki CSV zostaną nadpisane. Czasami chcemy, aby dane zostały dołączone na końcu pliku, zamiast nadpisywać istniejące dane. CSVWriter nie udostępnia metody do tego celu, ponieważ otwieranie/zapisywanie pliku nie leży w zakresie odpowiedziąlności CSVWriter przy użyciu podanego separatora. Możemy to osiągnąć, używając obiektu FileStream, a następnie tworząc nasz StreamWriter przy użyciu tego obiektu FileStream. Chociaż nie wchodzi to w zakres niniejszego artykułu, pokażę, jak to zrobić, ponieważ jest to integralna część każdej aplikacji.

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

Dodawanie danych do istniejącego pliku jest jednak trudne, ponieważ podczas dodawania kolejność może ulec zmianie lub możemy dodać nowe właściwości. Należy o tym pamiętać podczas dodawania treści.

Summary

IronXL to kompletna biblioteka oferująca wszystko, czego potrzebujesz do manipulowania plikami Excel. Umożliwia konwersję różnych formatów do XLSX, a także z XLSX do innych formatów, takich jak CSV. Ta wzajemna konwersja zapewnia użytkownikom elastyczność w łatwym manipulowaniu innymi formatami plików.

Z drugiej strony, CSVWriter działa wyłącznie z formatami plików CSV i oferuje bardzo ograniczone opcje. Użytkownicy nie mogą przełączać się między różnymi formatami plików, podczas gdy w przypadku IronXL jest to możliwe. All the code samples can be found in the CsvHelper documentation files. Niniejszy dokument zawiera wytyczne dotyczące korzystania z CSVWriter w projekcie.

Wnioski

IronXL ma wyraźną przewagę nad CSVHelper.CSVWriter, ponieważ obsługuje wiele formatów. Ponadto można stosować formuły i style według własnego uznania, podczas gdy CsvHelper pozwala jedynie na odczyt i zapis plików CSV, przy czym opcje są ograniczone. Ponadto nie można dodawać nowych rekordów do istniejącego pliku CSV, ponieważ spowoduje to po prostu nadpisanie poprzednich wpisów.