Jak pisać pliki CSV w .NET z IronXL

Dłączego programiści .NET potrzebują lepszego rozwiązania do obsługi plików CSV?

Pliki CSV umożliwiają wymianę danych między niezliczoną liczbą aplikacji .NET — a standardowe opcje biblioteczne często okazują się niewystarczające, gdy trzeba poradzić sobie ze złożonością rzeczywistych sytuacji. Od raportów finansowych po systemy magazynowe — można programowo tworzyć pliki CSV za pomocą zaledwie kilku wierszy kodu. Podczas gdy biblioteki takie jak CsvHelper obsługują podstawowe operacje CSV, współcześni programiści mają do czynienia ze złożonymi scenariuszami: konwersją skoroszytów Excel zawierających formuły, zachowaniem typów danych podczas eksportu oraz obsługą procesów związanych z arkuszami kalkulacyjnymi na poziomie Enterprise. IronXL odpowiada na te wyzwania, łącząc niezawodne zapisywanie plików CSV z pełną funkcjonalnością programu Excel w jednej, niezależnej bibliotece IronXL, zgodnej ze standardami RFC 4180.

Dzięki temu idealnie nadaje się dla programistów tworzących niestandardowy moduł zapisujący pliki CSV w środowisku .NET lub parser plików CSV w środowisku .NET, który obsługuje wiele kolumn, logikę przetwarzania specyficzną dla wierszy oraz automatycznie wnioskowane separatory. Ten samouczek przeprowadzi Cię przez możliwości IronXL w zakresie plików CSV — od podstawowego tworzenia plików po eksport danych na skalę Enterprise.

Jak zainstalować i skonfigurować IronXL?

Instalacja IronXL zajmuje kilka sekund za pomocą menedżera pakietów NuGet. Można użyć konsoli menedżera pakietów lub interfejsu CLI platformy .NET:

Install-Package IronXL
dotnet add package IronXL

Install-Package IronXL
dotnet add package IronXL

Po zainstalowaniu dodaj przestrzeń nazw IronXL i od razu zacznij tworzyć pliki CSV. Poniższy przykład pokazuje, jak utworzyć skoroszyt, wypełnić go danymi i wyeksportować do pliku CSV przy użyciu instrukcji najwyższego poziomu w .NET 10:

using IronXL;

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

// Add headers
workSheet["A1"].Value = "Product";
workSheet["B1"].Value = "Quantity";
workSheet["C1"].Value = "Price";

// Add data rows
workSheet["A2"].Value = "Widget";
workSheet["B2"].Value = 100;
workSheet["C2"].Value = 19.99;

workSheet["A3"].Value = "Gadget";
workSheet["B3"].Value = 250;
workSheet["C3"].Value = 34.50;

workSheet["A4"].Value = "Component";
workSheet["B4"].Value = 75;
workSheet["C4"].Value = 8.99;

// Save as CSV with comma delimiter
workBook.SaveAsCsv("inventory.csv", ",");

using IronXL;

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

// Add headers
workSheet["A1"].Value = "Product";
workSheet["B1"].Value = "Quantity";
workSheet["C1"].Value = "Price";

// Add data rows
workSheet["A2"].Value = "Widget";
workSheet["B2"].Value = 100;
workSheet["C2"].Value = 19.99;

workSheet["A3"].Value = "Gadget";
workSheet["B3"].Value = 250;
workSheet["C3"].Value = 34.50;

workSheet["A4"].Value = "Component";
workSheet["B4"].Value = 75;
workSheet["C4"].Value = 8.99;

// Save as CSV with comma delimiter
workBook.SaveAsCsv("inventory.csv", ",");

Imports IronXL

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

' Add headers
workSheet("A1").Value = "Product"
workSheet("B1").Value = "Quantity"
workSheet("C1").Value = "Price"

' Add data rows
workSheet("A2").Value = "Widget"
workSheet("B2").Value = 100
workSheet("C2").Value = 19.99

