C# Biblioteka CSV: Pełen samouczek używający IronXL

Jak skonfigurować bibliotekę arkuszy kalkulacyjnych w języku C#?

Instalacja IronXL zajmuje mniej niż minutę za pośrednictwem NuGet. Otwórz konsolę menedżera pakietów w Visual Studio i uruchom poniższe polecenie lub użyj interfejsu CLI .NET z dowolnego terminala:

Install-Package IronXL
dotnet add package IronXL

Install-Package IronXL
dotnet add package IronXL

Po zainstalowaniu pakietu dodaj przestrzeń nazw do dowolnego pliku, w którym chcesz pracować z danymi arkusza kalkulacyjnego:

using IronXL;

using IronXL;

Imports IronXL

IronXL jest przeznaczony dla .NET Framework 4.6.2+ oraz wszystkich nowoczesnych wersji .NET (Core, 5, 6, 7, 8, 9 i 10). Działa na systemach Windows, Linux i macOS, dzięki czemu nadaje się zarówno do narzędzi desktopowych, jak i do kontenerowych obciążeń serwerowych. Zapoznaj się z instrukcją instalacji IronXL, aby uzyskać szczegółowe wskazówki dotyczące źródeł pakietów i aktywacji licencji.

Jak odczytywać pliki CSV w języku C#?

Odczytywanie pliku CSV za pomocą IronXL przebiega tak samo, jak w przypadku ładowania dowolnego arkusza kalkulacyjnego. Wywołaj WorkBook.Load z ścieżką do pliku, a IronXL wywnioskuje format na podstawie rozszerzenia — nie jest wymagańa żadna dodatkowa konfiguracja:

// Load a CSV file into a WorkBook
WorkBook workBook = WorkBook.Load("sales_data.csv");

// Access the default worksheet
WorkSheet workSheet = workBook.DefaultWorkSheet;

// Read individual cells by Excel-style address
string customerName = workSheet["A2"].StringValue;
decimal orderAmount = workSheet["B2"].DecimalValue;

// Iterate rows, starting at index 1 to skip the header
for (int i = 1; i < workSheet.Rows.Count(); i++)
{
    var row = workSheet.Rows[i];
    Console.WriteLine($"Customer: {row.Columns[0].Value}, Amount: {row.Columns[1].Value}");
}

// Load a CSV file into a WorkBook
WorkBook workBook = WorkBook.Load("sales_data.csv");

// Access the default worksheet
WorkSheet workSheet = workBook.DefaultWorkSheet;

// Read individual cells by Excel-style address
string customerName = workSheet["A2"].StringValue;
decimal orderAmount = workSheet["B2"].DecimalValue;

// Iterate rows, starting at index 1 to skip the header
for (int i = 1; i < workSheet.Rows.Count(); i++)
{
    var row = workSheet.Rows[i];
    Console.WriteLine($"Customer: {row.Columns[0].Value}, Amount: {row.Columns[1].Value}");
}

Imports System

' Load a CSV file into a WorkBook
Dim workBook As WorkBook = WorkBook.Load("sales_data.csv")

' Access the default worksheet
Dim workSheet As WorkSheet = workBook.DefaultWorkSheet

' Read individual cells by Excel-style address
Dim customerName As String = workSheet("A2").StringValue
Dim orderAmount As Decimal = workSheet("B2").DecimalValue

' Iterate rows, starting at index 1 to skip the header
For i As Integer = 1 To workSheet.Rows.Count() - 1
    Dim row = workSheet.Rows(i)
    Console.WriteLine($"Customer: {row.Columns(0).Value}, Amount: {row.Columns(1).Value}")
Next

Obiekt WorkBook udostępnia pełny model arkusza kalkulacyjnego. Dostęp do komórek uzyskuje się za pomocą znanych notacji programu Excel, takich jak "A2", oraz wbudowanych właściwości konwersji -- StringValue, DecimalValue, IntValue, DateTimeValue -- obsługują wymuszanie typu, dzięki czemu nie trzeba ręcznie analizować ciągów znaków.

// Access a range and print each value
foreach (var cell in workSheet["A2:C10"])
{
    Console.WriteLine($"{cell.AddressString}: {cell.Value}");
}

