C#でCSVファイルをDataTableに読み込む方法

CSVからDataTableへの変換が重要な理由は何ですか？

CSV から DataTable への変換により、開発者はカンマ区切りの値を構造化されたオブジェクトに変換して、さらに処理することができます。 在庫データ、顧客記録、トランザクションログのいずれを扱う場合でも、CSV を DataTable に効率的に変換することは非常に重要です。 最初の行を列ヘッダーとして使用することで、DataTableの列がデータベースのテーブルスキーマと一致するようにすることができ、 ExcelからSQLへの操作に最適です。

従来のアプローチは、しばしば大きなファイル、異なる区切り文字、またはメモリ管理に苦慮します。 IronXLはこれらの課題を解消し、追加のコードなしでさまざまな区切り文字、引用符付きフィールド、埋め込みカンマを処理します。 IronXLのCSV読み込み機能は、よくある問題点を解消するだけでなく、データ検証やファイルサイズ制御といった追加機能も提供します。

IronXLのインストール方法を教えてください

IronXLを使い始めるには、簡単なNuGetパッケージのインストールが必要です。 Visual Studio でNuGetパッケージ マネージャー コンソールを開き、次のいずれかのコマンドを実行します。

Install-Package IronXL

Install-Package IronXL

または、 .NET CLI をご希望の場合は、以下の手順に従ってください。

dotnet add package IronXL

dotnet add package IronXL

インストールが完了したら、IronXL名前空間をプロジェクトに追加します：

using IronXL;
using System.Data;

using IronXL;
using System.Data;

これにより、Excelに依存することなく、すべてのCSV処理機能にアクセスできます。 詳細については、 IronXLのドキュメントおよびNuGetインストールガイドを参照してください。

インストールが成功したことを確認するにはどうすればよいですか？

インストールを確認するために、CSVファイルを読み込むテストプログラムを作成してください。 ライセンスに関するメッセージが表示された場合は、ライセンスキーを取得する必要があります。 プロジェクトファイル内のパッケージ参照を確認し、 IronXLが正しいバージョンで指定されていることを確認してください。 基本的なCSVファイルの読み込み操作を実行してください。エラーなく完了すれば、インストールは正しく動作しています。

購入の準備ができていませんか？

PM >  Install-Package IronXL.Excel

IronXL を NuGet でチェックしてください。1000万回以上のダウンロードで、C#によるPDF開発を変革しています。 また、DLLをダウンロードできます。

CSVファイルをDataTableに変換するにはどうすればよいですか？

IronXLのコアワークフローは、わずか数行のコードで構成されています。 C# 10以降でトップレベルのステートメントを使用してCSVファイルを読み込み、DataTableに変換する方法は次のとおりです。

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();
}

LoadCSV メソッドは、引用符で囲まれたフィールドや埋め込まれたカンマを処理しながら、CSV ファイルを自動的に解析します。 fileFormat パラメータは、 IronXL がCSV データを内部的にどのように解釈するかを指示し、Excel と互換性のある構造として扱われるようにします。 読み込まれると、ToDataTable(true) メソッドはワークシートを DataTable に変換し、パラメーター true は最初の行を列ヘッダーとして使用することを示します。 これにより、CSV ヘッダーと一致する名前付き列を持つ、クリーンで構造化された DataTable が作成されます。 より高度な操作オプションについては、 IronXLの完全版ハウツーガイドをご覧ください。

変換プロセスではデータ型も保持されます。数値は数値のまま保持され、日付は正しく解析され、テキストフィールドは書式が維持されます。 この自動型推論は、手動による構文解析手法と比較して、開発時間を大幅に節約します。 カスタムデータ書式設定が必要なシナリオでは、変換前にセル書式設定を適用できます。

DataTable を SQL Server にインポートするにはどうすればよいですか？

DataTable を取得したら、SqlBulkCopy を使用して SQL Server にインポートするのが効率的になります。 次の例では、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");

