Jak odczytać plik CSV do DataTable w C#

Dłączego konwersja CSV do DataTable ma znaczenie?

Konwersja CSV do DataTable pozwala programistom przekształcić wartości rozdzielone przecinkami w obiekty strukturalne do dalszego przetwarzania. Niezależnie od tego, czy zajmujesz się danymi magazynowymi, rekordami klientów czy dziennikami transakcji, sprawne konwertowanie plików CSV do formatu DataTable ma kluczowe znaczenie. Używając pierwszego wiersza jako nagłówków kolumn, można zapewnić, że kolumny tabeli danych będą zgodne ze schematem tabeli bazy danych, co sprawia, że idealnie nadaje się ona do operacji DataSet w programie Excel.

Tradycyjne podejścia często borykają się z problemami związanymi z dużymi plikami, różnymi separatorami lub zarządzaniem pamięcią. IronXL eliminuje te wyzwania i obsługuje różne separatory, pola w cudzysłowie oraz wbudowane przecinki bez konieczności stosowania dodatkowego kodu. Funkcje odczytu plików CSV w IronXL eliminują typowe problemy, zapewniając jednocześnie dodatkowe funkcje, takie jak walidacja danych i kontrola rozmiaru plików.

Jak zainstalować IronXL?

Rozpoczęcie pracy z IronXL wymaga prostej instalacji pakietu NuGet. Otwórz konsolę menedżera pakietów NuGet w Visual Studio i wykonaj:

Install-Package IronXL

Install-Package IronXL

Lub, jeśli wolisz, .NET CLI:

dotnet add package IronXL

dotnet add package IronXL

Po zainstalowaniu dodaj przestrzeń nazw IronXL do swojego projektu:

using IronXL;
using System.Data;

using IronXL;
using System.Data;

Imports IronXL
Imports System.Data

Zapewnia to dostęp do wszystkich funkcji przetwarzania plików CSV bez żadnych zależności od programu Excel. Więcej szczegółów można znaleźć w dokumentacji IronXL oraz w przewodniku instalacji NuGet.

Jak przekonwertować plik CSV na DataTable?

Podstawowy przebieg pracy w IronXL wymaga zaledwie kilku wierszy kodu. Oto jak odczytać plik CSV i przekonwertować go na DataTable przy użyciu instrukcji najwyższego poziomu w C# 10+:

using IronXL;
using System.Data;

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

// Access the default worksheet
WorkSheet worksheet = workbook.DefaultWorkSheet;

// Convert to DataTable with headers
DataTable dataTable = worksheet.ToDataTable(true);

// Display the data
foreach (DataRow row in dataTable.Rows)
{
    foreach (var item in row.ItemArray)
    {
        Console.Write($"{item}\t");
    }
    Console.WriteLine();
}

using IronXL;
using System.Data;

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

// Access the default worksheet
WorkSheet worksheet = workbook.DefaultWorkSheet;

// Convert to DataTable with headers
DataTable dataTable = worksheet.ToDataTable(true);

// Display the data
foreach (DataRow row in dataTable.Rows)
{
    foreach (var item in row.ItemArray)
    {
        Console.Write($"{item}\t");
    }
    Console.WriteLine();
}

Imports IronXL
Imports System.Data

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

' Access the default worksheet
Dim worksheet As WorkSheet = workbook.DefaultWorkSheet

' Convert to DataTable with headers
Dim dataTable As DataTable = worksheet.ToDataTable(True)

' Display the data
For Each row As DataRow In dataTable.Rows
    For Each item In row.ItemArray
        Console.Write($"{item}" & vbTab)
    Next
    Console.WriteLine()
Next

Metoda LoadCSV automatycznie analizuje plik CSV, obsługując pola w cudzysłowie i wbudowane przecinki. Parametr fileFormat informuje IronXL, jak wewnętrznie interpretować dane CSV, zapewniając, że są one traktowane jako struktura zgodna z Excelem. Po załadowaniu metoda ToDataTable(true) konwertuje arkusz na DataTable, przy czym parametr true wskazuje, że pierwszy wiersz powinien służyć jako nagłówki kolumn. Wynikiem tego jest przejrzysty, uporządkowany plik DataTable z nazwanymi kolumnami, które odpowiadają nagłówkom pliku CSV. Aby uzyskać dostęp do bardziej zaawansowanych opcji edycji, zapoznaj się z kompletnym przewodnikiem IronXL.

