Jak szybko czytać pliki CSV w C# z IronXL?

Jak szybko odczytywać pliki CSV w języku C# za pomocą IronXL?

Szybkie odczytywanie plików CSV w języku C# jest proste dzięki bibliotece IronXL, która zamienia dane rozdzielone przecinkami w skoroszyt z możliwością wyszukiwania za pomocą zaledwie kilku linii kodu. Wywołaj WorkBook.LoadCSV, uzyskaj dostęp do arkusza i zacznij iterować wiersze — bez szablonowego kodu StreamReader, bez ręcznej logiki podziału i bez konieczności instalacji pakietu Office.

Jak zainstalować IronXL, aby rozpocząć pracę?

Zanim załadujesz jakiekolwiek dane CSV, dodaj IronXL do swojego projektu za pośrednictwem NuGet. Otwórz konsolę menedżera pakietów lub terminal w katalogu projektu i uruchom jedno z poniższych poleceń:

Install-Package IronXL
dotnet add package IronXL

Install-Package IronXL
dotnet add package IronXL

Po instalacji dodaj using IronXL; na początku każdego pliku, w którym chcesz odczytywać lub zapisywać dane CSV. IronXL jest przeznaczony dla platformy .NET 10 i wszystkich nowoczesnych wersji .NET, więc nie jest wymagańa żadna dodatkowa konfiguracja środowiska uruchomieniowego. Pakiet zawiera wszystko, co jest potrzebne — nie ma oddzielnych plików binarnych, zestawów SDK dla platform ani plików konfiguracyjnych. Możesz sprawdzić, czy instalacja się powiodła, szukając w pliku projektu wpisu <PackageReference Include="IronXL" .../>.

Aby uzyskać szybki przegląd możliwości biblioteki IronXL wykraczających poza obsługę plików CSV, zapoznaj się ze stroną funkcji IronXL oraz opisem pakietu NuGet.

Jak załadować i odczytać plik CSV w języku C#?

Najszybsza droga do odczytu danych CSV zaczyna się od metody WorkBook.LoadCSV. To pojedyncze wywołanie obsługuje ładowanie pliku, analizuje każdy wiersz i zwraca w pełni funkcjonalny obiekt skoroszytu gotowy do dostępu do danych — w przeciwieństwie do ręcznego tworzenia StreamReader i samodzielnego przetwarzania każdego wiersza.

using IronXL;

// Load CSV file directly into a workbook
WorkBook workbook = WorkBook.LoadCSV("sales_data.csv", fileFormat: ExcelFileFormat.XLSX);

// Access the default worksheet containing CSV data
WorkSheet sheet = workbook.DefaultWorkSheet;

// Read specific cell values using Excel-style addressing
string customerName = sheet["A2"].StringValue;
decimal orderTotal = sheet["D2"].DecimalValue;

// Iterate through all data rows
foreach (var row in sheet.Rows)
{
    Console.WriteLine($"Row {row.RowNumber}: {row.Columns[0].Value}");
}

using IronXL;

// Load CSV file directly into a workbook
WorkBook workbook = WorkBook.LoadCSV("sales_data.csv", fileFormat: ExcelFileFormat.XLSX);

// Access the default worksheet containing CSV data
WorkSheet sheet = workbook.DefaultWorkSheet;

// Read specific cell values using Excel-style addressing
string customerName = sheet["A2"].StringValue;
decimal orderTotal = sheet["D2"].DecimalValue;

// Iterate through all data rows
foreach (var row in sheet.Rows)
{
    Console.WriteLine($"Row {row.RowNumber}: {row.Columns[0].Value}");
}

Imports IronXL

' Load CSV file directly into a workbook
Dim workbook As WorkBook = WorkBook.LoadCSV("sales_data.csv", fileFormat:=ExcelFileFormat.XLSX)

' Access the default worksheet containing CSV data
Dim sheet As WorkSheet = workbook.DefaultWorkSheet

