C# CSVライブラリ: IronXLを使用した完全なチュートリアル

C#のスプレッドシートライブラリはどのように設定すればよいですか？

IronXLのインストールはNuGet経由で1分もかかりません。 Visual Studio のパッケージ マネージャー コンソールを開き、以下のコマンドを実行するか、任意のターミナルから.NET CLI を使用してください。

Install-Package IronXL
dotnet add package IronXL

Install-Package IronXL
dotnet add package IronXL

パッケージのインストール後、スプレッドシートデータを操作したいファイルに名前空間を追加してください。

using IronXL;

using IronXL;

Imports IronXL

IronXLは、 .NET Framework 4.6.2以降およびすべての最新の.NETバージョン（Core、5、6、7、8、9、10）を対象としています。 Windows、Linux、macOSで動作するため、デスクトップツールとコンテナ化されたサーバーワークロードの両方に適しています。 パッケージの入手先やライセンスの有効化に関する手順については、IronXLのインストールガイドをご覧ください。

C#でCSVファイルを読み込むにはどうすればよいですか？

IronXLでCSVファイルを読み込む手順は、他のスプレッドシートを読み込む手順と同じです。 IronXLは拡張子からフォーマットを推測します：

// Load a CSV file into a WorkBook
WorkBook workBook = WorkBook.Load("sales_data.csv");

// Access the default worksheet
WorkSheet workSheet = workBook.DefaultWorkSheet;

// Read individual cells by Excel-style address
string customerName = workSheet["A2"].StringValue;
decimal orderAmount = workSheet["B2"].DecimalValue;

// Iterate rows, starting at index 1 to skip the header
for (int i = 1; i < workSheet.Rows.Count(); i++)
{
    var row = workSheet.Rows[i];
    Console.WriteLine($"Customer: {row.Columns[0].Value}, Amount: {row.Columns[1].Value}");
}

// Load a CSV file into a WorkBook
WorkBook workBook = WorkBook.Load("sales_data.csv");

// Access the default worksheet
WorkSheet workSheet = workBook.DefaultWorkSheet;

// Read individual cells by Excel-style address
string customerName = workSheet["A2"].StringValue;
decimal orderAmount = workSheet["B2"].DecimalValue;

// Iterate rows, starting at index 1 to skip the header
for (int i = 1; i < workSheet.Rows.Count(); i++)
{
    var row = workSheet.Rows[i];
    Console.WriteLine($"Customer: {row.Columns[0].Value}, Amount: {row.Columns[1].Value}");
}

Imports System

' Load a CSV file into a WorkBook
Dim workBook As WorkBook = WorkBook.Load("sales_data.csv")

' Access the default worksheet
Dim workSheet As WorkSheet = workBook.DefaultWorkSheet

' Read individual cells by Excel-style address
Dim customerName As String = workSheet("A2").StringValue
Dim orderAmount As Decimal = workSheet("B2").DecimalValue

' Iterate rows, starting at index 1 to skip the header
For i As Integer = 1 To workSheet.Rows.Count() - 1
    Dim row = workSheet.Rows(i)
    Console.WriteLine($"Customer: {row.Columns(0).Value}, Amount: {row.Columns(1).Value}")
Next

CODE-42675--@@オブジェクトは、完全なスプレッドシートモデルを公開します。 CODE-42676--@@のような使い慣れたExcel記法でセルにアクセスし、組み込みの変換プロパティ--@--CODE-42677--@、@--CODE-42678--@、@--CODE-42679--@、@--CODE-42680--@--で型の強制を処理するので、文字列を手動で解析する必要はありません。

// Access a range and print each value
foreach (var cell in workSheet["A2:C10"])
{
    Console.WriteLine($"{cell.AddressString}: {cell.Value}");
}

// Access a range and print each value
foreach (var cell in workSheet["A2:C10"])
{
    Console.WriteLine($"{cell.AddressString}: {cell.Value}");
}

' Access a range and print each value
For Each cell In workSheet("A2:C10")
    Console.WriteLine($"{cell.AddressString}: {cell.Value}")
Next

public record SalesRecord(string Customer, decimal Amount, DateTime OrderDate);

WorkBook workBook = WorkBook.Load("sales_data.csv");
WorkSheet workSheet = workBook.DefaultWorkSheet;

var records = new List<SalesRecord>();

// Start at row 1 to skip the header row (row 0)
for (int i = 1; i < workSheet.Rows.Count(); i++)
{
    var row = workSheet.Rows[i];
    records.Add(new SalesRecord(
        Customer: row.Columns[0].StringValue,
        Amount: row.Columns[1].DecimalValue,
        OrderDate: row.Columns[2].DateTimeValue
    ));
}

public record SalesRecord(string Customer, decimal Amount, DateTime OrderDate);

WorkBook workBook = WorkBook.Load("sales_data.csv");
WorkSheet workSheet = workBook.DefaultWorkSheet;

var records = new List<SalesRecord>();

