C# CSV リーダーとライター: IronXLを使用して CSV ファイルを作成、エクスポート、変換する

CSV 形式とは何ですか? なぜ重要なのですか?

CSV（Comma Separated Values）ファイルは、異なるアプリケーション間で表形式のデータを保存および交換するために最も広く使用されている形式の1つです。 最も単純な形として、CSVファイルは、各行がカンマで区切られた一連の値を含むプレーンテキストファイルです。 このわかりやすい構造により、CSVデータは、さまざまなソフトウェア・システムで簡単に生成、読み取り、処理することができます。

CSV 形式は軽量で人間が読める形式であるため、レポートのエクスポート、データベース間でのデータ転送、分析ツールとの統合によく使用されます。 CSV ファイルの各行は 1 つのレコードを表し、その行内の各値はコンマで区切られます。 通常、ファイルの最初の行はヘッダーとして機能し、各列の名前が記載されています。 続くすべての行に実際のデータが含まれ、各値はヘッダーの列に対応しています。

CSV ファイルの構造を理解すると、区切り文字の選択、文字のエスケープ、エンコードなど、下流のシステムが出力を確実に解析できるかどうかに影響するすべての要素について、より適切な判断を下すことができます。 CSV ファイル形式は RFC 4180 で定義されており、埋め込まれたコンマ、フィールド内の改行文字、引用符で囲まれた文字列値などのエッジ ケースの処理に関するガイダンスが提供されています。

.NETプロジェクトにIronXLをインストールするにはどうすればよいでしょうか?

IronXL を新しいプロジェクトに追加するには、Microsoft for .NETパッケージ マネージャーであるNuGetを使用すると、わずか数秒で完了します。 Visual Studioを開き、NuGet Package Manager Consoleにアクセスして、次のコマンドを実行してください：

Install-Package IronXl.Excel

または、ソリューション・エクスプローラーでプロジェクトを右クリックし、"Manage NuGet Packages "を選択し、"Browse "タブで "IronXL "を検索し、"Install "をクリックします。 IronXL は、 .NET Framework 4.6.2+、. .NET Core、 .NET 5/6/7/8/10をサポートし、外部依存関係や COM 相互運用性の要件なしにあらゆるプラットフォームで実行できます。

インストールしたら、using ステートメントを使用してIronXL名前空間をコード ファイルに追加します。

using IronXL;

using IronXL;

この単一の名前空間は、スプレッドシートの作成とCSVエクスポート操作に必要なすべてのクラスへのアクセスを提供します。 CSV ファイルを手動で書き込むために StreamWriter または StringBuilder に依存するアプローチとは異なり、 IronXL は、特殊文字のエスケープ、データ型の保持、エクスポート前の数式の評価など、適切な CSV 形式の複雑な処理をすべて自動的に処理します。

IronXL のドキュメントでは、セルのスタイル設定、数式の評価、パスワード保護、グラフ生成などの高度な機能を含む、API サーフェス全体が網羅されています。 クイックリファレンスとして、 IronXLサンプルライブラリには、数十の一般的なスプレッドシートシナリオを網羅した、すぐに実行できるコードサンプルが用意されています。

新しい CSV ファイルを最初から作成するにはどうすればよいですか?

プログラムで新しい CSV ファイルを作成するには、ワークブックの作成、データの入力、CSV 形式での保存という 3 つの手順が必要です。 IronXL の API は、使い慣れた Excel オブジェクト モデルを反映しているため、開発者はコンソール アプリケーションや任意 for .NETプロジェクト タイプでスプレッドシートの概念を扱うコードを簡単に記述できます。

従業員レコードのリストをCSVにエクスポートする必要があるシナリオを考えてみましょう。トップレベルのステートメントを使用した完全な例を以下に示します。

using IronXL;

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

// Add header row with column names
sheet["A1"].Value = "EmployeeID";
sheet["B1"].Value = "Name";
sheet["C1"].Value = "Department";
sheet["D1"].Value = "Salary";

// Add employee data rows
sheet["A2"].Value = 1001;
sheet["B2"].Value = "Sarah Johnson";
sheet["C2"].Value = "Engineering";
sheet["D2"].Value = 85000;