' Read specific cell values using Excel-style addressing
Dim customerName As String = sheet("A2").StringValue
Dim orderTotal As Decimal = sheet("D2").DecimalValue

' Iterate through all data rows
For Each row In sheet.Rows
    Console.WriteLine($"Row {row.RowNumber}: {row.Columns(0).Value}")
Next

Metoda LoadCSV przyjmuje nazwę pliku i opcjonalną specyfikację formatu, automatycznie wykrywając separator w postaci przecinka i analizując każdą wartość pola do odpowiedniej komórki. Parser domyślnie traktuje pierwszą linię jako dane nagłówkowe, dzięki czemu nazwy kolumn są natychmiast dostępne po nazwie.

Jak radzisz sobie z różnymi separatorami w plikach CSV?

W rzeczywistości pliki CSV rzadko są zgodne z jednym standardem. W systemach europejskich często stosuje się średniki jako separatory (ponieważ przecinki służą jako separatory dziesiętne), natomiast pliki z wartościami rozdzielonymi tabulatorami (TSV) są powszechne w aplikacjach naukowych i starszych wersjach oprogramowania. IronXL obsługuje te warianty za pomocą parametru listDelimiter, obsługując dowolny znak lub ciąg znaków jako separator.

using IronXL;

// Load semicolon-delimited CSV (common in European formats)
WorkBook europeanData = WorkBook.LoadCSV("german_report.csv",
    fileFormat: ExcelFileFormat.XLSX,
    listDelimiter: ";");

// Load tab-separated values file
WorkBook tsvData = WorkBook.LoadCSV("research_data.tsv",
    fileFormat: ExcelFileFormat.XLSX,
    listDelimiter: "\t");

// Load pipe-delimited file (common in legacy systems)
WorkBook pipeData = WorkBook.LoadCSV("legacy_export.csv",
    fileFormat: ExcelFileFormat.XLSX,
    listDelimiter: "|");

// Access data identically regardless of original delimiter
WorkSheet sheet = europeanData.DefaultWorkSheet;
Console.WriteLine($"First value: {sheet["A1"].Value}");

using IronXL;

// Load semicolon-delimited CSV (common in European formats)
WorkBook europeanData = WorkBook.LoadCSV("german_report.csv",
    fileFormat: ExcelFileFormat.XLSX,
    listDelimiter: ";");

// Load tab-separated values file
WorkBook tsvData = WorkBook.LoadCSV("research_data.tsv",
    fileFormat: ExcelFileFormat.XLSX,
    listDelimiter: "\t");

// Load pipe-delimited file (common in legacy systems)
WorkBook pipeData = WorkBook.LoadCSV("legacy_export.csv",
    fileFormat: ExcelFileFormat.XLSX,
    listDelimiter: "|");

// Access data identically regardless of original delimiter
WorkSheet sheet = europeanData.DefaultWorkSheet;
Console.WriteLine($"First value: {sheet["A1"].Value}");

Imports IronXL

' Load semicolon-delimited CSV (common in European formats)
Dim europeanData As WorkBook = WorkBook.LoadCSV("german_report.csv", fileFormat:=ExcelFileFormat.XLSX, listDelimiter:=";")

' Load tab-separated values file
Dim tsvData As WorkBook = WorkBook.LoadCSV("research_data.tsv", fileFormat:=ExcelFileFormat.XLSX, listDelimiter:=vbTab)

' Load pipe-delimited file (common in legacy systems)
Dim pipeData As WorkBook = WorkBook.LoadCSV("legacy_export.csv", fileFormat:=ExcelFileFormat.XLSX, listDelimiter:="|")

' Access data identically regardless of original delimiter
Dim sheet As WorkSheet = europeanData.DefaultWorkSheet
Console.WriteLine($"First value: {sheet("A1").Value}")

Parametr listDelimiter akceptuje dowolną wartość ciągu znaków, zapewniając elastyczność w stosunku do praktycznie każdego znaku lub sekwencji separatora. Po załadowaniu dane są dostępne za pośrednictwem tego samego interfejsu API, niezależnie od oryginalnego formatu pliku, co zapewnia spójne środowisko programistyczne w różnych źródłach danych.

