C# CSV から XLSX: CSV ファイルを Excel 形式に変換する

C# で CSV ファイルを XLSX 形式に変換するにはどうすればよいでしょうか?

コア変換では、CSV ファイルを読み込み、Excel 形式で保存する必要があります。 IronXL は、区切られたソースを解析し、エクスポート可能なワークブックを作成する WorkBook.LoadCSV を提供します。 このメソッドは、ファイル パス、対象の Excel 形式、および区切り文字を受け入れます。

using IronXL;

// Load CSV file and convert to XLSX format
WorkBook workbook = WorkBook.LoadCSV("data.csv", fileFormat: ExcelFileFormat.XLSX, ListDelimiter: ",");

// Access the default worksheet containing CSV data
WorkSheet worksheet = workbook.DefaultWorkSheet;

// Save as Excel XLSX file
workbook.SaveAs("output.xlsx");

using IronXL;

// Load CSV file and convert to XLSX format
WorkBook workbook = WorkBook.LoadCSV("data.csv", fileFormat: ExcelFileFormat.XLSX, ListDelimiter: ",");

// Access the default worksheet containing CSV data
WorkSheet worksheet = workbook.DefaultWorkSheet;

// Save as Excel XLSX file
workbook.SaveAs("output.xlsx");

CSV を Excel 形式に変換する利点は何ですか?

XLSX 形式は、ほとんどのデータ管理シナリオにおいて、プレーン CSV に比べて目に見える利点を提供します。

-複数のワークシート: Excel ファイルは、単一のワークブック内で複数のシートをサポートし、CSV ファイルでは実現できない整理されたデータ ストレージを可能にします。 1 つの XLSX ファイルには、さまざまな期間、地域、またはカテゴリをカバーする数十のワークシートを保存できます。 -数式のサポート: 複雑な計算、集計、条件付きロジックをセルに直接記述します。 Excel の数式はソース データが変更されると自動的に再計算されるため、CSV ファイルを手動で再処理する必要がなくなります。 -ビジュアル チャート: ワークシート データから棒グラフ、折れ線グラフ、円グラフ、その他の視覚化を作成します。 IronXL はAPI を介して直接チャートの作成をサポートしているため、チャートは XLSX ファイルに埋め込まれます。 -セルの書式設定: プロフェッショナルなドキュメントのフォント、色、境界線、数値の書式を制御します。 CSV ファイルには生の値のみが保存されます。 XLSX はデータとともに表示レイヤーを保持します。 -データ検証: セル入力を特定の値または範囲に制限し、エンドユーザーと共有されるファイルでのデータ入力エラーを防止します。 -パスワード保護: ワークシートとワークブックをパスワードで保護し、読み取りと書き込みのアクセスを制御します。これは CSV にはまったくない機能です。

これらの機能により、XLSX 形式は、レポート、ダッシュボード、財務モデル、および生のデータ保存以上のものを必要とするあらゆるアプリケーションの標準的な選択肢になります。

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

IronXLはNuGetパッケージとして配布されます。 Visual Studio のパッケージ マネージャー コンソールからインストールします。

Install-Package IronXl

Install-Package IronXl

または.NET CLIを使用して:

dotnet add package IronXl

dotnet add package IronXl

インストール後、スプレッドシートで動作するファイルに using IronXL; を追加します。 このパッケージは、 .NET Framework 4.6.2 以降、 .NET Core 3.1 以降、 .NET 5 から.NET 10 を対象としており、Windows、Linux、macOS、Docker、Azure のデプロイ環境をサポートしています。

追加のランタイム依存関係や Microsoft Office のインストールは必要ありません。 IronXL は独自のパーサーとライターを使用して XLSX ファイルを読み書きするため、Office をインストールできないサーバー側およびヘッドレス展開に適しています。

変換中に CSV エンコーディングをどのように処理しますか?

多くの CSV ファイルは、非 ASCII 文字を使用するレガシー システム、国際データベース、またはサードパーティのエクスポートから作成されます。 エンコーディングを正しく処理することで、生成される XLSX ファイルに特殊文字や国際テキストがそのまま残ります。

using IronXL;
using System.Text;

// Load CSV with explicit encoding specification
WorkBook workbook = WorkBook.LoadCSV("international-data.csv",
    fileFormat: ExcelFileFormat.XLSX,
    ListDelimiter: ",",
    encoding: Encoding.UTF8);

// Access the worksheet containing the encoded data
WorkSheet sheet = workbook.DefaultWorkSheet;

// Inspect a cell to verify encoding was preserved
string cellValue = sheet["A1"].StringValue;

// Save the converted Excel file
workbook.SaveAs("encoded-output.xlsx");

