メインコンテンツへスキップ
見出し画像
Photo byskomeda

C# で Excel の列順序を調整する

    データ処理やレポート生成の日常開発において、Excelワークシートの列順序を調整し、下流システムのフィールド要件に合わせたり、データ表示構造を最適化したり、複数のレポートの列レイアウトを統一したりする必要がよく発生します。手動でのドラッグ調整はデータ量が少なくファイル数が限られている場合は可能ですが、バッチファイルや自動化フローが関わる場合には、コードによる処理が求められます。

    本記事では、.NETプラットフォーム向けの無償Excel処理ライブラリを用いて、C#コードでExcelの列位置を調整および並べ替えを実行する方法を紹介します。Microsoft Office環境には依存しません。

    無償ライブラリはNuGetパッケージマネージャーから直接 Free Spire.XLS を検索してインストールできます。

    インストール後、コードファイルの先頭に名前空間をインポートします:

    using Spire.Xls;

    基本的な考え方

    Free Spire.XLS には、列順序を一行のコードで再構成するAPIは直接提供されていません。この機能を実現するための一般的なアプローチは以下の通りです:

    1. 一時ワークシートを作成し、対象ワークシートの全データをコピーする

    2. 新しい列順序に従って、一時ワークシートから対象ワークシートへ列を順次コピーする

    3. 一時ワークシートを削除する

    この、バックアップ後に順次上書きする方法により、元のデータと列幅設定を完全に保持できます。


    完全なコード例

    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データを統一された列構造に調整する場合

    あなたへのおすすめ