C# CSVパーサー（ステップバイステップ）チュートリアル

Visual StudioのNuGetパッケージマネージャーを使うべきでしょうか？

NuGetパッケージマネージャーUIはVisual Studioで利用可能で、プロジェクトに直接パッケージをインストールできます。 この方法は、視覚的なインターフェースを好み、インストール前にパッケージの詳細を確認したい開発者にとって特に便利です。 以下のスクリーンショットは、そのファイルを開く方法を示しています。

Access the NuGet Package Manager in Visual Studio by navigating to Tools > NuGet Package Manager > Manage NuGet Packages for Solution

パッケージマネージャーのUIには、 NuGet Webサイトで利用可能なパッケージライブラリの一覧を表示する"参照"機能があります。下のスクリーンショットに示すように"IronXL"と入力すると、 IronXLパッケージが見つかります。 IronXLが提供する関連するExcel操作機能もぜひ活用してみてください。

Visual Studio のNuGetパッケージ マネージャーにIronXl.Excel ライブラリが表示されています。このライブラリを使用すると、開発者は.NETアプリケーションで Excel ファイルの読み取り、生成、編集を行うことができます。 このパッケージは25万ダウンロードを記録し、バージョン2022.9.9454がインストール準備完了として表示されています。

IronXl.Excel パッケージを選択し、 [インストール]ボタンをクリックしてプロジェクトに追加します。 インストールプロセスでは、すべての依存関係が自動的に処理され、 Excel ファイル操作用にプロジェクトが構成されます。

Visual Studioのコマンドラインはどのような場合に使用すべきですか？

Visual Studioメニューで、ツール > NuGetパッケージマネージャー > パッケージマネージャーコンソールをクリックします。 この方法は、コマンドラインインターフェースに慣れている開発者や、ビルドスクリプトでインストールプロセスを自動化する必要がある開発者に好まれます。

Visual Studio でNuGetパッケージ マネージャー コンソールを開いて CSV 解析ライブラリをインストールします

パッケージマネージャーコンソールは画面の下部に表示されます。 以下のコマンドを入力してEnterキーを押してください。 IronXLがインストールされます。 この方法は、特定のバージョンをインストールする必要がある場合や、 AzureまたはAWS環境向けのデプロイスクリプトを操作する場合に特に役立ちます。

Install-Package IronXL.Excel

パッケージ マネージャー コンソールには、 IronXl.Excel バージョン 2022.11.10251 のインストールが成功したことが表示され、パッケージの復元プロセスとNuGetリポジトリからのダウンロード確認が表示されます。

XLSXファイルをCSVファイルに変換するにはどうすればよいですか？

Microsoft Excelを開き、新しいXLSXファイルを作成します。それにいくつかの擬似データを行と列に入力します。 本番環境では、 IronXLを使用してプログラムで Excel ファイルを作成することをお勧めします。 下の画像は、このチュートリアルにおけるすべての変換に使用されるファイルを示しています。

図6：C#でのCSV解析のデモンストレーションに使用される基本的な在庫構造を示すExcelデータのサンプル

ファイルが準備できたら、以下のサンプルコードを書いてプログラムを実行してください。 IronXLは、特殊文字やデータ型の適切な処理を含め、複雑な解析処理をすべて内部的に行います。

using IronXL;

class Program
{
    static void Main()
    {
        // Load the XLSX file into a WorkBook object
        // The Load method automatically detects the file format
        WorkBook wb = WorkBook.Load("test.xlsx");

        // Save the WorkBook as a CSV file
        // This method handles all formatting and conversion automatically
        wb.SaveAsCsv("Parsed CSV.csv");

        // Optional: Save with custom delimiter
        // wb.SaveAsCsv("Parsed CSV.csv", delimiter: ";");
    }
}

using IronXL;

class Program
{
    static void Main()
    {
        // Load the XLSX file into a WorkBook object
        // The Load method automatically detects the file format
        WorkBook wb = WorkBook.Load("test.xlsx");

        // Save the WorkBook as a CSV file
        // This method handles all formatting and conversion automatically
        wb.SaveAsCsv("Parsed CSV.csv");

        // Optional: Save with custom delimiter
        // wb.SaveAsCsv("Parsed CSV.csv", delimiter: ";");
    }
}

実行が完了すると、 "Parsed CSV.csv"という名前の新しいファイルが作成されます。 CSVファイルは、お好みのエディタやリーダーで読み込むことができます。また、 CSVデータをExcelにインポートして、さらに加工することも可能です。 下の画像は、上記のコマンドの出力結果、つまり生成されたCSVデータを示しています。 出力ファイルでは、二重引用符が太字の値を表しています。