workSheet("A3").Value = "Gadget"
workSheet("B3").Value = 250
workSheet("C3").Value = 34.5

workSheet("A4").Value = "Component"
workSheet("B4").Value = 75
workSheet("C4").Value = 8.99

' Save as CSV with comma delimiter
workBook.SaveAsCsv("inventory.csv", ",")

Ten prosty program pokazuje, jak zapisywać zawartość pliku CSV bezpośrednio z kodu C#, tworząc obiekt WorkBook, który przechowuje dane. Metoda SaveAsCsv używa przecinka jako domyślnego separatora, ale pozwala na określenie dowolnego znaku separatora — przydatnego w scenariuszach specyficznych dla danego regionu, gdzie standardowym separatorem kolumn są średniki lub tabulatory.

using IronXL;

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

workSheet["A1"].Value = "Region";
workSheet["B1"].Value = "Revenue";
workSheet["C1"].Value = "Units";

workSheet["A2"].Value = "Europe";
workSheet["B2"].Value = "1250000.50";
workSheet["C2"].Value = 3400;

workSheet["A3"].Value = "Nierth America";
workSheet["B3"].Value = "2800000.00";
workSheet["C3"].Value = 7200;

// Semicolon delimiter for European locales
workBook.SaveAsCsv("sales_europe.csv", ";");

// Tab delimiter for TSV output
workBook.SaveAsCsv("sales_tsv.tsv", "\t");

using IronXL;

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

workSheet["A1"].Value = "Region";
workSheet["B1"].Value = "Revenue";
workSheet["C1"].Value = "Units";

workSheet["A2"].Value = "Europe";
workSheet["B2"].Value = "1250000.50";
workSheet["C2"].Value = 3400;

workSheet["A3"].Value = "Nierth America";
workSheet["B3"].Value = "2800000.00";
workSheet["C3"].Value = 7200;

// Semicolon delimiter for European locales
workBook.SaveAsCsv("sales_europe.csv", ";");

// Tab delimiter for TSV output
workBook.SaveAsCsv("sales_tsv.tsv", "\t");

Imports IronXL

Dim workBook As WorkBook = WorkBook.Create()
Dim workSheet As WorkSheet = workBook.CreateWorkSheet("sales")

workSheet("A1").Value = "Region"
workSheet("B1").Value = "Revenue"
workSheet("C1").Value = "Units"

workSheet("A2").Value = "Europe"
workSheet("B2").Value = "1250000.50"
workSheet("C2").Value = 3400

workSheet("A3").Value = "Nierth America"
workSheet("B3").Value = "2800000.00"
workSheet("C3").Value = 7200

' Semicolon delimiter for European locales
workBook.SaveAsCsv("sales_europe.csv", ";")

' Tab delimiter for TSV output
workBook.SaveAsCsv("sales_tsv.tsv", vbTab)

Jak przekonwertować skoroszyty Excel na CSV?

using IronXL;

// Load an Excel file with formulas and formatting
WorkBook workBook = WorkBook.Load("financial_report.xlsx");

// Evaluate all formulas before export so calculated values appear in CSV
workBook.EvaluateAll();

// Export to CSV -- each worksheet creates a separate CSV file
// Creates: report.Sheet1.csv, report.Sheet2.csv, etc.
workBook.SaveAsCsv("report.csv", ",");

using IronXL;

// Load an Excel file with formulas and formatting
WorkBook workBook = WorkBook.Load("financial_report.xlsx");

// Evaluate all formulas before export so calculated values appear in CSV
workBook.EvaluateAll();

// Export to CSV -- each worksheet creates a separate CSV file
// Creates: report.Sheet1.csv, report.Sheet2.csv, etc.
workBook.SaveAsCsv("report.csv", ",");

Imports IronXL

' Load an Excel file with formulas and formatting
Dim workBook As WorkBook = WorkBook.Load("financial_report.xlsx")