sheet["A3"].Value = 1002;
sheet["B3"].Value = "Michael Chen";
sheet["C3"].Value = "Marketing";
sheet["D3"].Value = 72000;

sheet["A4"].Value = 1003;
sheet["B4"].Value = "Emily Rodriguez";
sheet["C4"].Value = "Finance";
sheet["D4"].Value = 91000;

// Save as CSV file
workBook.SaveAsCsv("employees.csv", ",");

using IronXL;

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

// Add header row with column names
sheet["A1"].Value = "EmployeeID";
sheet["B1"].Value = "Name";
sheet["C1"].Value = "Department";
sheet["D1"].Value = "Salary";

// Add employee data rows
sheet["A2"].Value = 1001;
sheet["B2"].Value = "Sarah Johnson";
sheet["C2"].Value = "Engineering";
sheet["D2"].Value = 85000;

sheet["A3"].Value = 1002;
sheet["B3"].Value = "Michael Chen";
sheet["C3"].Value = "Marketing";
sheet["D3"].Value = 72000;

sheet["A4"].Value = 1003;
sheet["B4"].Value = "Emily Rodriguez";
sheet["C4"].Value = "Finance";
sheet["D4"].Value = 91000;

// Save as CSV file
workBook.SaveAsCsv("employees.csv", ",");

WorkBook.Create() メソッドは、新しいスプレッドシートを完全にメモリ内に初期化し、最終的な保存操作まで一時ファイルやディスク入出力を必要としません。 CreateWorkSheet() メソッドは、名前付きワークシートをワークブックに追加します。この名前は、複数シートのワークブックを CSV にエクスポートするときに関係します。

using IronXL;

// Define the Student class with public string properties
public class Student
{
    public string FirstName { get; set; }
    public string LastName { get; set; }
    public string Email { get; set; }
}

// Create sample data
var students = new List<Student>
{
    new Student { FirstName = "John", LastName = "Smith", Email = "john@example.com" },
    new Student { FirstName = "Jane", LastName = "Doe", Email = "jane@example.com" }
};

WorkBook workBook = WorkBook.Create();
WorkSheet sheet = workBook.DefaultWorkSheet;

// Add header row
sheet["A1"].Value = "FirstName";
sheet["B1"].Value = "LastName";
sheet["C1"].Value = "Email";

// Use foreach to iterate through the list and write each item
int row = 2;
foreach (var item in students)
{
    sheet[$"A{row}"].Value = item.FirstName;
    sheet[$"B{row}"].Value = item.LastName;
    sheet[$"C{row}"].Value = item.Email;
    row++;
}

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

using IronXL;

// Define the Student class with public string properties
public class Student
{
    public string FirstName { get; set; }
    public string LastName { get; set; }
    public string Email { get; set; }
}

// Create sample data
var students = new List<Student>
{
    new Student { FirstName = "John", LastName = "Smith", Email = "john@example.com" },
    new Student { FirstName = "Jane", LastName = "Doe", Email = "jane@example.com" }
};

WorkBook workBook = WorkBook.Create();
WorkSheet sheet = workBook.DefaultWorkSheet;

// Add header row
sheet["A1"].Value = "FirstName";
sheet["B1"].Value = "LastName";
sheet["C1"].Value = "Email";

// Use foreach to iterate through the list and write each item
int row = 2;
foreach (var item in students)
{
    sheet[$"A{row}"].Value = item.FirstName;
    sheet[$"B{row}"].Value = item.LastName;
    sheet[$"C{row}"].Value = item.Email;
    row++;
}

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

既存の Excel ファイルを CSV に変換するにはどうすればよいですか?

ExcelスプレッドシートをCSV形式に変換することは、レガシーシステムとの統合、データベースインポートのためのデータ準備、または人間が作成したレポートから機械可読出力を生成する場合によくある要件です。 IronXLはデータの正確性を保ちながら、最小限のコードでこの変換を行います。

using IronXL;

// Load an existing Excel file
WorkBook workBook = WorkBook.Load("Monthly_Report_20251012.xlsx");

// Convert and save as CSV format
workBook.SaveAsCsv("Monthly_Report_20251012.csv");

