ASP.NET MVC や ASP.NET Core MVC を扱っていると、Hidden と HiddenFor のどちらを使うべきか迷うことはありませんか。シンプルな hidden フィールドであれば、どちらでも同じように見えてしまうかもしれません。しかし実際には、この2つはモデルバインディング・保守性・型安全性という重要な観点で明確な違いがあります。
本記事では、10年前後の実務経験を持つエンジニアが設計判断に迷わないよう、Hidden と HiddenFor の違いを整理し、「どちらをいつ使うべきか」を実践的な基準としてまとめます。なお、内容は ASP.NET MVC / ASP.NET Core MVC 共通の考え方として解説します。
Hidden と HiddenFor の基本的な違い
Hidden と HiddenFor は、どちらも hidden フィールドを生成する HTML ヘルパーですが、最大の違いは モデルとどのように結びつくか という点にあります。この違いを理解することが、正しい使い分けの第一歩です。
Hidden: 任意の name/value を手動で指定するヘルパー
Html.Hidden("name", value) のように、name と value を直接指定して hidden フィールドを出力します。
モデルとは独立して値を設定できるため柔軟性は高いものの、name を文字列で指定するため型安全性はありません。その結果、タイポや名称変更時のバインド漏れなど、実務では見逃しやすい不具合につながる可能性があります。
HiddenFor: モデルに紐づく型安全なヘルパー
Html.HiddenFor(m => m.Property) のように、モデルのプロパティを指定して hidden フィールドを出力します。
強い型付けにより、プロパティ名の変更やリファクタリング時にもコンパイルエラーで問題を検知できます。また、フォーム送信時のモデルバインディングとの整合性が自動的に保たれる点も大きな特徴です。
実装例で見る違い（テキスト形式サンプル）
コードで見ると違いはわずかですが、設計面での影響は大きく異なります。
Hidden のコード例（非型安全）
@Html.Hidden("UserId", Model.UserId)
この場合、UserId は単なる文字列です。モデル側でプロパティ名を変更してもコンパイルエラーは発生せず、実行時にバインドされない不具合として表面化します。
HiddenFor のコード例（型安全）
@Html.HiddenFor(m => m.UserId)
モデルプロパティに直接紐づくため、リネームや型変更があった場合はコンパイル時に検知できます。結果として、保守性と安全性が大きく向上します。
Hidden / HiddenFor のメリット・デメリット
それぞれの特性を整理すると、使い分けの判断が明確になります。
Hidden のメリット・デメリット
メリット
- モデルに存在しない値を扱える
- 動的に name/value を構成できる
デメリット
- name を文字列指定するためタイポに弱い
- リファクタリング時に破綻しやすい
- モデルバインディングとの整合性が保証されない
HiddenFor のメリット・デメリット
メリット
- 型安全でリファクタリングに強い
- モデルとフォームの整合性が自然と保たれる
- HTML エンコードやフォーマット処理が自動適用される
デメリット
- モデルに定義されていない値は扱えない
どちらを使うべきかの実践的な判断基準
実務では「原則」を決めておくことで、設計の迷いを大きく減らせます。
HiddenFor を基本に、Hidden は例外的に使用
HiddenFor を基本とする理由
- モデルの値をフォームに渡す用途の大半を安全にカバーできる
- バインド漏れや命名ミスによる不具合を防ぎやすい
- チーム開発でも共通認識を持ちやすい
Hidden を使うケース
- モデルに含めたくない一時的なコンテキスト情報（例：権限フラグ、ページング情報など）を渡す場合
- 動的に name/value を生成する必要がある場合
設計時の注意点（セキュリティ観点）
hidden フィールドは クライアント側で容易に改ざん可能 である点に注意が必要です。Hidden / HiddenFor のどちらを使っていても、
- 権限判定
- 重要な業務ロジックの判断
を hidden フィールドの値に依存させてはいけません。これらは必ずサーバー側で再検証する設計が前提となります。
まとめ：Hidden と HiddenFor の正しい使い分けでバグを防ぐ
Hidden と HiddenFor は似ているようで、モデルとの結びつき・保守性・型安全性という観点では役割が明確に異なります。
一般的な業務アプリケーションでは HiddenFor を標準・推奨 とし、モデル外の値を扱う必要がある例外的な場面のみ Hidden を使用する設計が有効です。
フォーム周りの不具合は、想定外のデータバインディングが原因となるケースも少なくありません。本記事の整理を実プロジェクトに活かすことで、より安全で保守性の高い MVC アプリケーション設計につながります。
コメント