' Evaluate all formulas before export so calculated values appear in CSV
workBook.EvaluateAll()

' Export to CSV -- each worksheet creates a separate CSV file
' Creates: report.Sheet1.csv, report.Sheet2.csv, etc.
workBook.SaveAsCsv("report.csv", ",")

using System.Data;
using IronXL;

// Simulate a DataTable from a database query
DataTable dataTable = GetSalesData();

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

// Write column headers from DataTable schema
for (int col = 0; col < dataTable.Columns.Count; col++)
{
    workSheet.SetCellValue(0, col, dataTable.Columns[col].ColumnName);
}

// Write data rows
int row = 1;
foreach (DataRow dataRow in dataTable.Rows)
{
    for (int col = 0; col < dataTable.Columns.Count; col++)
    {
        workSheet.SetCellValue(row, col, dataRow[col]?.ToString() ?? string.Empty);
    }
    row++;
}

// Export with semicolon delimiter for European compatibility
workBook.SaveAsCsv("sales_data.csv", ";");

using System.Data;
using IronXL;

// Simulate a DataTable from a database query
DataTable dataTable = GetSalesData();

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

// Write column headers from DataTable schema
for (int col = 0; col < dataTable.Columns.Count; col++)
{
    workSheet.SetCellValue(0, col, dataTable.Columns[col].ColumnName);
}

// Write data rows
int row = 1;
foreach (DataRow dataRow in dataTable.Rows)
{
    for (int col = 0; col < dataTable.Columns.Count; col++)
    {
        workSheet.SetCellValue(row, col, dataRow[col]?.ToString() ?? string.Empty);
    }
    row++;
}

// Export with semicolon delimiter for European compatibility
workBook.SaveAsCsv("sales_data.csv", ";");

Imports System.Data
Imports IronXL

' Simulate a DataTable from a database query
Dim dataTable As DataTable = GetSalesData()

Dim workBook As WorkBook = WorkBook.Create()
Dim workSheet As WorkSheet = workBook.CreateWorkSheet("sales")

' Write column headers from DataTable schema
For col As Integer = 0 To dataTable.Columns.Count - 1
    workSheet.SetCellValue(0, col, dataTable.Columns(col).ColumnName)
Next

' Write data rows
Dim row As Integer = 1
For Each dataRow As DataRow In dataTable.Rows
    For col As Integer = 0 To dataTable.Columns.Count - 1
        workSheet.SetCellValue(row, col, If(dataRow(col)?.ToString(), String.Empty))
    Next
    row += 1
Next

' Export with semicolon delimiter for European compatibility
workBook.SaveAsCsv("sales_data.csv", ";")

Jak IronXL wypada w porównaniu z CsvHelper pod względem tworzenia plików CSV?

Rozważmy ten scenariusz eksportu danych pracowników, ilustrujący procesy zapisywania plików CSV przy użyciu obu bibliotek.

Implementacja CsvHelper:

using System.Globalization;
using System.IO;
using CsvHelper;

using var writer = new StreamWriter("employees.csv");
using var csv = new CsvWriter(writer, CultureInfo.InvariantCulture);
csv.WriteRecords(employees);

using System.Globalization;
using System.IO;
using CsvHelper;

using var writer = new StreamWriter("employees.csv");
using var csv = new CsvWriter(writer, CultureInfo.InvariantCulture);
csv.WriteRecords(employees);

Imports System.Globalization
Imports System.IO
Imports CsvHelper

Using writer As New StreamWriter("employees.csv")
    Using csv As New CsvWriter(writer, CultureInfo.InvariantCulture)
        csv.WriteRecords(employees)
    End Using
End Using

Wdrożenie IronXL:

using IronXL;

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

int rowIndex = 1;
foreach (var emp in employees)
{
    workSheet[$"A{rowIndex}"].Value = emp.Name;
    workSheet[$"B{rowIndex}"].Value = emp.Salary;
    workSheet[$"C{rowIndex}"].Value = emp.StartDate;
    rowIndex++;
}

