Praca z plikami CSV może być trudnym zadaniem. Obecnie dostępnych jest wiele bibliotek, które pomagają programistom w tym zadaniu bez konieczności instalowania programu Microsoft Excel.
W tym artykułe omówimy i porównamy sposoby programowej pracy z dokumentami Microsoft Excel w środowisku C# .NET Technologies, zarówno w formacie CSV, jak i standardowym formacie XLSX, przy użyciu dwóch najpopularniejszych bibliotek: IronXL i CsvHelper.
Przyjrzyjmy się najpierw temu, co mają do zaoferowania obie biblioteki.
Biblioteka IronXL .NET ułatwia odczyt i edycję dokumentów Microsoft Excel za pomocą języka C#. IronXL.Excel to samodzielna biblioteka oprogramowania .NET służąca do odczytu szerokiej gamy formatów arkuszy kalkulacyjnych. Nie wymaga instalacji programu Microsoft Excel ani nie jest zależne od Interop. Bardzo sprawnie współpracuje z plikami CSV.
IronXL to intuicyjny interfejs API języka C#, który umożliwia odczytywanie, edytowanie i tworzenie plików arkuszy kalkulacyjnych Excel w środowisku .NET z błyskawiczną wydajnością. IronXL w pełni obsługuje .NET Core, .NET Framework, Xamarin, urządzenia mobilne, systemy Linux, macOS oraz platformę Azure.
IronXL to wiodąca biblioteka arkuszy kalkulacyjnych Excel dla C# oparta na platformach .NET Core i .NET Framework.
WorkSheet["A1:B10"]. Intuicyjnie łącz i twórz zakresy.Biblioteka .NET do odczytu i zapisu plików CSV. Niezwykle szybkie, elastyczne i łatwe w użyciu. Obsługuje odczyt i zapis obiektów klas niestandardowych. Wszystkie przykładowe kody są dostępne w dokumentacji pakietu CsvHelper.
CsvConfiguration do ustawienia konfiguracji dla CSVStreamReaderCsvReader class to readDefaultTypeConverterGetRecords<t>() i WriteRecords(records)Aby utworzyć aplikację konsolową, wykonaj następujące kroki:
Utwórz projekt - Aplikacja konsolowa
Utwórz projekt - .NET Framework
Projekt jest teraz utworzony i jesteśmy prawie gotowi do przetestowania bibliotek. Jednak nadal musimy je zainstalować i zintegrować z naszym projektem. Najpierw zainstalujmy IronXL.
Bibliotekę IronXL można pobrać i zainstalować, korzystając z następujących metod:
Przyjrzyjmy się bliżej każdemu z nich.
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
Wyszukaj IronXL
Można to zrobić, odwiedzając bezpośrednio stronę NuGet i pobierając pakiet. Kroki są następujące:
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.
PM> Install-Package IronXL.Excelusing IronXL;Imports IronXLImports IronXLGotowe! IronXL jest pobrany, zainstalowany i gotowy do użycia. Jednak zanim to zrobimy, powinniśmy zainstalować CsvHelper.
Aby pobrać i zainstalować bibliotekę CsvHelper w C#, skorzystaj z poniższych kroków, aby zainstalować pakiet NuGet przez wiersz polecenia dla deweloperów.
PM> Install-Package CsvHelper -Version 27.2.1Pobierz z witryny NuGet: https://www.nuget.org/packages/CsvHelper.
Wartości rozdzielane przecinkami (CSV) to plik tekstowy z ogranicznikami, który używa przecinka do oddzielania wartości. Każda linia pliku to rekord danych. Manipulowanie tymi plikami w celu obliczeń może być trudnym zadaniem, a IronXL dostarcza całkiem dobrą i łatwą opcję, aby to zrobić bez Microsoft Excel. Najpierw przekształćmy plik CSV na zwykły plik 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 convert it to an Excel format
WorkBook workbook = WorkBook.LoadCSV("test.csv", fileFormat: ExcelFileFormat.XLSX, ListDelimiter: ",");
// Access the default worksheet
WorkSheet ws = workbook.DefaultWorkSheet;
// Save the workbook as an Excel file
workbook.SaveAs("CsvToExcelConversion.xlsx");// Load the CSV file and convert it to an Excel format
WorkBook workbook = WorkBook.LoadCSV("test.csv", fileFormat: ExcelFileFormat.XLSX, ListDelimiter: ",");
// Access the default worksheet
WorkSheet ws = workbook.DefaultWorkSheet;
// Save the workbook as an Excel file
workbook.SaveAs("CsvToExcelConversion.xlsx");' Load the CSV file and convert it to an Excel format
Dim workbook As WorkBook = WorkBook.LoadCSV("test.csv", fileFormat:= ExcelFileFormat.XLSX, ListDelimiter:= ",")
' Access the default worksheet
Dim ws As WorkSheet = workbook.DefaultWorkSheet
' Save the workbook as an Excel file
workbook.SaveAs("CsvToExcelConversion.xlsx")' Load the CSV file and convert it to an Excel format
Dim workbook As WorkBook = WorkBook.LoadCSV("test.csv", fileFormat:= ExcelFileFormat.XLSX, ListDelimiter:= ",")
' Access the default worksheet
Dim ws As WorkSheet = workbook.DefaultWorkSheet
' Save the workbook as an Excel file
workbook.SaveAs("CsvToExcelConversion.xlsx")Klasa IronXL WorkBook reprezentuje arkusz Excel. Aby otworzyć plik Excel za pomocą C#, używamy WorkBook.Load i określamy ś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")' Load WorkBook
Dim workbook = WorkBook.Load("Spreadsheets/sample.xlsx")Każdy 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 the sheet for reading
var worksheet = workbook.GetWorkSheet("sheetnamegoeshere");// Open the sheet for reading
var worksheet = workbook.GetWorkSheet("sheetnamegoeshere");' Open the sheet for reading
Dim worksheet = workbook.GetWorkSheet("sheetnamegoeshere")' Open the 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' 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 cellPo załadowaniu i odczytaniu skoroszytu i arkusza kalkulacyjnego, poniższy przykład kodu może być wykorzystany do wprowadzenia zmian w formułach lub ich zastosowaniu w konkretnych komórkach. Kod wygląda następująco:
// Set formulas in specific cells
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 in specific cells
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 in specific cells
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 in specific cells
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()Pisanie plików CSV jest łatwym procesem przy użyciu IronXL. Poniższy kod po prostu zapisuje plik Excel w formacie CSV za pomocą metody SaveAsCsv.
// Load the Excel Workbook
WorkBook wb = WorkBook.Load("Normal_Excel_File.xlsx");
// Save the workbook as a CSV file
wb.SaveAsCsv("SaveAsCSV.csv", ",");
// This will save as "SaveAsCSV.Sheet1.csv"// Load the Excel Workbook
WorkBook wb = WorkBook.Load("Normal_Excel_File.xlsx");
// Save the workbook as a CSV file
wb.SaveAsCsv("SaveAsCSV.csv", ",");
// This will save as "SaveAsCSV.Sheet1.csv"' Load the Excel Workbook
Dim wb As WorkBook = WorkBook.Load("Normal_Excel_File.xlsx")
' Save the workbook as a CSV file
wb.SaveAsCsv("SaveAsCSV.csv", ",")
' This will save as "SaveAsCSV.Sheet1.csv"' Load the Excel Workbook
Dim wb As WorkBook = WorkBook.Load("Normal_Excel_File.xlsx")
' Save the workbook as a CSV file
wb.SaveAsCsv("SaveAsCSV.csv", ",")
' This will save as "SaveAsCSV.Sheet1.csv"Odczytywanie plików CSV to jedno z tych zadań, które wydają się znacznie łatwiejsze, niż są w rzeczywistości. Biblioteka CsvHelper umożliwia łatwe pisanie kodu, który jest bezpieczny typowo, szybki i elastyczny.
To przykład pliku CSV, ma trzy kolumny tekstowe i jedną kolumnę liczbową.
FirstName,LastName,Age,IsActive
Ali,Talal,30,Yes
Affan,Ahmad,31,No
Saad,Bhatti,31,YesZmapujemy każdy wiersz na obiekt typu Person.
// Define the Person class to map CSV records
public class Person
{
public string FirstName { get; set; }
public string LastName { get; set; }
public int? Age { get; set; }
public string IsActive { get; set; }
}// Define the Person class to map CSV records
public class Person
{
public string FirstName { get; set; }
public string LastName { get; set; }
public int? Age { get; set; }
public string IsActive { get; set; }
}' Define the Person class to map CSV records
Public Class Person
Public Property FirstName() As String
Public Property LastName() As String
Public Property Age() As Integer?
Public Property IsActive() As String
End Class' Define the Person class to map CSV records
Public Class Person
Public Property FirstName() As String
Public Property LastName() As String
Public Property Age() As Integer?
Public Property IsActive() As String
End ClassKod do odczytu naszego pliku CSV znajduje się poniżej.
// Define the path to the CSV file
var fileName = @"<path to our CSV file>";
// Configure CsvHelper
var configuration = new CsvConfiguration(CultureInfo.InvariantCulture)
{
Encoding = Encoding.UTF8,
Delimiter = ","
};
// Read CSV file
using (var fs = File.Open(fileName, FileMode.Open, FileAccess.Read, FileShare.Read))
{
using (var textReader = new StreamReader(fs, Encoding.UTF8))
using (var csv = new CsvReader(textReader, configuration))
{
var data = csv.GetRecords<Person>();
// Iterate over each person record
foreach (var person in data)
{
// Process each Person object
}
}
}// Define the path to the CSV file
var fileName = @"<path to our CSV file>";
// Configure CsvHelper
var configuration = new CsvConfiguration(CultureInfo.InvariantCulture)
{
Encoding = Encoding.UTF8,
Delimiter = ","
};
// Read CSV file
using (var fs = File.Open(fileName, FileMode.Open, FileAccess.Read, FileShare.Read))
{
using (var textReader = new StreamReader(fs, Encoding.UTF8))
using (var csv = new CsvReader(textReader, configuration))
{
var data = csv.GetRecords<Person>();
// Iterate over each person record
foreach (var person in data)
{
// Process each Person object
}
}
}' Define the path to the CSV file
Dim fileName As String = "<path to our CSV file>"
' Configure CsvHelper
Dim configuration As New CsvConfiguration(CultureInfo.InvariantCulture) With {
.Encoding = Encoding.UTF8,
.Delimiter = ","
}
' Read CSV file
Using fs As FileStream = File.Open(fileName, FileMode.Open, FileAccess.Read, FileShare.Read)
Using textReader As New StreamReader(fs, Encoding.UTF8)
Using csv As New CsvReader(textReader, configuration)
Dim data = csv.GetRecords(Of Person)()
' Iterate over each person record
For Each person In data
' Process each Person object
Next
End Using
End Using
End Using' Define the path to the CSV file
Dim fileName As String = "<path to our CSV file>"
' Configure CsvHelper
Dim configuration As New CsvConfiguration(CultureInfo.InvariantCulture) With {
.Encoding = Encoding.UTF8,
.Delimiter = ","
}
' Read CSV file
Using fs As FileStream = File.Open(fileName, FileMode.Open, FileAccess.Read, FileShare.Read)
Using textReader As New StreamReader(fs, Encoding.UTF8)
Using csv As New CsvReader(textReader, configuration)
Dim data = csv.GetRecords(Of Person)()
' Iterate over each person record
For Each person In data
' Process each Person object
Next
End Using
End Using
End UsingTyp data to IEnumerable<Person>. CsvHelper automatycznie zmapuje każdą kolumnę do właściwości o tej samej nazwie. Na przykład wartość w kolumnie FirstName zostanie zmapowana na Person.FirstName. Następnie możemy iterować data i uzyskać dostęp do wartości w każdym wierszu.
Pliki CSV głównie zawierają dane tekstowe. Na przykład kolumna wieku jest wartością liczbową, a plik CSV zawiera tylko tekst. CsvHelper może konwertować dane z łańcucha znaków na standardowe typy .NET (Boolean, Int32, Int64, Enum). W naszym przypadku mamy typ danych IsActive bool, który może mieć tylko True/False i zawiera niestandardowe wartości. Można go przekształcić, tworząc niestandardowy konwerter. Stylizacja kodu przebiega w nastepujacy sposob:
// Custom Boolean Converter for CsvHelper
public class CustomBooleanConverter : DefaultTypeConverter
{
public override object ConvertFromString(string text, IReaderRow row, MemberMapData memberMapData)
{
// Convert "Yes" to true and anything else to false
return text.Equals("Yes", StringComparison.OrdinalIgnoreCase);
}
}// Custom Boolean Converter for CsvHelper
public class CustomBooleanConverter : DefaultTypeConverter
{
public override object ConvertFromString(string text, IReaderRow row, MemberMapData memberMapData)
{
// Convert "Yes" to true and anything else to false
return text.Equals("Yes", StringComparison.OrdinalIgnoreCase);
}
}' Custom Boolean Converter for CsvHelper
Public Class CustomBooleanConverter
Inherits DefaultTypeConverter
Public Overrides Function ConvertFromString(ByVal text As String, ByVal row As IReaderRow, ByVal memberMapData As MemberMapData) As Object
' Convert "Yes" to true and anything else to false
Return text.Equals("Yes", StringComparison.OrdinalIgnoreCase)
End Function
End Class' Custom Boolean Converter for CsvHelper
Public Class CustomBooleanConverter
Inherits DefaultTypeConverter
Public Overrides Function ConvertFromString(ByVal text As String, ByVal row As IReaderRow, ByVal memberMapData As MemberMapData) As Object
' Convert "Yes" to true and anything else to false
Return text.Equals("Yes", StringComparison.OrdinalIgnoreCase)
End Function
End ClassMimo że bool jest standardowym typem .NET, domyślny konwerter obsługuje tylko wartość True/False, podczas gdy nasz plik CSV ma Yes/No. Tutaj musimy podklasować DefaultTypeConverter, a następnie nadpisać metodę ConvertFromString.
IronXL to komercyjna biblioteka Excel w C#. Jest bezpłatny do celów programistycznych i zawsze można uzyskać licencję na wdrożenie komercyjne. Licencje sa dostepne do uzytku w pojedynczym projekcie, dla jednego dewelopera, agencji oraz globalnych korporacji, a takze na potrzeby SaaS i redystrybucji OEM. Wszystkie licencje obejmują 30-dniową gwarancję zwrotu pieniędzy, roczną pomoc techniczną i aktualizacje, ważność na środowiska deweloperskie, testowe i produkcyjne, a także licencję stałą (jednorazowy zakup). Pakiet Lite zaczyna się od $999.
CsvHelper - odczyt i zapis plikow CSV sa calkowicie darmowe do uzytku komercyjnego.
IronXL to kompletna biblioteka oferujaca wszystko, co potrzebne do manipulacji plikiem Excel. Jest latwa w uzyciu i umozliwia konwersje roznych formatow do XLSX oraz z XLSX do innych formatow, takich jak CSV. Ta mozliwosc konwersji zapewnia uzytkownikowi elastycznosc pracy z roznymi formatami plikow.
Z kolei CsvHelper jest zaprojektowany specyficznie do pracy z formatem plikow CSV, co oznacza, ze potrafi obsluzyc tylko pliki CSV. Wsystkie przykladowe kody sa dostepne w dokumentacji CsvHelper. Dokumentacja oferuje wskazowki, jak korzystac z CsvHelper w swoim projekcie.
IronXL ma wyrazna przewage nad CsvHelper, poniewaz wspiera prace z wieloma formatami. Ponadto mozna stosowac formuly i style wedlug wlasnych potrzeb, podczas gdy CsvHelper umozliwia tylko odczyt i zapis plikow CSV z ograniczonymi opcjami. Nie mozna rowniez dopisac nowych rekordow do istniejacego pliku CSV, poniewaz jedynie nadpisuje wczesniejsze wpisy.
Curtis Chau posiada tytuł licencjata z informatyki (Uniwersytet Carleton) i specjalizuje się w front-endowym rozwoju, z ekspertką w Node.js, TypeScript, JavaScript i React. Pasjonuje się tworzeniem intuicyjnych i estetycznie przyjemnych interfejsów użytkownika, Curtis cieszy się pracą z nowoczesnymi frameworkami i tworzeniem dobrze zorganizowanych, atrakcyjnych wizualnie podręczników.
IronXL jest częścią IRONSUITE
10 produktów API .NET dla twoich dokumentów biurowych
API Excel, którego potrzebujesz, bez trudności z Office Interop.
