
C# で Excel の列順序を調整する
データ処理やレポート生成の日常開発において、Excelワークシートの列順序を調整し、下流システムのフィールド要件に合わせたり、データ表示構造を最適化したり、複数のレポートの列レイアウトを統一したりする必要がよく発生します。手動でのドラッグ調整はデータ量が少なくファイル数が限られている場合は可能ですが、バッチファイルや自動化フローが関わる場合には、コードによる処理が求められます。
本記事では、.NETプラットフォーム向けの無償Excel処理ライブラリを用いて、C#コードでExcelの列位置を調整および並べ替えを実行する方法を紹介します。Microsoft Office環境には依存しません。
無償ライブラリはNuGetパッケージマネージャーから直接 Free Spire.XLS を検索してインストールできます。
インストール後、コードファイルの先頭に名前空間をインポートします:
using Spire.Xls;基本的な考え方
Free Spire.XLS には、列順序を一行のコードで再構成するAPIは直接提供されていません。この機能を実現するための一般的なアプローチは以下の通りです:
一時ワークシートを作成し、対象ワークシートの全データをコピーする
新しい列順序に従って、一時ワークシートから対象ワークシートへ列を順次コピーする
一時ワークシートを削除する
この、バックアップ後に順次上書きする方法により、元のデータと列幅設定を完全に保持できます。
完全なコード例
using System.Linq;
using Spire.Xls;
namespace ReorderExcelColumns
{
class Program
{
static void Main(string[] args)
{
// 1. Workbookオブジェクトを作成し、Excelファイルを読み込む
Workbook workbook = new Workbook();
workbook.LoadFromFile(@"C:\sample.xlsx");
// 2. 最初のワークシートを取得
Worksheet worksheet = workbook.Worksheets[0];
// 3. 新しい列順序を定義(インデックスは0始まり)
// 例:元の4列目(インデックス3)を1列目に移動し、元の1~3列目を順次後ろにずらす
int[] newColumnOrder = new int[] { 3, 0, 1, 2, 4, 5 };
// 4. 一時ワークシートを作成し、データをコピー
Worksheet tempSheet = workbook.Worksheets.Add("temp");
tempSheet.CopyFrom(worksheet);
// 5. 新しい順序に従って一時ワークシートから対象ワークシートへ列をコピー
for (int i = 0; i < newColumnOrder.Length; i++)
{
tempSheet.Columns[newColumnOrder[i]].Copy(
worksheet.Columns[i],
true, // 値をコピー
true // 書式をコピー
);
// 6. 列幅を同期
worksheet.Columns[i].ColumnWidth =
tempSheet.Columns[newColumnOrder[i]].ColumnWidth;
}
// 7. 一時ワークシートを削除
workbook.Worksheets.Remove(tempSheet);
// 8. ワークブックを保存
workbook.SaveToFile("Reordered.xlsx", FileFormat.Version2016);
}
}
}主要APIの説明
Workbook.LoadFromFile():既存のExcelファイルを読み込む
Workbook.Worksheets.Add():新しいワークシートを追加する
Worksheet.CopyFrom():コピー元ワークシートの全データをコピー先ワークシートにコピーする
Worksheet.Columns[index].Copy():指定列をコピー先位置にコピーし、値と書式を同時にコピー可能
Worksheet.Columns[index].ColumnWidth:列幅を取得または設定する
Workbook.SaveToFile():ワークブックを保存する
適用シナリオ
表構造の一括整理:多数のExcelファイルに対して同じ列順序調整を実行する必要がある場合
データ表示の最適化:重要なフィールド(日付やIDなど)を前に配置し、可読性を向上させる場合
自動レポート生成:データエクスポートやレポート生成プロセスにおいて列順序を統一する場合
データ移行・統合:異なるソースからのExcelデータを統一された列構造に調整する場合