workBook.SaveAsCsv("employees.csv", ",");

using IronXL;

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

int rowIndex = 1;
foreach (var emp in employees)
{
    workSheet[$"A{rowIndex}"].Value = emp.Name;
    workSheet[$"B{rowIndex}"].Value = emp.Salary;
    workSheet[$"C{rowIndex}"].Value = emp.StartDate;
    rowIndex++;
}

workBook.SaveAsCsv("employees.csv", ",");

Imports IronXL

Dim workBook As WorkBook = WorkBook.Create()
Dim workSheet As WorkSheet = workBook.CreateWorkSheet("employees")

Dim rowIndex As Integer = 1
For Each emp In employees
    workSheet($"A{rowIndex}").Value = emp.Name
    workSheet($"B{rowIndex}").Value = emp.Salary
    workSheet($"C{rowIndex}").Value = emp.StartDate
    rowIndex += 1
Next

workBook.SaveAsCsv("employees.csv", ",")

CsvHelper sprawnie obsługuje prostą serializację obiektów POCO. IronXL zapewnia dodatkowe możliwości, gdy trzeba załadować istniejące pliki Excel, sprawdzić formuły przed eksportem lub zarządzać zakresami arkuszy z precyzyjną kontrolą. Jeśli Twój proces pracy obejmuje odbieranie plików .xlsx od użytkowników biznesowych i konwertowanie ich do formatu CSV dla systemów niższego szczebla, IronXL eliminuje cały etap konwersji z Twojego procesu.

Jakie funkcje dla Enterprise oferuje IronXL w zakresie eksportu do plików CSV?

Metoda SaveAsCsv firmy IronXL oferuje kilka gotowych do użycia w środowisku produkcyjnym funkcji:

Przed eksportem można zastosować formatowanie danych komórek, aby kontrolować sposób wyświetlania liczb, walut i dat w pliku CSV. W przypadku dużych zbiorów danych należy przetwarzać dane w partiach, korzystając z operacji na zakresach arkusza, aby zużycie pamięci było przewidywalne.

Obsługa wielu platform oznacza, że można wdrożyć generowanie plików CSV oparte na IronXL w kontenerach Linux w Kubernetes lub Azure App Service bez wprowadzania jakichkolwiek zmian w kodzie. Biblioteka nie zawiera żadnych zależności niezarządzanych, dzięki czemu działa identycznie na różnych systemach operacyjnych. Pełne informacje na temat obsługiwanych środowisk uruchomieniowych można znaleźć w przewodniku zgodności platformy IronXL.

Jak radzisz sobie z typowymi problemami związanymi z eksportem do plików CSV?

Podczas pracy z eksportami CSV na dużą skalę pojawia się kilka przewidywalnych problemów. Oto jak rozwiązać każdy z nich:

Znaki specjalne w danych: IronXL automatycznie zamienia znaki cudzysłowu, przecinki i znaki nowej linii w wartościach komórek. Nie ma potrzeby wstępnego przetwarzania ciągów znaków ani pisania niestandardowej logiki escape — biblioteka wewnętrznie obsługuje reguły cytowania RFC 4180.

Obsługa dużych plików: W przypadku skoroszytów zawierających dziesiątki tysięcy wierszy należy używać zakresów arkuszy do przetwarzania danych partiami. Zapisywanie danych do arkuszy pośrednich przed ostatecznym eksportem zapewnia kontrolę nad alokacją pamięci.

Kwestie związane z kodowaniem: W przypadku znaków międzynarodowych, alfabetów azjatyckich lub emoji w wartościach komórek należy wyraźnie określić kodowanie UTF-8. IronXL obsługuje kodowanie UTF-8 i UTF-16 od razu po uruchomieniu, więc nie jest wymagańa żadna biblioteka kodowania innych firm.

