C# の Nullable 値型（int?）入門 — null 合体 ?? と null 条件 ?. を業務SEが DB の未入力で使いこなす

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

DB の数値カラムが NULL のとき、C# 側でどう受ければいいんだ…ってなったこと、ないですか？？

int で受けると詰む。未入力の NULL も「0」も、同じ 0 に潰れて区別がつかない。「在庫数 0」なのか「まだ登録されてない」のか、コードからは見分けられなくなるんですよね。地味な話に見えて、業務システムだとこれがけっこう刺さる。

ここで効くのが C# Nullable int?。値型に null を持たせる Nullable<T> です。

この記事は「なんで int? が要るのか」から入ります。そこから HasValue / GetValueOrDefault / null 合体演算子 ?? / null 条件演算子 ?. を、DB の未入力値を安全に受け取るコピペパターンとして積み上げていく流れ。

田村さんの現場に多い .NET Framework 4.7.2 でも普通に動く構文に絞ってます。

なぜ int? が要るのか — NULL と 0 が区別できない問題

まず、なんで int? なんてものが要るのか。

int は値型です。必ず何かしらの値を持つし、初期値は 0。null にはなれない。

ところが DB の世界には NULL（未入力・不明）がある。「数量未定」と「数量0」は意味が全然違うのに、int で受けると両方 0 になって混ざります。

int qty = 0;   // これは「0個」? それとも「まだ入力されてない」?

この「値が無い状態」を型として表現できるのが Nullable<T>、省略形の int? です。

int? は「int の値、または null」のどちらか。これで NULL と 0 をちゃんと区別できます。

Nullable 値型の基本 — HasValue / Value / GetValueOrDefault

基本はこの3つ。int? に値があるか調べて、取り出すだけ。

int? age = null;       // 値型なのに null を持てる
age = 30;

// 値があるか確認
if (age.HasValue)
    Console.WriteLine(age.Value);   // 30

// null なら既定値、値があればその値
int x = age.GetValueOrDefault();    // null → 0、値あり → その値
int y = age.GetValueOrDefault(-1);  // null → -1 を既定にできる

HasValue が true か false、Value が中身。GetValueOrDefault() は「null なら既定値（int なら 0）、あれば中身」を1メソッドで返してくれます。

GetValueOrDefault(-1) みたいに既定値を渡せるのもいい感じで、「未入力は -1 扱い」みたいな現場ルールにそのまま乗る。

ここまでが土台。この上に演算子を2つ重ねると、もっと短く書けます。

null 合体演算子 ?? — null の時の既定値を1行で

?? は「左が null なら右を使う」演算子。GetValueOrDefault を演算子1個で書けると思えばいい。

int? input = null;
int count = input ?? 0;     // input が null なので 0

int? stock = 5;
int shown = stock ?? 0;     // stock は 5 なので 5

input ?? 0 で「input が null なら 0、そうでなければ input の中身」。DB から受けた int? を画面表示用に既定値で埋めるとき、これが定番です。こんな感じで1行で済む。

null 条件演算子 ?. — null なら触らずに抜ける

?. は「左が null なら、その先を呼ばずに null を返す」演算子。null チェックを書かずにメンバアクセスできます。

int[] nums = null;

// ❌ これは NullReferenceException
// int len = nums.Length;

// ✅ nums が null なら len も null (例外にならない)
int? len = nums?.Length;

// ?. と ?? の合わせ技: null なら 0
int safeLen = nums?.Length ?? 0;

nums?.Length は、nums が null だと null を返す（だから受け側は int?）。そこに ?? 0 を足せば「null なら 0」までセットで書けて、いい感じに短くなる。

この ?. と ?? の合わせ技、業務コードでめちゃくちゃ出てきます。覚えておくと手数が減ります！！

DB から int? に落とす — DBNull との橋渡し

実務で一番使うのがこれ。DataReader や DataTable から、NULL 許容の数値を int? で受け取るパターンです。

// DataReader から: DBNull なら null、そうでなければ int
int? qty = reader["Qty"] == DBNull.Value
    ? (int?)null
    : reader.GetInt32(reader.GetOrdinal("Qty"));

// DataTable の DataRow からなら Field<int?> が楽
int? price = row.Field<int?>("Price");   // DBNull は自動で null になる

DataRow.Field<int?>("列名") は、DB の NULL を勝手に int? の null に変換してくれる。DBNull.Value との比較を自分で書かずに済みます。

💡 DBNull の安全なハンドリング全般は SQL Server の DBNull を C# で安全に扱う5つのイディオム でまとめてます。今回は「受けた後の int? の扱い」に寄せた内容です。

これで「受け取る」側は固まりました。あとは踏みやすい罠を2つ潰しておきます。

ハマりポイント: 知らないと一晩飛ぶやつ

int? まわりで業務SEがよく踏むのは、この2つです。

① null のまま .Value を開いて InvalidOperationException

正直に言うと、俺もこれで30分溶かしました。

int? が null の状態で .Value を読むと、例外で落ちる。しかも NullReferenceException じゃなくて InvalidOperationException。エラーメッセージでピンとこないと、余計にハマるやつです。

int? n = null;
int bad = n.Value;
// ❌ InvalidOperationException: Nullable object must have a value.

実行結果（NullReferenceException ではなく InvalidOperationException が出る・Mono で再現）:

対処はシンプル。.Value を読む前に HasValue で確認するか、そもそも GetValueOrDefault() か ?? で受ける。.Value を直に開くのは「絶対値がある」と確信できる時だけにしておくと安全です。

② ?? の優先順位が低くて、意図と違う値が入る

これも一回やられました。?? は演算子の優先順位がかなり低い。+ や * より後に評価されます。

int? x = 5;

int wrong = x ?? 0 + 10;     // 結果は 5
int right = (x ?? 0) + 10;   // 結果は 15