ASP.NET MVC の ViewBag / ViewData / TempData / Session 使い分け — 業務SEが踏む寿命と型安全の3つの罠

みなさんこんにちは！ヒロポンです！

WinForms から ASP.NET MVC に来て、最初に「？？」ってなったのがこれ。Controller から View に値を渡す方法が、ViewBag・ViewData・TempData・Session と4つもある。

ん？どれ使えばええんや、と。

見た目は似てるのに、寿命が違ったり、片方は読むと消えたり。知らずに使うと地味にハマるやつです。

この記事は、ASP.NET ViewBag ViewData 違いを軸にしてます。4つの箱をスコープ・型安全・寿命で整理して、業務SEが踏む3つの罠まで一気に潰す。.NET Framework 4.7.2 / MVC 5 前提です。

⏱ 4つの箱の早見表（先に結論）

迷ったらここだけ見れば足ります！！

ざっくり言うと、同じリクエスト内なら ViewBag/ViewData、リダイレクトを跨ぐなら TempData、ずっと持つなら Session。これが基本の振り分けです。

こんな感じで覚えとくと、もう迷いません。

それぞれの使いどころ

ViewBag と ViewData（同じ箱の別 API）

Controller から View に少量の値を渡す、一番よく使うやつ。

// Controller
public ActionResult Index()
{
    ViewBag.Message = "こんにちは";   // dynamic でアクセス
    ViewData["Count"] = 10;            // 辞書でアクセス
    return View();
}

@* View (Razor) *@
<p>@ViewBag.Message</p>
<p>@ViewData["Count"]</p>

ここ大事なんですが、ViewBag と ViewData は中身が同じ箱です。ViewData["Message"] で入れたものを ViewBag.Message で取り出せる。

ViewBag は ViewData を dynamic でラップしただけなんですよね。

だから「どっちを使うか」は完全に好みの問題。両方使うと混乱するので、プロジェクトで片方に寄せるのが楽です。

TempData（リダイレクトを跨ぎたい時）

「保存しました」みたいなメッセージを、リダイレクトの後に1回だけ出したい。そういう時に使います。

TempData["Flash"] = "保存しました";
return RedirectToAction("Done");

ViewBag/ViewData はリクエストをまたぐと消えます。だからリダイレクト後に出したいなら TempData の出番。

ただし、これに罠があります（後述）。

Session（セッション中ずっと持ちたい時）

ログインユーザー情報みたいに、リクエストをまたいでずっと保持したいもの。これは Session に入れます。

Session["UserId"] = 100;
var id = Session["UserId"];   // ログアウトまで残る

便利です。便利なんですが、何でも詰めるとスケールで頭打ちになります（これも後述）。

業務SEが踏む3つの罠

ここからが本題。4つの箱、それぞれに地雷があります。

罠1: TempData は読むと「次のリクエストで」消える

正直に言うと、俺もこれでハマりました。「リダイレクト先では出たのに、その次の画面で null になる」やつです。

TempData は 一度読み取ると、その値に「次のリクエストで消す」マークが付く仕様です。リダイレクト後に1回だけ表示する用途に最適化されてる。

値そのものはそのリクエストの終わりまで残るので、同じリクエスト内なら2回読んでも返ってきます。消えるのは読んだ次のリクエストから。ここを「2回目で消える」と勘違いすると、シナリオを読み違えます。

// set 側 → リダイレクト
TempData["Flash"] = "保存しました";
return RedirectToAction("Done");

// Done アクション（次のリクエスト）で読む
var msg = TempData["Flash"];   // 読める。ここで「消費」マークが付く
// → さらにその次のリクエストでは TempData["Flash"] は null

// 次のリクエストまで残したいなら Peek / Keep
var safe = TempData.Peek("Flash");   // 読んでも消費しない（次も残る）
TempData.Keep("Flash");              // 読んだ値を次のリクエストまで延命

Peek は「読むけど消費マークを付けない」、Keep は「読んだ値を次のリクエストまで延命する」。こんな感じで使い分けます。

これを知らないと、リダイレクト先で読めた TempData を次の画面でも使えると思い込んで null を踏みます。「さっきは出たのに？？」となるやつです。

罠2: ViewBag は dynamic で、型安全じゃない

これもやられました。ViewBag.Mesage（スペルミス）と書いても、コンパイルは通るんですよ。

ViewBag は dynamic なので、プロパティ名のタイプミスや型の間違いをコンパイラが検出してくれません。実行して View を開いて初めて「値が出ない」と気付く。これが地味にしんどい。

ViewBag.Message = "hello";
// View 側で @ViewBag.Mesage と書いてもコンパイルエラーにならない（実行時に空）