Jak przekonwertować dane CSV do tabeli danych (DataTable)?

Operacje na bazach danych często wymagają danych CSV w formacie DataTable do masowego wstawiania, zapytań LINQ lub powiązania z kontrolkami obsługującymi dane. Metoda ToDataTable konwertuje dane z arkusza kalkulacyjnego bezpośrednio na obiekt System.Data.DataTable za pomocą jednego wywołania, eliminując konieczność ręcznego tworzenia struktury listy lub tablicy.

using IronXL;
using System.Data;

// Load CSV and convert to DataTable
WorkBook workbook = WorkBook.LoadCSV("customers.csv", ExcelFileFormat.XLSX);
WorkSheet sheet = workbook.DefaultWorkSheet;

// Convert worksheet to DataTable (first row becomes column headers)
DataTable customerTable = sheet.ToDataTable(true);

// Access data using standard DataTable operations
foreach (DataRow row in customerTable.Rows)
{
    Console.WriteLine($"Customer: {row["Name"]}, Email: {row["Email"]}");
}

// Use with LINQ for filtering and transformation
var activeCustomers = customerTable.AsEnumerable()
    .Where(r => r.Field<string>("Status") == "Active")
    .ToList();

int totalCount = customerTable.Rows.Count;
Console.WriteLine($"Processed {totalCount} customer records");

using IronXL;
using System.Data;

// Load CSV and convert to DataTable
WorkBook workbook = WorkBook.LoadCSV("customers.csv", ExcelFileFormat.XLSX);
WorkSheet sheet = workbook.DefaultWorkSheet;

// Convert worksheet to DataTable (first row becomes column headers)
DataTable customerTable = sheet.ToDataTable(true);

// Access data using standard DataTable operations
foreach (DataRow row in customerTable.Rows)
{
    Console.WriteLine($"Customer: {row["Name"]}, Email: {row["Email"]}");
}

// Use with LINQ for filtering and transformation
var activeCustomers = customerTable.AsEnumerable()
    .Where(r => r.Field<string>("Status") == "Active")
    .ToList();

int totalCount = customerTable.Rows.Count;
Console.WriteLine($"Processed {totalCount} customer records");

Imports IronXL
Imports System.Data
Imports System.Linq

' Load CSV and convert to DataTable
Dim workbook As WorkBook = WorkBook.LoadCSV("customers.csv", ExcelFileFormat.XLSX)
Dim sheet As WorkSheet = workbook.DefaultWorkSheet

' Convert worksheet to DataTable (first row becomes column headers)
Dim customerTable As DataTable = sheet.ToDataTable(True)

' Access data using standard DataTable operations
For Each row As DataRow In customerTable.Rows
    Console.WriteLine($"Customer: {row("Name")}, Email: {row("Email")}")
Next

' Use with LINQ for filtering and transformation
Dim activeCustomers = customerTable.AsEnumerable() _
    .Where(Function(r) r.Field(Of String)("Status") = "Active") _
    .ToList()

Dim totalCount As Integer = customerTable.Rows.Count
Console.WriteLine($"Processed {totalCount} customer records")

Metoda ToDataTable automatycznie mapuje kolumny arkusza na kolumny DataTable. Gdy useFirstRowAsColumnHeaders jest ustawione na true, wartości z pierwszego wiersza stają się nazwami kolumn, umożliwiając dostęp do pól według nazwy, a nie indeksu. DataTable integruje się bezpośrednio z SqlBulkCopy w celu zapewnienia wysokowydajnego wstawiania danych do SQL Server lub może być powiązany z kontrolkami DataGridView w celu natychmiastowej wizualizacji.