Proces konwersji zachowuje również typy danych — liczby pozostają liczbami, daty są poprawnie analizowane, a pola tekstowe zachowują swoje formatowanie. To automatyczne wnioskowanie o typach pozwala zaoszczędzić sporo czasu na programowaniu w porównaniu z ręcznym parsowaniem. W przypadku scenariuszy wymagających niestandardowego formatowania danych można zastosować formatowanie komórek przed konwersją.

Jak zaimportować DataTable do SQL Server?

Po uzyskaniu DataTable importowanie go do SQL Servera staje się wydajne dzięki SqlBulkCopy. W poniższym przykładzie wykorzystano instrukcje najwyższego poziomu języka C#:

using System.Data;
using Microsoft.Data.SqlClient;
using IronXL;

// Create connection string
string connectionString = "Data Source=localhost;Initial Catalog=SalesDB;" +
    "Integrated Security=True;TrustServerCertificate=True;";

// Read CSV into DataTable
WorkBook workbook = WorkBook.LoadCSV("inventory_report.csv");
DataTable dataTable = workbook.DefaultWorkSheet.ToDataTable(true);

// Bulk insert into SQL Server
using SqlConnection connection = new SqlConnection(connectionString);
connection.Open();

using SqlBulkCopy bulkCopy = new SqlBulkCopy(connection);

// Set destination table name
bulkCopy.DestinationTableName = "dbo.Inventory";

// Map DataTable columns to SQL table columns
bulkCopy.ColumnMappings.Add("ProductCode", "product_code");
bulkCopy.ColumnMappings.Add("Quantity", "quantity");
bulkCopy.ColumnMappings.Add("LastUpdated", "last_updated");

// Set batch size for better performance
bulkCopy.BatchSize = 1000;

// Write data to SQL Server
bulkCopy.WriteToServer(dataTable);

Console.WriteLine($"Successfully imported {dataTable.Rows.Count} records");

using System.Data;
using Microsoft.Data.SqlClient;
using IronXL;

// Create connection string
string connectionString = "Data Source=localhost;Initial Catalog=SalesDB;" +
    "Integrated Security=True;TrustServerCertificate=True;";

// Read CSV into DataTable
WorkBook workbook = WorkBook.LoadCSV("inventory_report.csv");
DataTable dataTable = workbook.DefaultWorkSheet.ToDataTable(true);

// Bulk insert into SQL Server
using SqlConnection connection = new SqlConnection(connectionString);
connection.Open();

using SqlBulkCopy bulkCopy = new SqlBulkCopy(connection);

// Set destination table name
bulkCopy.DestinationTableName = "dbo.Inventory";

// Map DataTable columns to SQL table columns
bulkCopy.ColumnMappings.Add("ProductCode", "product_code");
bulkCopy.ColumnMappings.Add("Quantity", "quantity");
bulkCopy.ColumnMappings.Add("LastUpdated", "last_updated");

// Set batch size for better performance
bulkCopy.BatchSize = 1000;

// Write data to SQL Server
bulkCopy.WriteToServer(dataTable);

Console.WriteLine($"Successfully imported {dataTable.Rows.Count} records");

Imports System.Data
Imports Microsoft.Data.SqlClient
Imports IronXL

' Create connection string
Dim connectionString As String = "Data Source=localhost;Initial Catalog=SalesDB;" &
    "Integrated Security=True;TrustServerCertificate=True;"

' Read CSV into DataTable
Dim workbook As WorkBook = WorkBook.LoadCSV("inventory_report.csv")
Dim dataTable As DataTable = workbook.DefaultWorkSheet.ToDataTable(True)

' Bulk insert into SQL Server
Using connection As New SqlConnection(connectionString)
    connection.Open()

    Using bulkCopy As New SqlBulkCopy(connection)
        ' Set destination table name
        bulkCopy.DestinationTableName = "dbo.Inventory"

        ' Map DataTable columns to SQL table columns
        bulkCopy.ColumnMappings.Add("ProductCode", "product_code")
        bulkCopy.ColumnMappings.Add("Quantity", "quantity")
        bulkCopy.ColumnMappings.Add("LastUpdated", "last_updated")

        ' Set batch size for better performance
        bulkCopy.BatchSize = 1000

        ' Write data to SQL Server
        bulkCopy.WriteToServer(dataTable)
    End Using
End Using

Console.WriteLine($"Successfully imported {dataTable.Rows.Count} records")