Brakujące lub błędnie wpisane dane: IronXL domyślnie zachowuje formaty liczbowe i daty. Gdy komórka zawiera formułę odwołującą się do brakujących danych, EvaluateAll() zostanie zastąpione wartością błędu zamiast cichego wyświetlania pustego tekstu, co pozwala na wczesne wykrycie problemów z jakością danych w procesie przetwarzania.

Konflikty separatorów: Jeśli dane zawierają znak separatora (na przykład pole ceny zawierające $1,200.00 przy użyciu przecinka jako separatora), IronXL automatycznie otacza wartość podwójnymi cudzysłowami zgodnie z zasadami RFC 4180.

Szczegółowe wskazówki można znaleźć w dokumentacji IronXL CSV, Dokumentacji API oraz zasobach pomocy technicznej.

Jak odczytywać i analizować pliki CSV za pomocą IronXL?

Zapis w formacie CSV to tylko połowa sukcesu. IronXL obsługuje również odczyt i parsowanie plików CSV, ładując dane rozdzielone przecinkami do struktury skoroszytu, którą można przeszukiwać, filtrować i przekształcać przed eksportem do dowolnego formatu.

using IronXL;

// Load an existing CSV file into a workbook
WorkBook workBook = WorkBook.Load("sales_data.csv");
WorkSheet workSheet = workBook.DefaultWorkSheet;

// Iterate over rows and process data
foreach (var row in workSheet.Rows)
{
    string product = row["A"].ToString();
    int quantity = row["B"].IntValue;
    decimal price = (decimal)row["C"].DoubleValue;

    Console.WriteLine($"Product: {product}, Qty: {quantity}, Price: {price:C}");
}

// Apply a filter and re-export to a new CSV
workBook.SaveAsCsv("filtered_output.csv", ",");

using IronXL;

// Load an existing CSV file into a workbook
WorkBook workBook = WorkBook.Load("sales_data.csv");
WorkSheet workSheet = workBook.DefaultWorkSheet;

// Iterate over rows and process data
foreach (var row in workSheet.Rows)
{
    string product = row["A"].ToString();
    int quantity = row["B"].IntValue;
    decimal price = (decimal)row["C"].DoubleValue;

    Console.WriteLine($"Product: {product}, Qty: {quantity}, Price: {price:C}");
}

// Apply a filter and re-export to a new CSV
workBook.SaveAsCsv("filtered_output.csv", ",");

Imports IronXL

' Load an existing CSV file into a workbook
Dim workBook As WorkBook = WorkBook.Load("sales_data.csv")
Dim workSheet As WorkSheet = workBook.DefaultWorkSheet

' Iterate over rows and process data
For Each row In workSheet.Rows
    Dim product As String = row("A").ToString()
    Dim quantity As Integer = row("B").IntValue
    Dim price As Decimal = CType(row("C").DoubleValue, Decimal)

    Console.WriteLine($"Product: {product}, Qty: {quantity}, Price: {price:C}")
Next

' Apply a filter and re-export to a new CSV
workBook.SaveAsCsv("filtered_output.csv", ",")

Załadowanie pliku CSV za pomocą IronXL zapewnia dostęp do pełnego interfejsu API arkusza kalkulacyjnego, w tym sortowania, filtrowania i obliczania formuł. Można również zapisać załadowane dane jako plik Excel za pomocą funkcji SaveAs, konwertując CSV na XLSX za pomocą jednego wywołania metody — jest to częsty wymóg podczas tworzenia usług generowania raportów.

using IronXL;

WorkBook workBook = WorkBook.Load("input.xlsx");
WorkSheet workSheet = workBook.DefaultWorkSheet;

var errors = new List<string>();