using IronXL;
using System.Text;

// Load CSV with explicit encoding specification
WorkBook workbook = WorkBook.LoadCSV("international-data.csv",
    fileFormat: ExcelFileFormat.XLSX,
    ListDelimiter: ",",
    encoding: Encoding.UTF8);

// Access the worksheet containing the encoded data
WorkSheet sheet = workbook.DefaultWorkSheet;

// Inspect a cell to verify encoding was preserved
string cellValue = sheet["A1"].StringValue;

// Save the converted Excel file
workbook.SaveAs("encoded-output.xlsx");

CSV 変換後にセルの書式設定を適用するにはどうすればよいですか?

生の CSV データには書式設定情報は含まれません。 XLSX に変換した後、数値形式、フォント、背景色を適用して、スプレッドシートを読みやすくプロフェッショナルなものにします。

using IronXL;
using IronXl.Styles;

// Load CSV data
WorkBook workbook = WorkBook.LoadCSV("sales-report.csv",
    fileFormat: ExcelFileFormat.XLSX,
    ListDelimiter: ",");

WorkSheet sheet = workbook.DefaultWorkSheet;

// Format the header row with bold text and background color
Range headerRow = sheet["A1:Z1"];
headerRow.Style.Font.Bold = true;
headerRow.Style.SetBackgroundColor("#4472C4");
headerRow.Style.Font.Color = "#FFFFFF";

// Apply currency format to a numeric column
Range priceColumn = sheet["C2:C100"];
priceColumn.Style.NumberFormat = "$#,##0.00";

// Auto-fit column widths for readability
sheet.AutoSizeColumn(0);
sheet.AutoSizeColumn(1);
sheet.AutoSizeColumn(2);

workbook.SaveAs("formatted-report.xlsx");

using IronXL;
using IronXl.Styles;

// Load CSV data
WorkBook workbook = WorkBook.LoadCSV("sales-report.csv",
    fileFormat: ExcelFileFormat.XLSX,
    ListDelimiter: ",");

WorkSheet sheet = workbook.DefaultWorkSheet;

// Format the header row with bold text and background color
Range headerRow = sheet["A1:Z1"];
headerRow.Style.Font.Bold = true;
headerRow.Style.SetBackgroundColor("#4472C4");
headerRow.Style.Font.Color = "#FFFFFF";

// Apply currency format to a numeric column
Range priceColumn = sheet["C2:C100"];
priceColumn.Style.NumberFormat = "$#,##0.00";

// Auto-fit column widths for readability
sheet.AutoSizeColumn(0);
sheet.AutoSizeColumn(1);
sheet.AutoSizeColumn(2);

workbook.SaveAs("formatted-report.xlsx");

IronXL は、Excel UI で使用できる書式設定オプションを反映する Style プロパティを通じてセルと範囲のスタイルを公開します。 数値の書式は、Microsoft が文書化した Excel の数値書式構文に従います。 SetBackgroundColor メソッドは 16 進カラー文字列を受け入れるため、生成されたレポートにブランド カラーを簡単に適用できます。 使用可能なスタイル プロパティについては、完全なセル書式設定 API リファレンスを参照してください。

CSV データを変換した後にグラフを追加するにはどうすればよいでしょうか?

Excel ワークブックに CSV データが存在する場合、 IronXLそのデータから直接グラフを作成できます。 チャートは、サーバー上に Microsoft Excel をインストールしなくても、生の数値を視覚的な情報に変換します。

using IronXL;
using IronXl.Drawing.Charts;

// Load CSV and convert to Excel format
WorkBook workbook = WorkBook.LoadCSV("sales-data.csv",
    fileFormat: ExcelFileFormat.XLSX,
    ListDelimiter: ",");

WorkSheet worksheet = workbook.DefaultWorkSheet;

// Create a column chart from the converted CSV data
IChart chart = worksheet.CreateChart(ChartType.Column, 10, 0, 25, 10);

// Add data series from the worksheet ranges
IChartSeries series = chart.AddSeries("A2:A10", "B2:B10");
series.Title = "Monthly Sales";

// Configure chart appearance
chart.SetTitle("Sales Performance");
chart.SetLegendPosition(LegendPosition.Bottom);

// Plot the chart and save the workbook
chart.Plot();
workbook.SaveAs("sales-with-chart.xlsx");

using IronXL;
using IronXl.Drawing.Charts;

// Load CSV and convert to Excel format
WorkBook workbook = WorkBook.LoadCSV("sales-data.csv",
    fileFormat: ExcelFileFormat.XLSX,
    ListDelimiter: ",");

WorkSheet worksheet = workbook.DefaultWorkSheet;