Klasa SqlBulkCopy zapewnia wysoką wydajność podczas importu danych na dużą skalę. Kolekcja ColumnMappings mapuje kolumny DataTable na kolumny bazy danych o różnych nazwach, zapewniając elastyczność schematu danych. Właściwość BatchSize optymalizuje wykorzystanie pamięci poprzez przetwarzanie rekordów w partiach zamiast ładowania wszystkiego naraz. Dowiedz się więcej o możliwościach importu i eksportu IronXL.

Aby zapewnić dodatkową integralność danych, rozważ wdrożenie obsługi transakcji w ramach operacji kopiowania zbiorczego. Gwarantuje to możliwość cofnięcia częściowego importu w przypadku wystąpienia błędów. Można również skorzystać z funkcji tworzenia plików Excel w IronXL w celu wstępnej walidacji danych przed importem.

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

Nie wszystkie pliki CSV używają przecinków. IronXL obsługuje różne separatory, dzięki czemu sprawdza się w przypadku międzynarodowych formatów danych lub starszych systemów:

using IronXL;
using System;
using System.Data;
using System.IO;

// --- Tab-delimited file ---
string tsvPath = "export_data.tsv";
WorkBook tsvWorkbook = WorkBook.LoadCSV(tsvPath, ExcelFileFormat.XLSX, "\t");

// --- Semicolon-delimited file ---
string semiPath = "european_data.csv";
string tempCsv = Path.Combine(Path.GetTempPath(), "european_data_comma.csv");

// Replace semicolons with commas for proper parsing
string[] lines = File.ReadAllLines(semiPath);
for (int i = 0; i < lines.Length; i++)
{
    lines[i] = lines[i].Replace(';', ',');
}
File.WriteAllLines(tempCsv, lines);

WorkBook semiWorkbook = WorkBook.LoadCSV(tempCsv, ExcelFileFormat.XLSX);

// Print tab-delimited results
DataTable tsvTable = tsvWorkbook.DefaultWorkSheet.ToDataTable(true);
Console.WriteLine("--- Tab-delimited File ---");
foreach (DataColumn col in tsvTable.Columns)
    Console.Write($"{col.ColumnName}\t");
Console.WriteLine();
foreach (DataRow row in tsvTable.Rows)
{
    foreach (var item in row.ItemArray)
        Console.Write($"{item}\t");
    Console.WriteLine();
}

// Print semicolon-delimited results
DataTable semiTable = semiWorkbook.DefaultWorkSheet.ToDataTable(true);
Console.WriteLine("\n--- Semicolon-delimited File ---");
foreach (DataColumn col in semiTable.Columns)
    Console.Write($"{col.ColumnName}\t");
Console.WriteLine();
foreach (DataRow row in semiTable.Rows)
{
    foreach (var item in row.ItemArray)
        Console.Write($"{item}\t");
    Console.WriteLine();
}

using IronXL;
using System;
using System.Data;
using System.IO;

// --- Tab-delimited file ---
string tsvPath = "export_data.tsv";
WorkBook tsvWorkbook = WorkBook.LoadCSV(tsvPath, ExcelFileFormat.XLSX, "\t");

// --- Semicolon-delimited file ---
string semiPath = "european_data.csv";
string tempCsv = Path.Combine(Path.GetTempPath(), "european_data_comma.csv");

// Replace semicolons with commas for proper parsing
string[] lines = File.ReadAllLines(semiPath);
for (int i = 0; i < lines.Length; i++)
{
    lines[i] = lines[i].Replace(';', ',');
}
File.WriteAllLines(tempCsv, lines);

WorkBook semiWorkbook = WorkBook.LoadCSV(tempCsv, ExcelFileFormat.XLSX);

// Print tab-delimited results
DataTable tsvTable = tsvWorkbook.DefaultWorkSheet.ToDataTable(true);
Console.WriteLine("--- Tab-delimited File ---");
foreach (DataColumn col in tsvTable.Columns)
    Console.Write($"{col.ColumnName}\t");
Console.WriteLine();
foreach (DataRow row in tsvTable.Rows)
{
    foreach (var item in row.ItemArray)
        Console.Write($"{item}\t");
    Console.WriteLine();
}

// Print semicolon-delimited results
DataTable semiTable = semiWorkbook.DefaultWorkSheet.ToDataTable(true);
Console.WriteLine("\n--- Semicolon-delimited File ---");
foreach (DataColumn col in semiTable.Columns)
    Console.Write($"{col.ColumnName}\t");