// Start at row 1 to skip the header row (row 0)
for (int i = 1; i < workSheet.Rows.Count(); i++)
{
    var row = workSheet.Rows[i];
    records.Add(new SalesRecord(
        Customer: row.Columns[0].StringValue,
        Amount: row.Columns[1].DecimalValue,
        OrderDate: row.Columns[2].DateTimeValue
    ));
}

Imports System
Imports System.Collections.Generic

Public Class SalesRecord
    Public Property Customer As String
    Public Property Amount As Decimal
    Public Property OrderDate As DateTime

    Public Sub New(customer As String, amount As Decimal, orderDate As DateTime)
        Me.Customer = customer
        Me.Amount = amount
        Me.OrderDate = orderDate
    End Sub
End Class

Dim workBook As WorkBook = WorkBook.Load("sales_data.csv")
Dim workSheet As WorkSheet = workBook.DefaultWorkSheet

Dim records As New List(Of SalesRecord)()

' Start at row 1 to skip the header row (row 0)
For i As Integer = 1 To workSheet.Rows.Count() - 1
    Dim row = workSheet.Rows(i)
    records.Add(New SalesRecord(
        Customer:=row.Columns(0).StringValue,
        Amount:=row.Columns(1).DecimalValue,
        OrderDate:=row.Columns(2).DateTimeValue
    ))
Next

C#でCSVファイルを作成する方法を教えてください。

CSVファイルをゼロから作成するには、WorkBookの作成、WorkSheetの入力、SaveAsCsvの呼び出しという3つのステップが必要です。 このプロセスは、一般的なスプレッドシートの作成方法とほぼ同じであるため、出力形式に関わらずAPIの一貫性が保たれます。

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

// Write header row
workSheet["A1"].Value = "Product";
workSheet["B1"].Value = "Quantity";
workSheet["C1"].Value = "Price";

// Write data rows
workSheet["A2"].Value = "Widget A";
workSheet["B2"].Value = 250;
workSheet["C2"].Value = 9.99;

workSheet["A3"].Value = "Gadget B";
workSheet["B3"].Value = 120;
workSheet["C3"].Value = 24.50;

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

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

// Write header row
workSheet["A1"].Value = "Product";
workSheet["B1"].Value = "Quantity";
workSheet["C1"].Value = "Price";

// Write data rows
workSheet["A2"].Value = "Widget A";
workSheet["B2"].Value = 250;
workSheet["C2"].Value = 9.99;

workSheet["A3"].Value = "Gadget B";
workSheet["B3"].Value = 120;
workSheet["C3"].Value = 24.50;

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

' Create a new workbook and worksheet
Dim workBook As WorkBook = WorkBook.Create()
Dim workSheet As WorkSheet = workBook.CreateWorkSheet("inventory")

' Write header row
workSheet("A1").Value = "Product"
workSheet("B1").Value = "Quantity"
workSheet("C1").Value = "Price"

' Write data rows
workSheet("A2").Value = "Widget A"
workSheet("B2").Value = 250
workSheet("C2").Value = 9.99D

workSheet("A3").Value = "Gadget B"
workSheet("B3").Value = 120
workSheet("C3").Value = 24.5D

' Export to CSV
workBook.SaveAsCsv("inventory.csv")

CODE-42686--@@は、区切り文字の配置、カンマを含むフィールドの引用、および改行の正規化を処理します。 それらを手動で管理する必要はありません。 IronXLはエクスポート時に数値型を保持するため、Excelやpandasなどの下流ツールは数値を引用符で囲まれたテキスト文字列としてではなく、数値として読み取ることができます。

DataTable dataTable = GetProductsFromDatabase();

WorkBook workBook = WorkBook.Create();
WorkSheet workSheet = workBook.CreateWorkSheet("products");

workSheet.InsertDataTable(dataTable, "A1");

workBook.SaveAsCsv("products.csv");

DataTable dataTable = GetProductsFromDatabase();

WorkBook workBook = WorkBook.Create();
WorkSheet workSheet = workBook.CreateWorkSheet("products");

workSheet.InsertDataTable(dataTable, "A1");

workBook.SaveAsCsv("products.csv");

IRON VB CONVERTER ERROR developers@ironsoftware.com

C#でCSVとExcelの間で変換するにはどうすればよいですか？

IronXLが提供する最も価値のある機能の1つは、CSV形式とExcel形式間の双方向変換です。 APIは対称的で、Loadはサポートされているフォーマットを読み込み、Saveファミリーのメソッドはターゲットフォーマットに書き込みます：

// Convert CSV to Excel
WorkBook csvWorkBook = WorkBook.Load("data.csv");
csvWorkBook.SaveAs("data.xlsx");

// Convert Excel back to CSV
WorkBook xlsxWorkBook = WorkBook.Load("report.xlsx");
xlsxWorkBook.SaveAsCsv("report.csv");

// Convert CSV to Excel
WorkBook csvWorkBook = WorkBook.Load("data.csv");
csvWorkBook.SaveAs("data.xlsx");