using IronXL;

// Load an existing Excel file
WorkBook workBook = WorkBook.Load("Monthly_Report_20251012.xlsx");

// Convert and save as CSV format
workBook.SaveAsCsv("Monthly_Report_20251012.csv");

Load() メソッドは、XLSX、XLS、XLSM、さらには既存の CSV または TSV ファイルなど、さまざまな形式の Excel ファイルを開きます。 この柔軟性により、元の形式に関係なく入力ファイルを受け入れる標準化されたエクスポート パイプラインを構築できます。 サポートされている Excel 形式の完全なリストについては、 IronXLドキュメントを参照してください。

using IronXL;

// Load a multi-sheet workbook (e.g., annual sales by region)
WorkBook workBook = WorkBook.Load("annual_sales.xlsx");

// Export all sheets to CSV -- creates separate files for each sheet
workBook.SaveAsCsv("sales_export.csv");
// Output: sales_export.North.csv, sales_export.South.csv, sales_export.East.csv, etc.

// Or export a specific worksheet
WorkSheet northRegion = workBook.GetWorkSheet("North");
northRegion.SaveAsCsv("north_region_sales.csv");

using IronXL;

// Load a multi-sheet workbook (e.g., annual sales by region)
WorkBook workBook = WorkBook.Load("annual_sales.xlsx");

// Export all sheets to CSV -- creates separate files for each sheet
workBook.SaveAsCsv("sales_export.csv");
// Output: sales_export.North.csv, sales_export.South.csv, sales_export.East.csv, etc.

// Or export a specific worksheet
WorkSheet northRegion = workBook.GetWorkSheet("North");
northRegion.SaveAsCsv("north_region_sales.csv");

DataTable を CSV にエクスポートするにはどうすればよいですか?

エンタープライズ アプリケーションは、データベース クエリ、API 応答、またはメモリ内データ処理から生成された DataTable オブジェクトを頻繁に操作します。 IronXLはこれら for .NETデータ構造とファイルエクスポートのギャップを埋め、アプリケーションメモリから共有可能なCSVファイルへの信頼できるパスを提供します。 この方法は、 IronXL が文字のエスケープ、区切り文字の管理、エンコードを自動的に処理するため、StreamWriter を使用して CSV ファイルを手動で書き込むよりも信頼性が高くなります。

using IronXL;
using System.Data;

// Create and populate a DataTable with columns
DataTable products = new DataTable();
products.Columns.Add("SKU", typeof(string));
products.Columns.Add("ProductName", typeof(string));
products.Columns.Add("Price", typeof(decimal));
products.Columns.Add("InStock", typeof(int));

// Add rows of data
products.Rows.Add("SKU-001", "Wireless Mouse", 29.99m, 150);
products.Rows.Add("SKU-002", "Mechanical Keyboard", 89.99m, 75);
products.Rows.Add("SKU-003", "USB-C Hub", 45.99m, 200);

// Create workbook and transfer DataTable contents
WorkBook workBook = WorkBook.Create();
WorkSheet sheet = workBook.DefaultWorkSheet;

// Add header row from column names
for (int col = 0; col < products.Columns.Count; col++)
{
    sheet.SetCellValue(0, col, products.Columns[col].ColumnName);
}

// Add data rows using nested loops
for (int row = 0; row < products.Rows.Count; row++)
{
    for (int col = 0; col < products.Columns.Count; col++)
    {
        sheet.SetCellValue(row + 1, col, products.Rows[row][col].ToString());
    }
}

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

using IronXL;
using System.Data;

// Create and populate a DataTable with columns
DataTable products = new DataTable();
products.Columns.Add("SKU", typeof(string));
products.Columns.Add("ProductName", typeof(string));
products.Columns.Add("Price", typeof(decimal));
products.Columns.Add("InStock", typeof(int));

// Add rows of data
products.Rows.Add("SKU-001", "Wireless Mouse", 29.99m, 150);
products.Rows.Add("SKU-002", "Mechanical Keyboard", 89.99m, 75);
products.Rows.Add("SKU-003", "USB-C Hub", 45.99m, 200);

