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

• Szybkie: kompiluje klasy na żywo dla niezwykle szybkiej wydajności
• Elastyczna: konserwatywna przy pisaniu, liberalna przy czytaniu
• Łatwy w użyciu: odczyt i zapis są tak proste jak GetRecords<t>() i WriteRecords(records)
• Wysoce konfigurowalna
• Tryb Linux
• Niskie zużycie pamięci

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ń.

Wybierz-Zarządzaj-Pakietem-NuGet

• Teraz z karty przeglądaj -> wyszukaj IronXL.Excel -> Zainstaluj

Wyszukaj IronXL

• I gotowe.

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 to https://www.nuget.org/packages/IronXL.Excel
• Wybierz "Pobierz pakiet"
• Kliknij dwukrotnie pobrany pakiet
• Pakiet zostanie zainstalowany
• Ponownie załaduj swój projekt Visual Studio i zacznij z niego korzystać

2.3. Ręczna instalacja za pomocą pliku DLL

Innym sposobem na pobranie i zainstalowanie biblioteki IronXL C# jest wykonanie ponizszych krokow w celu zainstalowania pakietu IronXLNuGet przez Developer Command Prompt.

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

  Install-Package IronXL.Excel

• Naciśnij Enter
• To pobierze i zainstaluje pakiet
• Ponownie załaduj swój projekt Visual Studio i zacznij z niego korzystać

2.4. Dodaj niezbędne dyrektywy using

1. W oknie Solution Explorer kliknij prawym przyciskiem myszy plik Program.cs, a następnie wybierz opcję View Code.
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. Jednak zanim to zrobimy, powinniśmy zainstalować CsvHelper.

3.1. Korzystanie z konsoli menedżera pakietów NuGet

Aby korzystać z CSVWriter, należy pobrać i zainstalować bibliotekę CsvHelper C#. Aby to zrobic, wykonaj ponizsze kroki w celu zainstalowania pakietu NuGet przez Developer Command Prompt.

• 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

• Naciśnij Enter
• To pobierze i zainstaluje pakiet
• Ponownie załaduj swój projekt Visual Studio i zacznij z niego korzystać
• Sprawdź szczegóły metody CsvHelper.CsvWriter w celu wdrożenia

3.2. Pobieranie bezpośrednie

Pobierz ze strony NuGet: https://www.nuget.org/packages/CsvHelper/

4.1. Konwertowanie pliku CSV na format Excel

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. Odczyt i manipulacja przekonwertowanymi plikami CSV przy użyciu IronXL

Klasa IronXL WorkBook 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")

Kazdy WorkBook moze zawierac wiele obiektow 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. Zapisanie dokumentu Excel z powrotem do pliku CSV

Pisanie plików CSV jest łatwym procesem przy użyciu 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. Pisanie do pliku CSV w C# z ustawieniami domyslnymi

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 odpowiedzialnoś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.

Podsumowanie

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. Wsystkie przykladowe kody sa dostepne w dokumentacji CsvHelper. 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.