IronXL を使用した C# CSV 保存

カンマ区切り値の紹介

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

CSVフォーマットについて

CSVファイルの各行は1つのレコードを表し、その行内の各値はカンマで区切られます。 通常、ファイルの最初の行はヘッダーとして機能し、各列の名前が記載されています。 続くすべての行に実際のデータが含まれ、各値はヘッダーの列に対応しています。 この構造により、CSVファイルは、読みやすく、解析しやすいフォーマットで、複雑なデータテーブルを表現することができます。

プロジェクトにIronXLをインストールするには？

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

Install-Package IronXL.Excel

IronXLを使用したC# CSV保存: イメージ1 - インストール

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

インストールが完了したら、usingステートメントを使ってIronXL名前空間をコードファイルに追加してください：

using IronXL;

using IronXL;

Imports IronXL

この単一の名前空間は、スプレッドシートの作成とCSVエクスポート操作に必要なすべてのクラスへのアクセスを提供します。 手動でCSVファイルを書くためにStreamWriterクラスやStringBuilderに依存するアプローチとは異なり、IronXLは適切なCSVフォーマットの複雑さをすべて自動的に処理します。

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

新しいCSVファイルをプログラムで作成するには、ワークブックを作成し、データを入力し、CSV形式で保存するという3つの簡単なステップが必要です。 IronXLの直感的なAPIは使い慣れたExcelのオブジェクト・モデルを反映しており、開発者はコンソール・アプリケーションや.NETプロジェクト・タイプでスプレッドシートの概念で動作するコードを簡単に書くことができます。

従業員オブジェクトのリストをCSVにエクスポートする必要があるシナリオを考えてみましょう。ここに、CSVデータの書き方を示す完全な例があります：

using IronXL;
class Program
{
 public static void Main(string[] args)
 {
  // 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 - output goes to the specified path
  workBook.SaveAsCsv("employees.csv", ",");
 }
}

using IronXL;
class Program
{
 public static void Main(string[] args)
 {
  // 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 - output goes to the specified path
  workBook.SaveAsCsv("employees.csv", ",");
 }
}

Imports IronXL

Class Program
    Public Shared Sub Main(ByVal args As String())
        ' Create a new workbook and worksheet
        Dim workBook As WorkBook = WorkBook.Create()
        Dim sheet As WorkSheet = 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 - output goes to the specified path
        workBook.SaveAsCsv("employees.csv", ",")
    End Sub
End Class

WorkBook.Create()メソッドは、新しいスプレッドシートを完全にメモリ内で初期化し、最後の保存操作まで一時ファイルやディスク I/O を必要としません。 CreateWorkSheet()メソッドは、ワークブックに名前の付いたワークシートを追加します。

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; }
}
// In your program class or method
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; }
}
// In your program class or method
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", ",");

Imports IronXL

' Define the Student class with public string properties
Public Class Student
    Public Property FirstName As String
    Public Property LastName As String
    Public Property Email As String
End Class

' In your program class or method
Dim students As New List(Of Student) From {
    New Student With {.FirstName = "John", .LastName = "Smith", .Email = "john@example.com"},
    New Student With {.FirstName = "Jane", .LastName = "Doe", .Email = "jane@example.com"}
}

Dim workBook As WorkBook = WorkBook.Create()
Dim sheet As WorkSheet = workBook.DefaultWorkSheet

' Add header row
sheet("A1").Value = "FirstName"
sheet("B1").Value = "LastName"
sheet("C1").Value = "Email"

' Use For Each to iterate through the list and write each item
Dim row As Integer = 2
For Each item In students
    sheet($"A{row}").Value = item.FirstName
    sheet($"B{row}").Value = item.LastName
    sheet($"C{row}").Value = item.Email
    row += 1
Next

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

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

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

using IronXL;

// Load an existing Excel file from the specified location
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 from the specified location
WorkBook workBook = WorkBook.Load("Monthly_Report_20251012.xlsx");

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

Imports IronXL

' Load an existing Excel file from the specified location
Dim workBook As 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ファイルを開きます。 この柔軟性により、開発者は、元の形式に関係なく入力ファイルを受け入れる標準化されたエクスポートパイプラインを構築できます。 システムは、ファイル操作を内部的に処理します。

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
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
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");

Imports IronXL

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

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

' Or export a specific worksheet
Dim northRegion As WorkSheet = workBook.GetWorkSheet("North")
northRegion.SaveAsCsv("north_region_sales.csv")

データテーブルをCSVにエクスポートするには?

エンタープライズ アプリケーションでは、データベース クエリ、API レスポンス、またはインメモリ データ処理から生成された DataTable オブジェクトを頻繁に使用します。 IronXLはこれらの.NETデータ構造とファイルエクスポートのギャップを埋め、アプリケーションメモリから共有可能なCSVファイルへの信頼できるパスを提供します。 この方法は、var ライターのアプローチで CSV ファイルを手動で記述したり、新しい StreamWriter を使用するよりも堅牢です。

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 a loop
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 and save to the specified path
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 a loop
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 and save to the specified path
workBook.SaveAsCsv("product_inventory.csv", ",");