// Access a range and print each value
foreach (var cell in workSheet["A2:C10"])
{
    Console.WriteLine($"{cell.AddressString}: {cell.Value}");
}

' Access a range and print each value
For Each cell In workSheet("A2:C10")
    Console.WriteLine($"{cell.AddressString}: {cell.Value}")
Next

public record SalesRecord(string Customer, decimal Amount, DateTime OrderDate);

WorkBook workBook = WorkBook.Load("sales_data.csv");
WorkSheet workSheet = workBook.DefaultWorkSheet;

var records = new List<SalesRecord>();

// Start at row 1 to skip the header row (row 0)
for (int i = 1; i < workSheet.Rows.Count(); i++)
{
    var row = workSheet.Rows[i];
    records.Add(new SalesRecord(
        Customer: row.Columns[0].StringValue,
        Amount: row.Columns[1].DecimalValue,
        OrderDate: row.Columns[2].DateTimeValue
    ));
}

public record SalesRecord(string Customer, decimal Amount, DateTime OrderDate);

WorkBook workBook = WorkBook.Load("sales_data.csv");
WorkSheet workSheet = workBook.DefaultWorkSheet;

var records = new List<SalesRecord>();

// Start at row 1 to skip the header row (row 0)
for (int i = 1; i < workSheet.Rows.Count(); i++)
{
    var row = workSheet.Rows[i];
    records.Add(new SalesRecord(
        Customer: row.Columns[0].StringValue,
        Amount: row.Columns[1].DecimalValue,
        OrderDate: row.Columns[2].DateTimeValue
    ));
}

Imports System
Imports System.Collections.Generic

Public Class SalesRecord
    Public Property Customer As String
    Public Property Amount As Decimal
    Public Property OrderDate As DateTime

    Public Sub New(customer As String, amount As Decimal, orderDate As DateTime)
        Me.Customer = customer
        Me.Amount = amount
        Me.OrderDate = orderDate
    End Sub
End Class

Dim workBook As WorkBook = WorkBook.Load("sales_data.csv")
Dim workSheet As WorkSheet = workBook.DefaultWorkSheet

Dim records As New List(Of SalesRecord)()

' Start at row 1 to skip the header row (row 0)
For i As Integer = 1 To workSheet.Rows.Count() - 1
    Dim row = workSheet.Rows(i)
    records.Add(New SalesRecord(
        Customer:=row.Columns(0).StringValue,
        Amount:=row.Columns(1).DecimalValue,
        OrderDate:=row.Columns(2).DateTimeValue
    ))
Next

Jak zapisywać pliki CSV w języku C#?

Tworzenie pliku CSV od podstaw obejmuje trzy kroki: utworzenie WorkBook, wypełnienie WorkSheet oraz wywołanie SaveAsCsv. Proces ten przypomina tworzenie arkusza kalkulacyjnego, co zapewnia spójność API niezależnie od formatu wyjściowego:

// Create a new workbook and worksheet
WorkBook workBook = WorkBook.Create();
WorkSheet workSheet = workBook.CreateWorkSheet("inventory");

// Write header row
workSheet["A1"].Value = "Product";
workSheet["B1"].Value = "Quantity";
workSheet["C1"].Value = "Price";

// Write data rows
workSheet["A2"].Value = "Widget A";
workSheet["B2"].Value = 250;
workSheet["C2"].Value = 9.99;

workSheet["A3"].Value = "Gadget B";
workSheet["B3"].Value = 120;
workSheet["C3"].Value = 24.50;

// Export to CSV
workBook.SaveAsCsv("inventory.csv");

// Create a new workbook and worksheet
WorkBook workBook = WorkBook.Create();
WorkSheet workSheet = workBook.CreateWorkSheet("inventory");

// Write header row
workSheet["A1"].Value = "Product";
workSheet["B1"].Value = "Quantity";
workSheet["C1"].Value = "Price";

// Write data rows
workSheet["A2"].Value = "Widget A";
workSheet["B2"].Value = 250;
workSheet["C2"].Value = 9.99;

workSheet["A3"].Value = "Gadget B";
workSheet["B3"].Value = 120;
workSheet["C3"].Value = 24.50;

// Export to CSV
workBook.SaveAsCsv("inventory.csv");