// Create workbook and transfer DataTable contents
WorkBook workBook = WorkBook.Create();
WorkSheet sheet = workBook.DefaultWorkSheet;

// Add header row from column names
for (int col = 0; col < products.Columns.Count; col++)
{
    sheet.SetCellValue(0, col, products.Columns[col].ColumnName);
}

// Add data rows using nested loops
for (int row = 0; row < products.Rows.Count; row++)
{
    for (int col = 0; col < products.Columns.Count; col++)
    {
        sheet.SetCellValue(row + 1, col, products.Rows[row][col].ToString());
    }
}

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

このパターンは、DataTable 構造を反復処理し、最初に列ヘッダーを転送してから、各データ行を体系的に入力します。 DefaultWorkSheet プロパティを使用すると、新しく作成されたワークブックの最初のワークシートにすばやくアクセスできるため、単純なシナリオでは明示的にワークシートを作成する必要がなくなります。

CSV ファイル内のカスタム区切り文字をどのように処理しますか?

システムや地域によって、必要な区切り文字は異なります。 カンマは多くの国で標準的な区切り文字ですが、ヨーロッパ地域ではセミコロンが好まれることが多く、カンマは数値の小数部の区切り文字として機能します。 タブ区切りファイル(TSV)は、ソースデータにフィールド値内のカンマが含まれている場合によく使用されます。 IronXL の SaveAsCsv() メソッドは、出力の各行を処理するための追加コードを必要とせずに、これらすべてのシナリオに対応します。

using IronXL;

WorkBook workBook = WorkBook.Load("data.xlsx");

// Standard comma delimiter (default format)
workBook.SaveAsCsv("output_comma.csv", ",");

// Semicolon delimiter (common in European systems)
workBook.SaveAsCsv("output_semicolon.csv", ";");

// Tab delimiter (TSV format)
workBook.SaveAsCsv("output_tab.tsv", "\t");

// Pipe delimiter (used in some data interchange formats)
workBook.SaveAsCsv("output_pipe.csv", "|");

using IronXL;

WorkBook workBook = WorkBook.Load("data.xlsx");

// Standard comma delimiter (default format)
workBook.SaveAsCsv("output_comma.csv", ",");

// Semicolon delimiter (common in European systems)
workBook.SaveAsCsv("output_semicolon.csv", ";");

// Tab delimiter (TSV format)
workBook.SaveAsCsv("output_tab.tsv", "\t");

// Pipe delimiter (used in some data interchange formats)
workBook.SaveAsCsv("output_pipe.csv", "|");

SaveAsCsv() の 2 番目のパラメータは、任意の文字列を区切り文字として受け入れ、さまざまなシステムや地域の要件との統合に完全な柔軟性を提供します。 国際配布用のファイルを生成するときは、対象システムのロケールの想定を考慮してください。ヨーロッパの金融システムではセミコロンによる区切りが想定されることが多いですが、北米のシステムでは通常、デフォルトでコンマが使用されます。 CSV の RFC 4180 標準では、解析エラーを防ぐために区切り文字を含む値を引用符で囲む方法が説明されています。

C# での CSV ファイル生成のベスト プラクティスは何ですか?

C# で CSV ファイルを操作する場合、確立されたプラクティスに従うことで、データの正確性と読み取りやすさが維持され、他のシステムとの互換性が確保されます。 次の表は、最も重要な考慮事項をまとめたものです。

基本的な事項に加えて、国際的な視聴者をターゲットとする場合は、明示的にエンコードすることを検討してください。 Microsoft Excel で開かれた CSV ファイルで非 ASCII 文字を正しく表示するには、BOM 付きの UTF-8 が必要になることがよくあります。 数百万行に及ぶ大量のエクスポートの場合は、単一の大きな CSV を書き込むのではなく、データを複数のファイルに分割することを検討してください。これにより、ファイル サイズが管理しやすくなり、生成時と使用時の両方でメモリ負荷が軽減されます。

データ パイプラインを構築するチーム向けに、 IronXL の非同期およびストリーミングのドキュメントでは、ワークブック全体をメモリにロードせずに大規模なデータセットを処理するパターンについて説明しています。 IronXLサンプル ライブラリには、バッチ処理、スケジュールされたエクスポート ジョブ、Entity Framework などの一般的な ORM フレームワークとの統合のための追加パターンが含まれています。