Imports IronXL
Imports System.Data

' Create and populate a DataTable with columns
Dim products As New DataTable()
products.Columns.Add("SKU", GetType(String))
products.Columns.Add("ProductName", GetType(String))
products.Columns.Add("Price", GetType(Decimal))
products.Columns.Add("InStock", GetType(Integer))

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

' Create workbook and transfer DataTable contents
Dim workBook As WorkBook = WorkBook.Create()
Dim sheet As WorkSheet = workBook.DefaultWorkSheet

' Add header row from column names
For col As Integer = 0 To products.Columns.Count - 1
    sheet.SetCellValue(0, col, products.Columns(col).ColumnName)
Next

' Add data rows using a loop
For row As Integer = 0 To products.Rows.Count - 1
    For col As Integer = 0 To products.Columns.Count - 1
        sheet.SetCellValue(row + 1, col, products.Rows(row)(col).ToString())
    Next
Next

' Export to CSV and save to the specified path
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", "|");

Imports IronXL

Dim workBook As 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", vbTab)
' Pipe delimiter (used in some data interchange formats)
workBook.SaveAsCsv("output_pipe.csv", "|")

SaveAsCsv()の2番目のパラメータは、区切り文字として任意の文字列を受け入れ、多様なシステムや地域要件との統合のための完全な柔軟性を提供します。 欧州の金融システムではセミコロンで区切られることが多く、北米のシステムではカンマで区切られることが一般的です。

ベストプラクティス

C#でCSVファイルを扱う場合、ベストプラクティスに従うことで、データの正確性、可読性、他のシステムとの互換性を保つことができます。 以下は重要なガイドラインです：

• 一貫した区切り文字：CSVファイルでは、コンマやセミコロンなど、常に一貫性のある区切り文字を使用してください。これにより、データをインポートまたはエクスポートする際の解析エラーを防ぐことができます。
• 特殊な値の引用：データ値にカンマ、引用符、その他の特殊文字が含まれている場合は、CSVデータの整合性を保つために、二重引用符で囲んでください。
• 日付と時刻のフォーマット：混乱を避け、他のアプリケーションとの互換性を確保するために、CSVファイル全体で一貫した日付と時刻の形式を使用してください。
• 値の改行は避ける：改行文字は行構造を乱し、書式の問題を引き起こす可能性があります。
• ライブラリの活用：CsvHelperのようなライブラリを活用して、CSVファイルの読み書きを簡素化しましょう。 CsvHelperは、エスケープ、クォート、カスタム区切り文字など、CSV形式の複雑な機能の多くを処理します。
• ファイルの取り扱い：書き込む前にファイルが存在するかどうかを常にチェックし、例外を潔く処理すること。 usingステートメントを使用して、ファイルストリームが使用後に適切に閉じられ、廃棄されるようにします。

たとえば、Visual Studio で新しいプロジェクトを開始し、CsvHelper NuGet パッケージをインストールして、CsvWriter クラスを使用して CSV ファイルにデータを書き込むことができます。Firstname や Lastname のようなプロパティを持つ Student クラスを定義し、CsvWriterを使って Student オブジェクトのリストを CSV ファイルにエクスポートします。 このアプローチは、ワークフローを合理化するだけでなく、エラーのリスクを低減し、CSVファイルが適切に構造化され、あらゆるアプリケーションで使用できるようにします。

結論

C#でのCSVファイルの作成とエクスポートはIronXLで驚くほど効率的になります。 構造化されたデータを含む新しいファイルの生成から、複雑な複数シートのExcelワークブックの変換まで、ライブラリは、適切なCSVフォーマット、特殊文字のエスケープ、および数式評価の根本的な複雑さを処理する、クリーンで直感的なAPIを提供します。 var streamやvar csv変数やテキスト追加ロジックでカスタムコードを書く必要のある手作業によるアプローチとは異なり、IronXLはプロセス全体を効率化します。

この記事で取り上げる主な方法とテクニックは以下のとおりです：

• メモリ内の新しいスプレッドシートを初期化するためのWorkBook.Create()。
• WorkBook.Load()は、サポートされているあらゆる形式の既存のExcelファイルを開きます。
• SaveAsCsv()は、カスタマイズ可能な区切り文字でデータをエクスポートします。
• GetWorkSheet()を使用して個々のワークシートをエクスポートし、ターゲット変換を行います。
• データベースからCSVへのワークフローのためのDataTable反復パターン
• foreachループを使用したオブジェクトリストのエクスポート

無料トライアルを開始してスプレッドシートの全機能を試すか、ライセンスを購入して本番環境に導入してください。 セルのスタイリング、数式の作成、チャートの生成などの高度なシナリオをカバーするその他の例については、包括的なIronXLドキュメントとコード例ライブラリを参照してください。