' Create a new workbook and worksheet
Dim workBook As WorkBook = WorkBook.Create()
Dim workSheet As WorkSheet = workBook.CreateWorkSheet("inventory")

' Write header row
workSheet("A1").Value = "Product"
workSheet("B1").Value = "Quantity"
workSheet("C1").Value = "Price"

' Write data rows
workSheet("A2").Value = "Widget A"
workSheet("B2").Value = 250
workSheet("C2").Value = 9.99D

workSheet("A3").Value = "Gadget B"
workSheet("B3").Value = 120
workSheet("C3").Value = 24.5D

' Export to CSV
workBook.SaveAsCsv("inventory.csv")

SaveAsCsv obsługuje rozmieszczenie separatorów, cytowanie pól zawierających przecinki oraz normalizację znaków nowej linii. Nie musisz tym zajmować się ręcznie. IronXL zachowuje typy liczbowe podczas eksportu, dzięki czemu narzędzia takie jak Excel lub pandas odczytują liczby jako liczby, a nie jako ciągi tekstowe w cudzysłowie.

DataTable dataTable = GetProductsFromDatabase();

WorkBook workBook = WorkBook.Create();
WorkSheet workSheet = workBook.CreateWorkSheet("products");

workSheet.InsertDataTable(dataTable, "A1");

workBook.SaveAsCsv("products.csv");

DataTable dataTable = GetProductsFromDatabase();

WorkBook workBook = WorkBook.Create();
WorkSheet workSheet = workBook.CreateWorkSheet("products");

workSheet.InsertDataTable(dataTable, "A1");

workBook.SaveAsCsv("products.csv");

IRON VB CONVERTER ERROR developers@ironsoftware.com

Jak konwertować pliki CSV na Excel i odwrotnie w języku C#?

Jedną z najcenniejszych funkcji oferowanych przez IronXL jest dwukierunkowa konwersja między formatami CSV i Excel. API jest symetryczne — Load odczytuje każdy obsługiwany format, a rodzina metod Save zapisuje dane w formacie docelowym:

// Convert CSV to Excel
WorkBook csvWorkBook = WorkBook.Load("data.csv");
csvWorkBook.SaveAs("data.xlsx");

// Convert Excel back to CSV
WorkBook xlsxWorkBook = WorkBook.Load("report.xlsx");
xlsxWorkBook.SaveAsCsv("report.csv");

// Convert CSV to Excel
WorkBook csvWorkBook = WorkBook.Load("data.csv");
csvWorkBook.SaveAs("data.xlsx");

// Convert Excel back to CSV
WorkBook xlsxWorkBook = WorkBook.Load("report.xlsx");
xlsxWorkBook.SaveAsCsv("report.csv");

' Convert CSV to Excel
Dim csvWorkBook As WorkBook = WorkBook.Load("data.csv")
csvWorkBook.SaveAs("data.xlsx")

' Convert Excel back to CSV
Dim xlsxWorkBook As WorkBook = WorkBook.Load("report.xlsx")
xlsxWorkBook.SaveAsCsv("report.csv")

Te konwersje zachowują integralność danych. Wartości liczbowe pozostają liczbami, pola daty zachowują swój typ, a wyniki formuł są obliczane na wartości obliczone przed zapisaniem. Podczas konwersji wielarkuszowego pliku Excel do formatu CSV, IronXL automatycznie tworzy osobny plik CSV dla każdego arkusza:

WorkBook multiSheetWorkBook = WorkBook.Load("quarterly_report.xlsx");

// Produces: quarterly_report.Sheet1.csv, quarterly_report.Sheet2.csv, etc.
multiSheetWorkBook.SaveAsCsv("quarterly_report.csv");

WorkBook multiSheetWorkBook = WorkBook.Load("quarterly_report.xlsx");

// Produces: quarterly_report.Sheet1.csv, quarterly_report.Sheet2.csv, etc.
multiSheetWorkBook.SaveAsCsv("quarterly_report.csv");

Dim multiSheetWorkBook As WorkBook = WorkBook.Load("quarterly_report.xlsx")

' Produces: quarterly_report.Sheet1.csv, quarterly_report.Sheet2.csv, etc.
multiSheetWorkBook.SaveAsCsv("quarterly_report.csv")