for (int rowIdx = 1; rowIdx <= workSheet.RowCount; rowIdx++)
{
    string productName = workSheet[$"A{rowIdx}"].StringValue;
    double price = workSheet[$"C{rowIdx}"].DoubleValue;

    if (string.IsNullOrWhiteSpace(productName))
        errors.Add($"Row {rowIdx}: Product name is empty.");

    if (price <= 0)
        errors.Add($"Row {rowIdx}: Price must be greater than zero (found {price}).");
}

if (errors.Count == 0)
{
    workBook.SaveAsCsv("validated_output.csv", ",");
    Console.WriteLine("Export complete.");
}
else
{
    foreach (var error in errors)
        Console.WriteLine(error);
}

using IronXL;

WorkBook workBook = WorkBook.Load("input.xlsx");
WorkSheet workSheet = workBook.DefaultWorkSheet;

var errors = new List<string>();

for (int rowIdx = 1; rowIdx <= workSheet.RowCount; rowIdx++)
{
    string productName = workSheet[$"A{rowIdx}"].StringValue;
    double price = workSheet[$"C{rowIdx}"].DoubleValue;

    if (string.IsNullOrWhiteSpace(productName))
        errors.Add($"Row {rowIdx}: Product name is empty.");

    if (price <= 0)
        errors.Add($"Row {rowIdx}: Price must be greater than zero (found {price}).");
}

if (errors.Count == 0)
{
    workBook.SaveAsCsv("validated_output.csv", ",");
    Console.WriteLine("Export complete.");
}
else
{
    foreach (var error in errors)
        Console.WriteLine(error);
}

Imports IronXL

Dim workBook As WorkBook = WorkBook.Load("input.xlsx")
Dim workSheet As WorkSheet = workBook.DefaultWorkSheet

Dim errors As New List(Of String)()

For rowIdx As Integer = 1 To workSheet.RowCount
    Dim productName As String = workSheet($"A{rowIdx}").StringValue
    Dim price As Double = workSheet($"C{rowIdx}").DoubleValue

    If String.IsNullOrWhiteSpace(productName) Then
        errors.Add($"Row {rowIdx}: Product name is empty.")
    End If

    If price <= 0 Then
        errors.Add($"Row {rowIdx}: Price must be greater than zero (found {price}).")
    End If
Next

If errors.Count = 0 Then
    workBook.SaveAsCsv("validated_output.csv", ",")
    Console.WriteLine("Export complete.")
Else
    For Each error As String In errors
        Console.WriteLine(error)
    Next
End If

Jak rozpocząć pracę z IronXL do zapisywania plików CSV?

IronXL zmienia zapis CSV z trudnego zadania parsowania w prostą operację. Dzięki połączeniu funkcji CSV z obsługą skoroszytów Excel, obliczaniem formuł i automatyczną obsługą typów eliminuje złożoność związaną z zarządzaniem wieloma bibliotekami lub ręczną konwersją danych.

Bezpłatna wersja próbna zapewnia pełny dostęp do wszystkich funkcji — w tym eksportu wielu arkuszy, obliczania formuł i wdrażania na różnych platformach — bez konieczności posiadania klucza licencyjnego podczas tworzenia oprogramowania. Kiedy będziesz gotowy do przejścia do produkcji, licencja zaczyna się od poziomu dla jednego programisty, który obejmuje użytkowanie komercyjne.

Kluczowe zasoby na początek:

• Dokumentacja IronXL — pełna dokumentacja API i przewodniki użytkownika
• Przewodnik po konwersji plików CSV do formatu Excel — szczegółowa instrukcja konwersji formatów
• Samouczek dotyczący eksportu z DataTable — wzorce eksportu oparte na bazach danych
• Operacje na zakresach arkusza — wydajne przetwarzanie dużych zbiorów danych
• Przewodnik po rozwiązywaniu problemów — rozwiązania typowych problemów z integracją

Gotowy do tworzenia gotowych do wdrożenia procesów CSV? Rozpocznij bezpłatny okres próbny i uruchom swój pierwszy eksport CSV w mniej niż pięć minut.