Konwersja zachowuje typy danych tam, gdzie to możliwe, a IronXL wnioskuje typy liczbowe, daty i tekstowe na podstawie wartości komórek. To automatyczne wnioskowanie o typie ogranicza ręczne parsowanie, które zazwyczaj jest wymagańe podczas pracy z surowymi ciągami znaków CSV. Znany interfejs API DataTable oznacza, że istniejący kod przetwarzający wyniki zapytań do bazy danych może przetwarzać dane CSV bez modyfikacji — co zapewnia znaczną oszczędność czasu podczas projektów migracyjnych.

Jak przekształcić pliki CSV do formatu Excel?

Jedną z kluczowych funkcji IronXL jest konwersja formatów między plikami CSV a Excel. Dane CSV można wzbogacić o formatowanie, formuły i wiele arkuszy, a następnie zapisać jako pełnoprawny skoroszyt Excel — wszystko w ramach tej samej bazy kodu. Aby uzyskać bardziej szczegółowe informacje na temat opcji stylizacji komórek i edycji formuł, zapoznaj się z dokumentacją IronXL, w której szczegółowo omówiono każdą z tych funkcji.

using IronXL;

// Load CSV data
WorkBook workbook = WorkBook.LoadCSV("quarterly_sales.csv", ExcelFileFormat.XLSX);
WorkSheet sheet = workbook.DefaultWorkSheet;

// Add formatting to make the data presentable
sheet["A1:D1"].Style.Font.Bold = true;
sheet["A1:D1"].Style.SetBackgroundColor("#4472C4");

// Add a formula to calculate totals
sheet["E2"].Formula = "=SUM(B2:D2)";

// Save as Excel format
workbook.SaveAs("quarterly_sales_formatted.xlsx");

// Or save back to CSV when needed
workbook.SaveAsCsv("quarterly_sales_processed.csv");

using IronXL;

// Load CSV data
WorkBook workbook = WorkBook.LoadCSV("quarterly_sales.csv", ExcelFileFormat.XLSX);
WorkSheet sheet = workbook.DefaultWorkSheet;

// Add formatting to make the data presentable
sheet["A1:D1"].Style.Font.Bold = true;
sheet["A1:D1"].Style.SetBackgroundColor("#4472C4");

// Add a formula to calculate totals
sheet["E2"].Formula = "=SUM(B2:D2)";

// Save as Excel format
workbook.SaveAs("quarterly_sales_formatted.xlsx");

// Or save back to CSV when needed
workbook.SaveAsCsv("quarterly_sales_processed.csv");

Imports IronXL

' Load CSV data
Dim workbook As WorkBook = WorkBook.LoadCSV("quarterly_sales.csv", ExcelFileFormat.XLSX)
Dim sheet As WorkSheet = workbook.DefaultWorkSheet

' Add formatting to make the data presentable
sheet("A1:D1").Style.Font.Bold = True
sheet("A1:D1").Style.SetBackgroundColor("#4472C4")

' Add a formula to calculate totals
sheet("E2").Formula = "=SUM(B2:D2)"

' Save as Excel format
workbook.SaveAs("quarterly_sales_formatted.xlsx")

' Or save back to CSV when needed
workbook.SaveAsCsv("quarterly_sales_processed.csv")

Metoda SaveAs określa format wyjściowy na podstawie rozszerzenia pliku, obsługując eksport do formatów XLSX, XLS, CSV, TSV, JSON i XML. Ta elastyczność oznacza, że jeden proces importu może zasilać wiele kanałów wyjściowych — na przykład raport w formacie Excel dla kierownictwa oraz wyciąg w formacie CSV dla systemu niższego szczebla. Przewodnik po kolorach tła i wzorów przedstawia pełen zakres dostępnych opcji stylistycznych.

Jak efektywnie przetwarzać duże pliki CSV?

Przetwarzanie plików CSV zawierających setki tysięcy wierszy wymaga przemyślanego zarządzania pamięcią. IronXL zapewnia praktyczne podejście do obsługi dużych zbiorów danych przy zachowaniu prostego interfejsu API. Zalecanym podejściem jest przetwarzanie danych partiami, a nie ładowanie i przekształcanie każdego rekordu jednocześnie, co pozwala kontrolować zużycie pamięci aktywnej.