SaveAsCsv メソッドによって生成されたCSV出力。変換されたExcelデータがカンマ区切り形式で表示されます。

XLSファイルをCSVファイルに変換する手順は何ですか？

この例では、XLSファイルをCSV形式に変換する方法を見ていきます。 このプロセスはXLSX変換と全く同じであり、IronXLが様々なExcelファイル形式を処理できる汎用性の高さを示しています。

まず、例として使用するXLSファイルを作成し、CSV形式に変換します。 XLSは古いExcel形式ですが、 IronXLは最新の形式と並行してシームレスに処理します。

図 8: 自動計算を含む在庫データ構造を示す Excel ファイルのサンプル。C# CSV ライブラリを使用して解析できます。

次に、以下のコードブロックを実行して、サンプルXLSファイルをCSVファイルに変換します。IronXLは、変換中に数式や計算結果を含むデータの整合性を維持します。

using IronXL;

class Program
{
    static void Main()
    {
        // Load the XLS file into a WorkBook object
        // IronXL automatically handles the older XLS format
        WorkBook wb = WorkBook.Load("XLS.xls");

        // Save the WorkBook as a CSV file
        // All formulas are evaluated and results are exported
        wb.SaveAsCsv("Example2.csv");

        // Optional: Export specific worksheet
        // WorkSheet ws = wb.GetWorkSheet("Sheet1");
        // ws.SaveAsCsv("Example2.csv");
    }
}

using IronXL;

class Program
{
    static void Main()
    {
        // Load the XLS file into a WorkBook object
        // IronXL automatically handles the older XLS format
        WorkBook wb = WorkBook.Load("XLS.xls");

        // Save the WorkBook as a CSV file
        // All formulas are evaluated and results are exported
        wb.SaveAsCsv("Example2.csv");

        // Optional: Export specific worksheet
        // WorkSheet ws = wb.GetWorkSheet("Sheet1");
        // ws.SaveAsCsv("Example2.csv");
    }
}

上記のコードの実行が完了すると、新しいCSVファイルが生成されます。より複雑なシナリオでは、エクスポートする前に特定の範囲を選択したり、データを並べ替えたりする必要があるかもしれません。

WordPad で開かれた CSV ファイルの例には、ヘッダーと複数の製品エントリを含む、適切にフォーマットされたカンマ区切りのデータが表示されています。

TSV形式のファイルからCSVファイルを解析するにはどうすればよいですか？

表計算ソフトは、データベース間でデータを転送するために、TSVファイル(タブ区切り値ファイル)をよく使用します。 TSVファイルは、データ列をタブで区切り、各レコードを別々の行に格納したデータテーブルを保存します。データにCSV解析を妨げる可能性のあるカンマが含まれている場合に特に便利です。

IronXLは、TSV形式からのCSVファイル解析を提供して、より良いデータ管理をサポートします。 変換プロセスは簡単で、データの整合性を常に維持します。

例を始めましょう。 まず、学生データを含むTSVファイルを作成します。

タブ区切りの学生データの例をMicrosoft Wordで表示。名前、メールアドレス、学籍番号、成績の列を持つTSVファイルの構造を示しています。

using IronXL;

class Program
{
    static void Main()
    {
        // Load the TSV file into a WorkBook object
        // IronXL automatically detects tab-separated format
        WorkBook wb = WorkBook.Load("TSV.tsv");

        // Save the WorkBook as a CSV file
        // Tabs are converted to commas automatically
        wb.SaveAsCsv("Example3.csv");

        // Alternative: Load with explicit delimiter specification
        // WorkBook wb = WorkBook.LoadCSV("TSV.tsv", delimiter: "\t");
    }
}

using IronXL;

class Program
{
    static void Main()
    {
        // Load the TSV file into a WorkBook object
        // IronXL automatically detects tab-separated format
        WorkBook wb = WorkBook.Load("TSV.tsv");

        // Save the WorkBook as a CSV file
        // Tabs are converted to commas automatically
        wb.SaveAsCsv("Example3.csv");

        // Alternative: Load with explicit delimiter specification
        // WorkBook wb = WorkBook.LoadCSV("TSV.tsv", delimiter: "\t");
    }
}

以下にCSV形式での出力を示します。 IronXLがタブ区切りの値をカンマ区切りの値に適切に変換しつつ、データ構造を維持している点に注目してください。

WordPad で開かれた CSV ファイルの例には、名前、メールアドレス、学籍番号、成績のフィールドがカンマで区切られた学生レコードが表示されています。**