Console.WriteLine();
foreach (DataRow row in semiTable.Rows)
{
    foreach (var item in row.ItemArray)
        Console.Write($"{item}\t");
    Console.WriteLine();
}

Imports IronXL
Imports System
Imports System.Data
Imports System.IO

' --- Tab-delimited file ---
Dim tsvPath As String = "export_data.tsv"
Dim tsvWorkbook As WorkBook = WorkBook.LoadCSV(tsvPath, ExcelFileFormat.XLSX, ControlChars.Tab)

' --- Semicolon-delimited file ---
Dim semiPath As String = "european_data.csv"
Dim tempCsv As String = Path.Combine(Path.GetTempPath(), "european_data_comma.csv")

' Replace semicolons with commas for proper parsing
Dim lines As String() = File.ReadAllLines(semiPath)
For i As Integer = 0 To lines.Length - 1
    lines(i) = lines(i).Replace(";"c, ","c)
Next
File.WriteAllLines(tempCsv, lines)

Dim semiWorkbook As WorkBook = WorkBook.LoadCSV(tempCsv, ExcelFileFormat.XLSX)

' Print tab-delimited results
Dim tsvTable As DataTable = tsvWorkbook.DefaultWorkSheet.ToDataTable(True)
Console.WriteLine("--- Tab-delimited File ---")
For Each col As DataColumn In tsvTable.Columns
    Console.Write($"{col.ColumnName}{ControlChars.Tab}")
Next
Console.WriteLine()
For Each row As DataRow In tsvTable.Rows
    For Each item In row.ItemArray
        Console.Write($"{item}{ControlChars.Tab}")
    Next
    Console.WriteLine()
Next

' Print semicolon-delimited results
Dim semiTable As DataTable = semiWorkbook.DefaultWorkSheet.ToDataTable(True)
Console.WriteLine(vbCrLf & "--- Semicolon-delimited File ---")
For Each col As DataColumn In semiTable.Columns
    Console.Write($"{col.ColumnName}{ControlChars.Tab}")
Next
Console.WriteLine()
For Each row As DataRow In semiTable.Rows
    For Each item In row.ItemArray
        Console.Write($"{item}{ControlChars.Tab}")
    Next
    Console.WriteLine()
Next

Ten kod pokazuje ładowanie plików CSV z różnymi separatorami do obiektów IronXL WorkBook. Pliki rozdzielone tabulatorami są odczytywane przy użyciu "\t" jako separatora, natomiast pliki rozdzielone średnikami są konwertowane do standardowego formatu CSV przed załadowaniem. W przypadku bardziej złożonych scenariuszy związanych z formatami plików można również rozważyć eksportowanie danych z Excela do różnych formatów.

Jakie funkcje IronXL są obsługiwane poza CSV?

IronXL oferuje znacznie więcej niż tylko odczyt plików CSV. Biblioteka obsługuje pełen zakres operacji w programie Excel i arkuszach kalkulacyjnych w języku C#, co czyni ją jedyną zależnością dla aplikacji zorientowanych na dane.

Jakie są kolejne kroki?

IronXL sprawia, że importowanie baz danych CSV staje się prostym i niezawodnym procesem. Wystarczy kilka wierszy kodu, aby:

• Odczytuj pliki CSV z dowolnej ścieżki za pomocą funkcji LoadCSV
• Konwersja danych CSV do formatu DataTable z zachowaniem odpowiedniego formatowania danych
• Zachowaj nagłówki kolumn i kolumny DataTable poprzez automatyczne parsowanie
• Efektywne importowanie milionów wierszy do tabeli bazy danych przy użyciu operacji zbiorczych

Biblioteka radzi sobie ze złożonymi procesami analizowania plików CSV, zarządzania pamięcią i konwersji typów danych, pozwalając Ci skupić się na logice biznesowej, a nie na szczegółach przetwarzania plików. Niezależnie od tego, czy tworzysz aplikacje ASP.NET, pracujesz z Blazorem, czy też opracowujesz aplikacje desktopowe .NET 10, IronXL zapewnia spójne i niezawodne przetwarzanie plików CSV na wszystkich platformach.

Gotowi, aby rozpocząć? Dokumentacja IronXL szczegółowo omawia każdą funkcję, a Licencja Trial pozwala na wypróbowanie pełnej biblioteki IronXL.