// Create a column chart from the converted CSV data
IChart chart = worksheet.CreateChart(ChartType.Column, 10, 0, 25, 10);

// Add data series from the worksheet ranges
IChartSeries series = chart.AddSeries("A2:A10", "B2:B10");
series.Title = "Monthly Sales";

// Configure chart appearance
chart.SetTitle("Sales Performance");
chart.SetLegendPosition(LegendPosition.Bottom);

// Plot the chart and save the workbook
chart.Plot();
workbook.SaveAs("sales-with-chart.xlsx");

CSV を DataTable に変換し、さらに Excel に変換するにはどうすればよいですか?

エクスポート前にデータ操作が必要なシナリオでは、CSV データを DataTable 経由で変換すると、最大限の柔軟性が得られます。 このアプローチにより、開発者は標準 for .NETデータ アクセス パターンを使用して、変換プロセス中に行をフィルター処理、変換、並べ替え、または検証できます。

using IronXL;
using System.Data;

// Load CSV file into workbook
WorkBook sourceWorkbook = WorkBook.LoadCSV("input.csv",
    fileFormat: ExcelFileFormat.XLSX,
    ListDelimiter: ",");

// Convert worksheet to DataTable for manipulation
DataTable table = sourceWorkbook.DefaultWorkSheet.ToDataTable(true);

// Filter rows -- keep only rows where the third column value is greater than 100
DataRow[] filtered = table.Select("Column3 > 100");
DataTable filteredTable = filtered.Length > 0 ? filtered.CopyToDataTable() : table.Clone();

// Create new workbook from modified data
WorkBook outputWorkbook = WorkBook.Create(ExcelFileFormat.XLSX);
WorkSheet outputSheet = outputWorkbook.CreateWorkSheet("Processed Data");

// Import filtered DataTable back into Excel
outputSheet.LoadFromDataTable(filteredTable, true);

// Save the final XLSX file
outputWorkbook.SaveAs("processed-output.xlsx");

using IronXL;
using System.Data;

// Load CSV file into workbook
WorkBook sourceWorkbook = WorkBook.LoadCSV("input.csv",
    fileFormat: ExcelFileFormat.XLSX,
    ListDelimiter: ",");

// Convert worksheet to DataTable for manipulation
DataTable table = sourceWorkbook.DefaultWorkSheet.ToDataTable(true);

// Filter rows -- keep only rows where the third column value is greater than 100
DataRow[] filtered = table.Select("Column3 > 100");
DataTable filteredTable = filtered.Length > 0 ? filtered.CopyToDataTable() : table.Clone();

// Create new workbook from modified data
WorkBook outputWorkbook = WorkBook.Create(ExcelFileFormat.XLSX);
WorkSheet outputSheet = outputWorkbook.CreateWorkSheet("Processed Data");

// Import filtered DataTable back into Excel
outputSheet.LoadFromDataTable(filteredTable, true);

// Save the final XLSX file
outputWorkbook.SaveAs("processed-output.xlsx");

XLSX ファイルをファイル パスではなくストリームに保存するにはどうすればよいですか?

サーバー側アプリケーションでは、多くの場合、一時ファイルをディスクに書き込むのではなく、Excel ファイルを HTTP 応答に直接配信する必要があります。 IronXL は、この目的のためにワークブックを MemoryStream に保存することをサポートしています。

using IronXL;
using System.IO;

// Load and convert CSV data
WorkBook workbook = WorkBook.LoadCSV("report-data.csv",
    fileFormat: ExcelFileFormat.XLSX,
    ListDelimiter: ",");

WorkSheet sheet = workbook.DefaultWorkSheet;

// Save workbook to a memory stream instead of a file
using MemoryStream stream = new MemoryStream();
workbook.SaveAs(stream);

// Reset stream position for reading
stream.Position = 0;

// The stream is now ready to pass to an HTTP response, upload to cloud storage,
// or attach to an email. For ASP.NET Core:
// return File(stream, "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet", "report.xlsx");

// Write bytes to verify stream contains XLSX data
byte[] xlsxBytes = stream.ToArray();
Console.WriteLine($"Generated XLSX size: {xlsxBytes.Length} bytes");

using IronXL;
using System.IO;

// Load and convert CSV data
WorkBook workbook = WorkBook.LoadCSV("report-data.csv",
    fileFormat: ExcelFileFormat.XLSX,
    ListDelimiter: ",");

WorkSheet sheet = workbook.DefaultWorkSheet;

// Save workbook to a memory stream instead of a file
using MemoryStream stream = new MemoryStream();
workbook.SaveAs(stream);

// Reset stream position for reading
stream.Position = 0;

