HOWTO · Csharp

C# で Excel ファイルにデータをエクスポートする方法

C# のオブジェクトコレクション、配列、DataTable、JSON レコードを Excel ブックに出力する方法を比較します。

このページの内容

入力データの形に合った方法を選びます。オブジェクトコレクションをワークシートにマッピングする方法、2次元配列をセルに配置する方法、列名を含む DataTable を書き込む方法、JSON レコードをデシリアライズして各フィールドを割り当てる方法があります。以下では、それぞれで想定するブックの構成を説明します。ライブラリ固有のコード片は未検証の例です。対象フレームワーク、パッケージのバージョン、実行結果は提示されていません。利用する前に、ベンダーの最新ドキュメントで互換性、API のシグネチャ、ライセンス条件を確認してください。

C# でデータを Excel にエクスポートする

学生のようなレコードを出力する場合は、列にしたい値を公開するプロパティを持つオブジェクトのコレクションを用意します。たとえば、各 Student に name プロパティと数値の marks プロパティを持たせます。ワークシートでは1行を1人の学生に対応させ、2つのフィールドを示す見出し行を設けます。アプリケーションですでに型付きレコードを扱っており、そのプロパティをシートに反映したい場合に適したデータ形状です。

元の例では ExcelMapper と NuGet パッケージ ExcelMapper が挙げられています。これは調査対象のライブラリ候補として扱い、検証済みのセットアップ手順とは見なさないでください。現在のインストール方法、コレクションのマッピング方法、ShaniData のようなワークシートの選択方法、.xlsx ファイルの保存方法は、パッケージのベンダードキュメントで確認してください。ブックには書き込み可能な出力パスを指定します。想定される結果は学生の名前と点数を含むシートですが、ここでは出力ブックもスクリーンショットも検証していません。

C# で配列から Excel にデータをエクスポートする

値がすでに矩形の表になっている場合は、2次元配列を使えます。最初の行に Name、City、Gpa、Language などのフィールド名を置き、その後の各行に1件ずつレコードを置きます。各行の値の数を揃えると、それぞれの値を意図した見出しの下に配置できます。

提示された例では Spire.Xls を使い、ShaniArray というワークシートを作成して、行と列の引数に 2 と 1 を指定して InsertArray を呼び出しています。これはワークシートの2行目、1列目を開始位置とする意図を示しますが、実際に利用する前に、現在のドキュメントで API のインデックス規則を確認してください。配列に見出し行が含まれるため、2行目から開始すると、ワークシートの1行目を別のタイトル用または空白行として残せます。元の例ではパッケージの見出しが ExcelMapper となっていましたが、コード内の参照は Spire.Xls であり一致していません。選択したパッケージに対応するドキュメントを参照してください。意図しているのは、見出しとレコードの表を Excel ブックとして保存することです。

C# で DataTable から Excel にデータをエクスポートする

列名と行が .NET の表形式データモデルですでに表現されている場合は、DataTable を使います。Roll Number、Student Name、Section などの列を定義し、学生ごとに DataRow を追加します。ワークシートでは、1行目に列名を表示し、その下にテーブルの値を並べます。各行に定義済みの各列の値が含まれていることを確認してください。

記事中の例は Spire.Xls を参照し、列名を含めてテーブルを挿入する意図です。一方、パッケージの説明では誤って ExcelMapper と記載されていました。選択したライブラリに合うパッケージと、現在のテーブル挿入 API をドキュメントで確認してください。挿入時の引数と保存処理はここでは検証していないため、利用するバージョンにおける意味、ワークシート上の座標、出力パスを確認します。クエリや既存のアプリケーション処理がすでに DataTable を生成しており、名前付きの列をブックに保持したい場合に便利です。

C# で JSON から Excel にデータをエクスポートする

サンプルデータは JSON ファイルではなく、コード内に記述された JSON 文字列です。Name、Roll、GPA、Fyp の各フィールドを持つ、番号付きの学生レコードが含まれています。この文字列を学生オブジェクトのコレクションまたは辞書にデシリアライズし、Student Name、Roll No、GPA、FYP などのワークシート列に各フィールドを割り当てます。JSON ファイルを使う場合は、デシリアライズの前にファイルを読み込む処理が別途必要ですが、この例には含まれていません。

元の例では、デシリアライズに Newtonsoft.Json、ブックの作成に GemBox.Spreadsheet を指定しています。それぞれの役割を分けて考えてください。選択した表計算ライブラリでブックを初期化し、ShaniJSON ワークシートを作成して見出しを書き込み、その下に各レコードを追加してファイルを保存する流れを想定しています。元のマッピングでは、JSON キー Name を C# の Fname プロパティに対応させています。実際に使うプロパティ名に合わせて、シリアライザーの設定を確認してください。また、元の例では Workbook と ExcelFile が混在しているため、互換性のない断片を組み合わせず、現在の GemBox ドキュメントでブックの型と保存メソッドを確認してください。ライセンス条件と、JSON パッケージがプロジェクトに対応しているかも確認します。コンパイル、実行結果、生成されたブックを確認したという主張はありません。