Takie zachowanie jest szczególnie przydatne w przypadku potoków raportowania, w których odbiorcy na dalszym etapie oczekują jednego tematu na plik. Samouczek dotyczący zapisu do pliku CSV obejmuje dodatkowe opcje, takie jak określanie znaku separatora oraz kontrolowanie, które arkusze są uwzględniane w eksporcie.

!{--01001100010010010100001001010010010000010101001001011001010111110100011101000101010101000101111101010011010101000100000101010010010101000100010101000100010111110101011101001001010100010010000101111101010000010100100100111101000100010101010100001101010100010111110101010001010010010010010100000101001100010111110100001001001100010011110100001101001011--}

Dłączego biblioteki obsługujące wyłącznie format CSV nie sprawdzają się w rzeczywistych projektach?

Wielu programistów C# zaczyna od CsvHelper lub TextFieldParser z Microsoft.VisualBasic. Oba są wydajnymi narzędziami do obsługi procesów opartych wyłącznie na plikach CSV. Luka pojawia się, gdy wymagania się rozszerzają: interesariusz prosi o plik do pobrania w formacie Excel zamiast CSV, dział finansowy wymaga zachowania formuł, a polityka bezpieczeństwa wymaga plików chronionych hasłem. W tym momencie biblioteka obsługująca wyłącznie format CSV zmusza do dodania drugiej zależności i utrzymywania dwóch oddzielnych ścieżek integracji. Ujednolicona biblioteka arkuszy kalkulacyjnych eliminuje ten podział od samego początku.

Jakie są Twoje kolejne kroki?

IronXL zapewnia jednolity, spójny interfejs API do odczytu, zapisu i konwersji plików CSV i Excel w dowolnej aplikacji .NET 10. Kluczowe zalety są oczywiste: brak zależności od pakietu Office, obsługa wielu platform, silne typowanie wartości komórek oraz bezpośrednia ścieżka od projektów opartych wyłącznie na plikach CSV do pełnej funkcjonalności arkusza kalkulacyjnego w przypadku zmiany wymagań.

Kiedy będziesz gotowy, aby zagłębić się w temat, zacznij od zagadnień najbardziej istotnych dla Twojego obecnego projektu. Jeśli zajmujesz się głównie potokami importu CSV, omówione powyżej wzorce odczytu i mapowania obsługują większość rzeczywistych scenariuszy. Jeśli wymagania dotyczące wyników są zróżnicowane — czasami CSV dla skryptów dalszego przetwarzania, czasami XLSX dla użytkowników końcowych — sekcja dotycząca konwersji formatów pokazuje, jak obsłużyć oba formaty przy użyciu jednego kodu źródłowego.

Dla zespołów tworzących systemy raportowania lub eksportujących wyniki z baz danych podejście InsertDataTable dobrze się skaluje i pozwala uniknąć obciążenia wydajnościowego związanego z przypisywaniem komórek wiersz po wierszu. W połączeniu ze stylizacją komórek pozwala to tworzyć raporty, które użytkownicy mogą otwierać bezpośrednio w programie Excel bez konieczności ponownego formatowania.

Aby kontynuować, wykonaj następujące kroki:

1. Zainstaluj bibliotekę za pomocą NuGet, korzystając z Install-Package IronXL lub dotnet add package IronXL.
2. Postępuj zgodnie z instrukcją szybkiego startu zawartą w przewodniku IronXL, aby załadować swój pierwszy plik CSV.
3. Zapoznaj się z samouczkiem dotyczącym konwersji formatu z CSV do Excel, jeśli potrzebujesz obu formatów w tym samym projekcie.
4. Zapoznaj się z dokumentacją API w sekcji IronXL object reference, aby uzyskać informacje na temat zaawansowanych operacji na komórkach, obsługi formuł i stylizacji.
5. Rozpocznij bezpłatny okres próbny na stronie licencji próbnej IronXL — nie jest wymagańa karta kredytowa, w cenie zawarte jest wsparcie techniczne.

Jeśli rozważasz różne opcje wraz z innymi narzędziami Iron Software, pakiet produktów IronSoftware obejmuje generowanie plików PDF za pomocą IronPDF, odczyt kodów kreskowych, OCR i wiele innych funkcji — wszystkie oparte na tym samym modelu licencjonowania i kanale wsparcia.