.NETエコシステムの CSV 処理ツールを使用する場合、 IronXL が低レベルのアプローチに比べてどこに適合するかを理解することで、各シナリオに適したツールを選択するのに役立ちます。 Excel を一切使用しない純粋な CSV 生成の場合、手動引用ロジックを備えた StreamWriter で十分な場合があります。 Excel 形式の互換性、数式の評価、リッチ フォーマットなど、あらゆることに関して、 IronXL はより信頼性の高い基盤を提供します。

IronXLで既存の CSV ファイルを読み取るにはどうすればよいでしょうか?

CSV データをアプリケーションに読み込む方法は、他のスプレッドシート形式を読み込む方法と同じです。 IronXL の Load() メソッドは CSV ファイルを認識し、標準のワークブック/ワークシート モデルに解析して、Excel ファイルに使用されるのと同じ API を使用して個々のセルと範囲にアクセスできるようにします。

using IronXL;

// Load an existing CSV file
WorkBook workBook = WorkBook.Load("employees.csv");
WorkSheet sheet = workBook.DefaultWorkSheet;

// Access specific cells by reference
string firstHeader = sheet["A1"].StringValue;

// Iterate through all rows
foreach (var row in sheet.Rows)
{
    foreach (var cell in row)
    {
        Console.Write(cell.StringValue + "\t");
    }
    Console.WriteLine();
}

// Access a range of cells
var nameColumn = sheet["B2:B100"];
foreach (var cell in nameColumn)
{
    Console.WriteLine(cell.StringValue);
}

using IronXL;

// Load an existing CSV file
WorkBook workBook = WorkBook.Load("employees.csv");
WorkSheet sheet = workBook.DefaultWorkSheet;

// Access specific cells by reference
string firstHeader = sheet["A1"].StringValue;

// Iterate through all rows
foreach (var row in sheet.Rows)
{
    foreach (var cell in row)
    {
        Console.Write(cell.StringValue + "\t");
    }
    Console.WriteLine();
}

// Access a range of cells
var nameColumn = sheet["B2:B100"];
foreach (var cell in nameColumn)
{
    Console.WriteLine(cell.StringValue);
}

読み取り操作と書き込み操作の一貫性により、チームはすべてのスプレッドシート関連タスクに対して 1 つの API のみを学習すれば済みます。 CSV ファイルを開くのと同じ WorkBook.Load() メソッドは、XLSX、XLS、XLSM 形式も処理します。これは、複数の形式で入力を受け入れるパイプラインを構築するときに便利です。 IronXLを使用した CSV ファイルの読み取りの詳細については、ドキュメントをご覧ください。

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

このガイドでは、C# でIronXLを使用して CSV ファイルを作成および管理するためのコア パターンについて説明しました。

• WorkBook.Create() メモリ内で新しいスプレッドシートを初期化します
• WorkBook.Load() サポートされている任意の形式で既存の Excel および CSV ファイルを開くため
• SaveAsCsv() カスタマイズ可能な区切り文字を使用してデータをエクスポートします
• 対象を絞った変換のためにGetWorkSheet()を使用して個々のワークシートをエクスポートします
• DataTable データベースから CSV へのワークフローの反復パターン
• foreach ループを使用したオブジェクトリストのエクスポート
• フルレンジアクセスでCSVデータをアプリケーションに読み込む

これらのテクニックを実践するには、 IronXL の無料トライアルを開始して、時間制限なしでスプレッドシートの全機能をテストしてください。 実稼働環境への展開の準備ができたら、 IronXLライセンス オプションを確認して、チームの規模と使用要件に適したプランを見つけてください。

セルのスタイル設定、数式の作成、グラフの生成、パスワード保護などの高度なシナリオをカバーする追加の例については、 IronXL のドキュメントと完全なコード例ライブラリを参照してください。 IronXLチュートリアル シリーズでは、 DataTable のエクスポート、形式の変換、 CSV ファイルへの書き込みなど、より複雑な統合シナリオについて説明します。