この記事の目的
既存の ReoGrid V3 ユーザーから、同じ質問を繰り返し頂きます。
「V3 の DLL を V4 の DLL に差し替えてリビルドするだけで動きますか?」
結論から言えば 「いくつかのコード修正が必要で、その対応は機械的に進められる」 です。V4 では一部のクラス名変更、いくつかの例外型の削除、データバインディング・フィルタ API の整理が入っています。旧名は [Obsolete] として残すのではなく完全に削除しています。ほとんどのプロジェクトは、置換とちょっとした構造修正で移行できます。
完全な移行ガイドはドキュメントとして公開しています。
本記事は、その 90 秒で読める要約版です。
コンパイル時に問題になる箇所
V3 のコードがそのままでは引っかかる、リネーム・削除の 7 カテゴリです。
- アクション基底クラス —
BaseWorksheetAction→WorksheetAction - アウトライン型 —
ReoGridOutline→BaseOutline、IReoGridOutline→IOutline - ヘッダー型 —
ReoGridHeader→WorksheetHeader - ドロップダウン階層 —
DropdownListCellは新設のDropdownListBaseCellを継承する形に変更 - 数式系例外の削除 —
FormulaEvalutionException、FormulaNoNameException、FormulaParameterMismatchException、FormulaTypeMismatchExceptionは廃止。代わりにCell.FormulaStatusを確認します - 検証メソッドのリネーム —
RangePosition.IsValidAddress→IsValidAddressFormat(V4.3.0) ConditionalStyleApplyCellsの削除 —Cell.HasConditionalStylesまたはWorksheet.HasConditionalStyle(...)を使用してください(V4.4)
中核 API である Workbook、Worksheet、Cell、RangePosition、CellPosition、WorksheetRangeStyle は V3 と同じです。
実行時に変化する箇所(コンパイルは通るが挙動が違う)
これらは Excel との挙動を揃えるための改善です。多くのケースでは新しい挙動の方が期待に沿いますが、念のため把握しておきましょう。
- ソート時に数式が行と一緒に動く。V3 はデータのみを並べ替えていましたが、V4 では数式が行に追従します(Excel と同じ動作)。
- 条件付き書式の評価タイミングが描画時に変更。V3 に比べ、大きなシートで圧倒的に速くなりました。
- Excel 互換の数式パース。単項プラス(
=+D25-...)、括弧を含む引用符付きシート名参照('BS(USD)'!B3)、IF(0, ...)が FALSE 分岐を評価する挙動、=A1/0が#DIV/0!を返す挙動など、Excel と揃いました。 - 文字列の乗算が強制変換される。
="10"*2はエラーではなく20を返します。 - VLOOKUP / HLOOKUP / MATCH / XMATCH / XLOOKUP を実装しました。
採用を検討したい新 API
V3 のコードが V4 でクリーンにコンパイルされたら、次は V4 固有の機能を活用しましょう。特に導入価値の高いものを挙げます。
- 遅延読み込み: 数百万行のデータセットを
Worksheet.AddDataSource(...)とDataSourceLoadMode.LazyLoadingで扱う - 複数行の列ヘッダー:
Worksheet.ExtensionColumnHeader - 条件付き書式:
Ruleクラス - 条件付きフィルタ:
ConditionalDataFilter - 3 段階のセルロック: 新設の
CellLock列挙体 - ワークブック全体のハイライト検索:
HighlightTextSearchSession - Excel 互換のカスタム数値書式(例:
"#,##0;[Red]-#,##0") - WinAppDriver による UI 自動化:
ReoGridControl.EnableUIAutomation = true
機能一覧の全貌は V4 の新機能 ページを参照してください。
配布形態とライセンス
V4 は購入後にカスタマーポータル経由で DLL として提供されます(NuGet パッケージは後日リリース予定)。名前空間とアセンブリ名は V3 と同じなので、ビルド構成は参照アセンブリを差し替えるだけで済みます。V4 は .NET Framework 4.8 と .NET 8（Windows）で動作します。
V4 は Professional(最大 3 台、サポート 1 ヶ月)と Enterprise(台数無制限、サポート 3 ヶ月)の 2 つのエディションを提供しています。最新の価格は 価格ページ をご覧ください。
V3 は引き続き MIT ライセンスのオープンソースとして GitHub で公開しています。
詳細は完全版の移行ガイドへ
ドキュメント側の移行ガイドには、リネームごとの diff 形式コードサンプル、ステップごとのチェックリスト、エッジケースの注意点まで網羅しています。
ガイドに載っていない移行課題に遭遇された場合 — 特にカスタムセルタイプ、カスタムアクション、大規模なデータバインディング周りで困った場合 — お気軽に お問い合わせ ください。V3 のコードパターンに対応する V4 の最適な書き方をご案内します。