// Convert Excel back to CSV
WorkBook xlsxWorkBook = WorkBook.Load("report.xlsx");
xlsxWorkBook.SaveAsCsv("report.csv");

' Convert CSV to Excel
Dim csvWorkBook As WorkBook = WorkBook.Load("data.csv")
csvWorkBook.SaveAs("data.xlsx")

' Convert Excel back to CSV
Dim xlsxWorkBook As WorkBook = WorkBook.Load("report.xlsx")
xlsxWorkBook.SaveAsCsv("report.csv")

これらの変換によってデータの整合性が維持されます。 数値は数値のまま保持され、日付フィールドは型が維持され、数式の結果は書き込まれる前に計算値に評価されます。 IronXLは、複数シートのExcelファイルをCSVに変換する際、各ワークシートごとに個別のCSVファイルを自動的に作成します。

WorkBook multiSheetWorkBook = WorkBook.Load("quarterly_report.xlsx");

// Produces: quarterly_report.Sheet1.csv, quarterly_report.Sheet2.csv, etc.
multiSheetWorkBook.SaveAsCsv("quarterly_report.csv");

WorkBook multiSheetWorkBook = WorkBook.Load("quarterly_report.xlsx");

// Produces: quarterly_report.Sheet1.csv, quarterly_report.Sheet2.csv, etc.
multiSheetWorkBook.SaveAsCsv("quarterly_report.csv");

Dim multiSheetWorkBook As WorkBook = WorkBook.Load("quarterly_report.xlsx")

' Produces: quarterly_report.Sheet1.csv, quarterly_report.Sheet2.csv, etc.
multiSheetWorkBook.SaveAsCsv("quarterly_report.csv")

この動作は、下流のコンシューマーがファイルごとに1つのトピックを期待するレポートパイプラインにおいて特に役立ちます。CSV書き込みチュートリアルでは、区切り文字の指定やエクスポートに含めるシートの制御など、その他のオプションについても説明しています。

今IronXLを始めましょう。

無料で始める

CSV専用ライブラリが実際のプロジェクトで不十分なのはなぜか？

多くの C# 開発者は、CsvHelper または TextFieldParser（@--CODE-42692--@@） から始めます。 どちらもCSVファイルのみを扱うワークフローに適したツールです。 要件が拡大すると、ギャップが生じる。例えば、関係者がCSVではなくExcelファイルのダウンロードを要求したり、財務部門が数式を保持することを要求したり、セキュリティポリシーでパスワード保護されたファイルを要求したりするケースだ。 その時点で、CSV専用のライブラリを使用すると、2つ目の依存関係を追加し、2つの異なる統合パスを維持する必要が生じます。 統合されたスプレッドシートライブラリがあれば、最初からそのような分断は解消されます。

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

IronXLは、あらゆる.NET 10アプリケーションにおいて、CSVファイルとExcelファイルの読み書き、変換を行うための、一貫性のある単一のAPIを提供します。 主な利点は明確です。Officeへの依存がなく、クロスプラットフォームに対応し、セル値の型付けが厳密に行われ、要件が変更された場合でも、CSVのみのプロジェクトから完全なスプレッドシート機能へと直接移行できます。

さらに深く掘り下げる準備ができたら、現在のプロジェクトに最も関連性の高いトピックから始めましょう。 主にCSVインポートパイプラインを扱う場合、上記で説明した読み込みとマッピングのパターンは、実際のシナリオの大部分に対応できます。 出力要件が異なる場合（例えば、下流のスクリプトにはCSV、エンドユーザーにはXLSXなど）、フォーマット変換のセクションでは、単一のコードベースで両方に対応する方法を示しています。

レポーティングシステムを構築したり、データベースから結果をエクスポートしたりするチームにとって、InsertDataTable@のアプローチはうまくスケールし、行ごとのセル割り当てのパフォーマンスオーバーヘッドを避けることができます。 これにセルのスタイル設定を組み合わせることで、ユーザーが再フォーマットせずにExcelで直接開けるレポートを作成できます。

先に進むには、以下の手順に従ってください。

1.ライブラリをNuGet経由でインストールするには、@--CODE-42696--@@または@--CODE-42697--@@を使用します。

2. IronXL入門ガイドのクイックスタート手順に従って、最初のCSVファイルを読み込みます。
3. 同じプロジェクトで両方の形式が必要な場合は、 CSVからExcelへの変換チュートリアルを使用して形式変換を検討してください。
4. 高度なセル操作、数式サポート、およびスタイル設定については、 IronXLオブジェクトリファレンスのAPIリファレンスを参照してください。
5. IronXLのトライアルライセンスページで無料トライアルを開始してください。クレジットカードは不要で、テクニカルサポートも含まれています。

Iron Softwareの他のツールと併せて検討されている場合は、 IronSoftware製品Suiteには、 IronPDFによるPDF生成、バーコード読み取り、OCRなど、さまざまな機能が含まれており、すべて同じライセンスモデルとサポートチャネルを共有しています。