using IronXL;

// Load large CSV file
WorkBook workbook = WorkBook.LoadCSV("large_dataset.csv", ExcelFileFormat.XLSX);
WorkSheet sheet = workbook.DefaultWorkSheet;

// Process data in manageable chunks using range selection
int batchSize = 10000;
int totalRows = sheet.RowCount;

for (int i = 1; i <= totalRows; i += batchSize)
{
    int endRow = Math.Min(i + batchSize - 1, totalRows);

    // Select a range of rows for processing
    var batch = sheet[$"A{i}:Z{endRow}"];
    foreach (var cell in batch)
    {
        ProcessRecord(cell.Value);
    }

    // Release memory between batches for very large files
    GC.Collect();
}

// Alternative: Process row by row for maximum control
for (int i = 0; i < sheet.RowCount; i++)
{
    var row = sheet.Rows[i];
    // Process individual row data
}

using IronXL;

// Load large CSV file
WorkBook workbook = WorkBook.LoadCSV("large_dataset.csv", ExcelFileFormat.XLSX);
WorkSheet sheet = workbook.DefaultWorkSheet;

// Process data in manageable chunks using range selection
int batchSize = 10000;
int totalRows = sheet.RowCount;

for (int i = 1; i <= totalRows; i += batchSize)
{
    int endRow = Math.Min(i + batchSize - 1, totalRows);

    // Select a range of rows for processing
    var batch = sheet[$"A{i}:Z{endRow}"];
    foreach (var cell in batch)
    {
        ProcessRecord(cell.Value);
    }

    // Release memory between batches for very large files
    GC.Collect();
}

// Alternative: Process row by row for maximum control
for (int i = 0; i < sheet.RowCount; i++)
{
    var row = sheet.Rows[i];
    // Process individual row data
}

Imports IronXL

' Load large CSV file
Dim workbook As WorkBook = WorkBook.LoadCSV("large_dataset.csv", ExcelFileFormat.XLSX)
Dim sheet As WorkSheet = workbook.DefaultWorkSheet

' Process data in manageable chunks using range selection
Dim batchSize As Integer = 10000
Dim totalRows As Integer = sheet.RowCount

For i As Integer = 1 To totalRows Step batchSize
    Dim endRow As Integer = Math.Min(i + batchSize - 1, totalRows)

    ' Select a range of rows for processing
    Dim batch = sheet($"A{i}:Z{endRow}")
    For Each cell In batch
        ProcessRecord(cell.Value)
    Next

    ' Release memory between batches for very large files
    GC.Collect()
Next

' Alternative: Process row by row for maximum control
For i As Integer = 0 To sheet.RowCount - 1
    Dim row = sheet.Rows(i)
    ' Process individual row data
Next

Ten wzorzec przetwarzania wsadowego pozwala na systematyczną obsługę dużych plików bez konieczności przetwarzania wszystkich rekordów jednocześnie. Składnia wyboru zakresu ($"A{i}:Z{endRow}") zapewnia wydajny dostęp do określonych zakresów wierszy.

Jak przeprowadzić przetwarzanie plików CSV na różnych platformach?

Współczesne programowanie w środowisku .NET obejmuje wiele środowisk wdrożeniowych — serwery Windows, kontenery Linux, maszyny programistyczne z systemem macOS oraz platformy chmurowe. IronXL działa spójnie we wszystkich tych środowiskach bez ścieżek kodu specyficznych dla platformy lub kompilacji warunkówej.

using IronXL;

// This code runs identically on Windows, Linux, macOS, Docker, Azure, and AWS
WorkBook workbook = WorkBook.LoadCSV("data.csv", ExcelFileFormat.XLSX);
WorkSheet sheet = workbook.DefaultWorkSheet;

// Platforma-agnostic file operations
string outputPath = Path.Combine(Environment.CurrentDirectory, "output.xlsx");
workbook.SaveAs(outputPath);

Console.WriteLine($"Processed on: {Environment.OSVersion.Platforma}");
Console.WriteLine($"Output saved to: {outputPath}");

