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にアクセスして、次のコマンドを実行してください： ```shell :ProductInstall ``` [IronXLを使用したC# CSV保存: イメージ1 - インストール](/static-assets/excel/blog/csharp-csv-reader/csharp-csv-reader-1.webp) または、ソリューション・エクスプローラーでプロジェクトを右クリックし、"Manage NuGet Packages "を選択し、"Browse "タブで "IronXL "を検索し、"Install "をクリックします。 IronXLは[.NET Framework 4.6.2+, .NET Core, .NET 5/6/7/8](/csharp/excel/docs/) をサポートし、外部依存やCOM相互接続の要件なしにあらゆるプラットフォームで動作します。 インストールが完了したら、`using`ステートメントを使ってIronXL名前空間をコードファイルに追加してください： ```cs using IronXL; ``` この単一の名前空間は、スプレッドシートの作成とCSVエクスポート操作に必要なすべてのクラスへのアクセスを提供します。 手動でCSVファイルを書くために`StreamWriter`クラスや`StringBuilder`に依存するアプローチとは異なり、IronXLは適切なCSVフォーマットの複雑さをすべて自動的に処理します。 ## 新しい CSV ファイルをゼロから作成するにはどうすればよいですか? 新しいCSVファイルをプログラムで作成するには、ワークブックを作成し、データを入力し、CSV形式で保存するという3つの簡単なステップが必要です。 IronXLの直感的なAPIは使い慣れたExcelのオブジェクト・モデルを反映しており、開発者はコンソール・アプリケーションや.NETプロジェクト・タイプでスプレッドシートの概念で動作するコードを簡単に書くことができます。 従業員オブジェクトのリストをCSVにエクスポートする必要があるシナリオを考えてみましょう。ここに、CSVデータの書き方を示す完全な例があります： ```cs 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", ","); } } ``` `WorkBook.Create()`メソッドは、新しいスプレッドシートを完全にメモリ内で初期化し、最後の保存操作まで一時ファイルやディスク I/O を必要としません。 `CreateWorkSheet()`メソッドは、ワークブックに名前の付いたワークシートを追加します。 ### 出力 [IronXLを使用してCSVに保存するC#: 画像2 - CSV出力](/static-assets/excel/blog/csharp-csv-reader/csharp-csv-reader-2.webp) { 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", ","); ``` このパターンは、各項目を繰り返し処理し、そのプロパティを特定の列にマッピングすることによって、リスト・オブジェクトを CSV データにエクスポートする方法を示します。 `foreach`ループはコレクション内の各生徒を処理し、文字列補間は動的にセル参照を構築します。 ## 既存のExcelファイルをCSVに変換するにはどうすればよいですか? ExcelスプレッドシートをCSV形式に変換することは、レガシーシステムとの統合、データベースインポートのためのデータ準備、または人間が作成したレポートから機械可読出力を生成する場合によくある要件です。 IronXLはデータの正確性を保ちながら、最小限のコードでこの変換を行います。 ファイルはディスク上に存在し、直接読み込むことができます。 ```cs 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"); ``` `Load()`メソッドは、XLSX、XLS、XLSM、さらには既存のCSVファイルやTSVファイルなど、さまざまな形式のExcelファイルを開きます。 この柔軟性により、開発者は、元の形式に関係なく入力ファイルを受け入れる標準化されたエクスポートパイプラインを構築できます。 システムは、ファイル操作を内部的に処理します。 ### 入力 [IronXLを使用してCSVに保存するC#: 画像3 - Excel入力のサンプル](/static-assets/excel/blog/csharp-csv-reader/csharp-csv-reader-3.webp)DataTable オブジェクトを頻繁に使用します。 IronXLはこれらの.NETデータ構造とファイルエクスポートのギャップを埋め、アプリケーションメモリから共有可能なCSVファイルへの信頼できるパスを提供します。 この方法は、`var` ライターのアプローチで CSV ファイルを手動で記述したり、新しい `StreamWriter` を使用するよりも堅牢です。 ```cs 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", ","); ``` このパターンは、`DataTable` 構造を繰り返し、最初に列のヘッダーを転送し、次に各データ行に体系的にデータを入力します。 `DefaultWorkSheet`プロパティは、新しく作成されたワークブックの最初のワークシートへの素早いアクセスを提供し、単純なシナリオでは明示的なワークシート作成の必要性を排除します。 デフォルトでは、このメソッドはすべての行を順番に処理します。 ### 出力 [IronXLを使用したC# CSVへの保存: イメージ5 - データテーブルからCSVへの出力](/static-assets/excel/blog/csharp-csv-reader/csharp-csv-reader-5.webp). IronXLはデータ転送の過程でデータ型を保持し、数値の精度と日付の書式を維持します。 このアプローチは、[DataTables of any size](/csharp/excel/how-to/csharp-datatable-to-csv/)（単純なルックアップクエリによる数十行から、包括的なデータエクスポートによる数千レコードまで）にも適しています。 エクスポートする前のスプレッドシートの追加操作については、セルの書式オプションと[範囲操作](/csharp/excel/tutorials/how-to-read-excel-file-csharp/)を調べてください。 ## CSVファイルでカスタムデリミタを扱うにはどうすればよいですか? システムや地域によって、必要な区切り文字は異なります。 カンマは多くの国で標準的な区切り文字ですが、ヨーロッパ地域ではセミコロンが好まれることが多く、カンマは数値の小数部の区切り文字として機能します。 タブ区切りファイル（TSV）は、ソースデータにフィールド値内のカンマが含まれている場合によく使用されます。 IronXLの`SaveAsCsv()`メソッドは、出力の各行を処理するためのコードを追加することなく、これらすべてのシナリオに対応します。 ```cs 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番目のパラメータは、区切り文字として任意の文字列を受け入れ、多様なシステムや地域要件との統合のための完全な柔軟性を提供します。 欧州の金融システムではセミコロンで区切られることが多く、北米のシステムではカンマで区切られることが一般的です。 ## ベストプラクティス 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`ループを使用したオブジェクトリストのエクスポート [無料トライアルを開始](trial-license)してスプレッドシートの全機能を試すか、[ライセンスを購入](/csharp/excel/licensing/)して本番環境に導入してください。 セルのスタイリング、数式の作成、チャートの生成などの高度なシナリオをカバーするその他の例については、包括的な[IronXLドキュメント](/csharp/excel/docs/)と[コード例](/csharp/excel/examples/convert-excel-spreadsheet/)ライブラリを参照してください。