SqlBulkCopy クラスは、大規模なデータインポートに対して優れたパフォーマンスを提供します。 ColumnMappings コレクションは、DataTable 列を異なる名前のデータベース列にマッピングし、データスキーマの柔軟性を確保します。 BatchSize プロパティは、レコードを一度にすべて読み込むのではなく、チャンク単位で処理することでメモリ使用量を最適化します。 IronXLのインポートおよびエクスポート機能について詳しくはこちらをご覧ください。

データの整合性をさらに高めるために、大量コピー操作にトランザクションサポートを導入することを検討してください。 これにより、エラーが発生した場合に部分的なインポートをロールバックできることが保証されます。 IronXLのExcelファイル書き込み機能を使用すれば、インポート前にデータを事前検証することもできます。

ここでは、SSMS でクエリ SELECT * FROM dbo.Inventory; を使用して、CSV データが SQL Server にインポートされたことを確認できます。 まず、サンプルCSVファイルで使用されているデータを見てみましょう。

さて、クエリの出力を見ると、すべての列、ヘッダー、行がデータベーステーブルに正常にコピーされたことがわかります。

CSVファイルの様々な区切り文字はどのように処理しますか？

すべてのCSVファイルがカンマを使用するわけではありません。 IronXLは様々な区切り文字に対応しているため、国際的なデータ形式やレガシーシステムにも実用的です。 次の例は、タブ区切りファイルとセミコロン区切りファイルの読み込み方法を示しています。

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();
}

このコードは、異なる区切り文字を持つ CSV ファイルをIronXL WorkBook オブジェクトに読み込む方法を示しています。 タブ区切りのファイルは、区切り文字として""\t""を使用して読み込まれますが、セミコロン区切りのファイルは、読み込む前に標準のCSV形式に変換されます。 各ワークブックの既定のワークシートは、最初の行を列ヘッダーとして使用する ToDataTable(true) を含む DataTable に変換されます。 より複雑なファイル形式のシナリオでは、 Excelデータをさまざまな形式にエクスポートすることも検討できます。

さまざまな区切り文字に対応できる柔軟性により、実際のCSV解析における多くの課題を解決できます。 IronXLは、ヨーロッパのデータ形式を扱う際に、データフォーマット規格における地域的な違いに対応する区切り文字処理機能を備えています。 構造が不整合なファイルの場合は、LoadCSV に渡す前に、生のテキストを前処理してください。

RFC 4180規格は、 IronXLが引用符付きフィールドと埋め込みカンマに関して従うCSVフォーマット仕様を定義しています。 この柔軟性については、 Stack Overflow の" .NETで CSV を DataTable に読み込む"というコミュニティ スレッドでも詳しく説明されています。

CSV以外に、 IronXLでサポートされている機能は何ですか？

IronXLはCSVファイルの読み込み以外にも多くの機能を備えています。 このライブラリは、C# で Excel およびスプレッドシートのあらゆる操作を処理するため、データ中心のアプリケーションにとって単一の依存関係で済みます。

次のステップは何ですか?

IronXLは、CSVデータベースのインポートを、シンプルで信頼性の高いプロセスへと変革します。 ほんの数行のコードで、次のことができます：

• LoadCSV機能を使用して、任意のファイルパスからCSVファイルを読み込む
• CSVデータを適切なデータフォーマットでDataTableに変換する
• 自動解析により列ヘッダーとデータテーブルの列を保持する バルク操作を使用して、数百万行のデータを効率的にデータベーステーブルにインポートします。

このライブラリは、CSVの解析、メモリ管理、データ型変換といった複雑な処理を担うため、ファイル処理の詳細ではなく、ビジネスロジックに集中できます。 ASP.NETアプリケーションの構築、 Blazorの使用、 .NET 10デスクトップアプリの開発など、どのような場合でも、 IronXLはすべてのプラットフォームで一貫性のある信頼性の高いCSV処理を提供します。

始める準備はできましたか？ IronXLのドキュメントにはすべての機能が詳細に解説されており、試用版ライセンスでライブラリ全体を評価できます。 豊富なコード例と分かりやすいAPIリファレンスにより、 .NET 10アプリケーションでCSVファイルを効率的に処理できるようになります。