C# の nameof / typeof / GetType() の使い分け（リネームに強いログを書く）

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

ログや例外メッセージに、プロパティ名を "UserName" って文字列で直書きしてませんか？？

それ、プロパティをリネームした瞬間にログだけ古い名前のまま残るやつです。

コンパイルは通るから気づかない。障害調査でログを見て「あれ、このプロパティ今こんな名前だっけ」ってなる。

俺も一度やりました。直し忘れたログのせいで、原因追いをまるまる遠回りしたことがある。

これを防ぐのが nameof。ついでに、よく一緒に混乱する typeof と GetType() も整理しときます。この3つ、取れるものが全部違うので。

結論: 名前・静的な型・実行時の型で使い分ける

先に答えです。

• nameof(x) … 識別子を名前の文字列にする（"x"）。コンパイル時に決まる。ログ・例外・プロパティ名に
• typeof(T) … 型のType 情報を取る。コンパイル時に書いた静的な型
• GetType() … インスタンスの実行時の実際の型を取る。継承があると typeof と違う値になる

「名前がほしいなら nameof、書いた型の情報がほしいなら typeof、実物の型が知りたいなら GetType()」。

これだけ押さえれば迷いません。

なぜ3つあるのか — 取れるものが違うから

似た場面で出てくるから混ざりがち。え、どれ使うんやったっけ？？ってなるやつですが、返すものが根本から違います。

nameof が返すのはただの文字列。

typeof と GetType() が返すのは System.Type というオブジェクト、つまり型情報です。

そして typeof と GetType() の差は、いつの型か。typeof はコードに書いた静的な型（コンパイル時）、GetType() は目の前のインスタンスの実際の型（実行時）。

継承や多態が絡むと、この2つは違う答えを返します。

「文字列か型か」「コンパイル時か実行時か」。この2軸で見ると、スッと分かれます。

最短対処: コピペで動く使い分け

nameof — 名前を文字列で取る

using System;

class User { public string Name { get; set; } }

class Program
{
    static void Main()
    {
        var user = new User { Name = "田中" };

        Console.WriteLine(nameof(user));        // user
        Console.WriteLine(nameof(user.Name));   // Name  (末尾のメンバ名だけ)
        Console.WriteLine(nameof(User));        // User
    }
}

実行結果:

例外メッセージで使うと、こんな感じで効いてきます。

void SetAge(int age)
{
    if (age < 0)
        throw new ArgumentOutOfRangeException(nameof(age), "年齢は 0 以上で指定してください");
}

age をリネームすれば nameof(age) も勝手に追従する。文字列直書きと違って、直し忘れが起きません！！

typeof と GetType() — 型を取る（継承で差が出る）

using System;

class Animal { }
class Dog : Animal { }

class Program
{
    static void Main()
    {
        Animal a = new Dog();

        Console.WriteLine(typeof(Animal));  // 書いた型
        Console.WriteLine(a.GetType());     // 実際の型

        Console.WriteLine(a.GetType() == typeof(Dog));     // 実型で判定
        Console.WriteLine(a is Animal);                    // 派生も含めて判定
    }
}

実行結果:

a は Animal 型の変数だけど、中身は Dog。

typeof(Animal) は書いた型のまま Animal。a.GetType() は実物の Dog を返します。こんな感じで、書いた型と実物の型がずれる。

ここが一番の使いどころの違いです。

ハマりポイント: 知らないと詰まるやつ

nameof(x.Prop) は「末尾のメンバ名だけ」

nameof(user.Name) が返すのは "Name" だけ。

ん？user.Name 全部ちゃうの？ってなるけど、"user.Name" みたいなパス全体にはなりません。

「ログに user.Name ってフルで出したいのに、Name しか出ない」ってなるやつ。フルで出したいなら $"{nameof(user)}.{nameof(user.Name)}" みたいに自分で組み立てます。

typeof(List<>) は「中身を書かない」開いた総称型

ジェネリックの型情報を取る時、要素の型を書くかどうかで意味が変わります。

using System;
using System.Collections.Generic;

class Program
{
    static void Main()
    {
        Console.WriteLine(typeof(List<int>));  // 閉じた型 (要素は int)
        Console.WriteLine(typeof(List<>));      // 開いた総称型 (要素型は未指定)
    }
}

typeof(List<>) は「要素の型をまだ決めてない List」を表す、開いた総称型（open generic type）です。

リフレクションで「List かどうか」だけ判定したい時に使います。typeof(List<T>) と間違えやすいので注意。

GetType() を null に呼ぶと落ちる

GetType() は Object のインスタンスメソッド。だから変数が null だと NullReferenceException で落ちます。

string s = null;
var t = s.GetType();   // NullReferenceException