bool success = File.Exists(outputPath);

using IronXL;

// This code runs identically on Windows, Linux, macOS, Docker, Azure, and AWS
WorkBook workbook = WorkBook.LoadCSV("data.csv", ExcelFileFormat.XLSX);
WorkSheet sheet = workbook.DefaultWorkSheet;

// Platforma-agnostic file operations
string outputPath = Path.Combine(Environment.CurrentDirectory, "output.xlsx");
workbook.SaveAs(outputPath);

Console.WriteLine($"Processed on: {Environment.OSVersion.Platforma}");
Console.WriteLine($"Output saved to: {outputPath}");

bool success = File.Exists(outputPath);

Imports IronXL

' This code runs identically on Windows, Linux, macOS, Docker, Azure, and AWS
Dim workbook As WorkBook = WorkBook.LoadCSV("data.csv", ExcelFileFormat.XLSX)
Dim sheet As WorkSheet = workbook.DefaultWorkSheet

' Platform-agnostic file operations
Dim outputPath As String = Path.Combine(Environment.CurrentDirectory, "output.xlsx")
workbook.SaveAs(outputPath)

Console.WriteLine($"Processed on: {Environment.OSVersion.Platform}")
Console.WriteLine($"Output saved to: {outputPath}")

Dim success As Boolean = File.Exists(outputPath)

Ten sam pakiet binarny działa na różnych systemach operacyjnych i w różnych modelach wdrażania. Poniższa tabela zawiera podsumowanie obsługiwanych platform:

Ta wielopłatformowa funkcjonalność eliminuje problemy typu "działa na moim komputerze", gdy kod przechodzi z etapu rozwoju do testów i wdrożenia. Procedura przetwarzania plików CSV opracowana na stacji roboczej z systemem Windows jest wdrażana w kontenerze Docker na systemie Linux bez żadnych modyfikacji. Wskazówki dotyczące konfiguracji wdrożenia można znaleźć w dokumentacji wdrożeniowej Microsoft .NET, która obejmuje strategie publikacji dla każdej platformy.

Jakie są Twoje kolejne kroki?

Odczytywanie plików CSV w języku C# nie wymaga poświęcania przejrzystości kodu na rzecz wydajności ani zajmowania się skomplikówaną konfiguracją. IronXL zapewnia spójny interfejs API, który automatycznie obsługuje parsowanie, konwersję typów i dostęp do danych, obsługując pełen zakres rzeczywistych wariantów CSV, od prostych eksportów rozdzielanych przecinkami po europejskie formaty rozdzielane średnikami i dane naukowe rozdzielane tabulatorami.

Aby rozpocząć korzystanie z IronXL w środowisku produkcyjnym, należy zakupić licencję IronXL, która odblokowuje wszystkie funkcje, w tym priorytetowe wsparcie techniczne, aktualizacje przez rok oraz wdrożenie Bez opłat licencyjnych. Dostępne są poziomy cenowe dla indywidualnych programistów, małych zespołów i projektów Enterprise.

Jeśli chcesz wypróbować IronXL przed podjęciem decyzji, bezpłatna licencja próbna pozwala przetestować wszystkie funkcje bez znaków wodnych i ograniczeń liczby wierszy w okresie próbnym. Biblioteka samouczków IronXL zawiera przykładowe scenariusze z przewodnikiem, obejmujące typowe sytuacje związane z plikami CSV i Excel.

W przypadku pytań dotyczących konkretnych przypadków użycia — takich jak przetwarzanie zaszyfrowanych plików CSV, obsługa niestandardowych kodowań lub integracja z dostawcami pamięci masowej w chmurze — pomoc zapewnia zespół wsparcia Iron Software oraz fora społecznościowe. Dodatkowe zasoby dotyczące obsługi danych .NET dostępne w serwisie Microsoft Learn dostarczają uzupełniających informacji na temat wzorców wejścia/wyjścia plików, które dobrze współpracują z IronXL.