// The stream is now ready to pass to an HTTP response, upload to cloud storage,
// or attach to an email. For ASP.NET Core:
// return File(stream, "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet", "report.xlsx");

// Write bytes to verify stream contains XLSX data
byte[] xlsxBytes = stream.ToArray();
Console.WriteLine($"Generated XLSX size: {xlsxBytes.Length} bytes");

ストリームに保存すると、ディスクの読み取り/書き込み操作が回避され、一時ファイルをクリーンアップする必要がなくなります。 このパターンは、XLSX がオンデマンドで生成されるASP.NET Coreファイル ダウンロード エンドポイントで広く使用されています。 SaveAs(Stream) オーバーロードは、完全で有効な XLSX アーカイブを任意の書き込み可能なストリーム インスタンスに書き込みます。

変換されたワークブック内の複数のワークシートをどのように操作しますか?

1 つの XLSX ワークブックに複数のワークシートを含めることができます。 CSV ファイルを変換すると、ワークブックにはデフォルトで 1 つのシートが保持されます。 関連データを整理するために、プログラムで追加のシートを作成することができます。

using IronXL;

// Load primary CSV data
WorkBook workbook = WorkBook.LoadCSV("quarterly-data.csv",
    fileFormat: ExcelFileFormat.XLSX,
    ListDelimiter: ",");

// Rename the default sheet created from the CSV
WorkSheet q1Sheet = workbook.DefaultWorkSheet;
q1Sheet.Name = "Q1 Data";

// Create additional worksheets for summary information
WorkSheet summarySheet = workbook.CreateWorkSheet("Summary");

// Write summary headers and formulas
summarySheet["A1"].Value = "Total Records";
summarySheet["B1"].Formula = $"=COUNTA('{q1Sheet.Name}'!A:A)-1";

summarySheet["A2"].Value = "Data Sheet";
summarySheet["B2"].Value = q1Sheet.Name;

// Save the multi-sheet workbook
workbook.SaveAs("multi-sheet-report.xlsx");

using IronXL;

// Load primary CSV data
WorkBook workbook = WorkBook.LoadCSV("quarterly-data.csv",
    fileFormat: ExcelFileFormat.XLSX,
    ListDelimiter: ",");

// Rename the default sheet created from the CSV
WorkSheet q1Sheet = workbook.DefaultWorkSheet;
q1Sheet.Name = "Q1 Data";

// Create additional worksheets for summary information
WorkSheet summarySheet = workbook.CreateWorkSheet("Summary");

// Write summary headers and formulas
summarySheet["A1"].Value = "Total Records";
summarySheet["B1"].Formula = $"=COUNTA('{q1Sheet.Name}'!A:A)-1";

summarySheet["A2"].Value = "Data Sheet";
summarySheet["B2"].Value = q1Sheet.Name;

// Save the multi-sheet workbook
workbook.SaveAs("multi-sheet-report.xlsx");

CreateWorkSheet メソッドは、ワークブックに新しい空のシートを追加します。 シートには、名前または workbook.WorkSheets を介したインデックスでアクセスできます。 シート間の数式参照では、標準の Excel 表記 'SheetName'!CellRef が使用されます。 複数シートの操作の詳細については、 IronXL複数ワークシート ガイドを参照してください。

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

IronXLを使用して C# で CSV ファイルを XLSX に変換するには、わずか数行のコードで、Microsoft Office に依存せずに完全に準拠した Excel ワークブックを作成できます。 上記の例は、基本的な CSV の読み込みと保存から、エンコード処理、セルの書式設定、グラフの作成、DataTable の統合、ストリーム出力、複数シートのワークブックまでの完全なワークフローを網羅しています。

このガイドで説明する主な機能:

• WorkBook.LoadCSV と SaveAs を使用した基本的な CSV から XLSX への変換
• 国際文字セットのエンコーディング仕様
• 変換後にセルと範囲の書式が適用されます
• XLSXファイルに直接埋め込まれたチャート作成
• フィルタリングおよび変換されたデータの DataTable ラウンドトリップ
• サーバー側ファイル配信用のMemoryStream出力
• 単一のCSVソースから複数シートのワークブックを構築

IronXL は、 .NET Framework、 .NET Core、 .NET 5 ～ 10 にわたる Windows、Linux、macOS、Docker、Azure のデプロイメントをサポートしています。さらに詳しい機能については、 IronXLドキュメントを確認したり、 Excel API オブジェクト リファレンスを参照したり、 Excel ファイルの読み取り、セルの結合、数式の適用などのトピックに関するIronXLハウツー ガイドを確認してください。 無料トライアルをダウンロードして開発環境ですべての機能をテストするか、本番環境展開用のライセンスを購入してください。

今IronXLを始めましょう。

無料で始める