【C#】nameof演算子を使って文字列のハードコーディングを排除し、安全なコードを書く

2025年12月10日

C# 6.0 で導入された nameof 演算子は、型、メンバー、変数などの名前をコンパイル時に文字列として取得する機能です。

従来、ログ出力や例外のスロー時に対象の名前を文字列リテラル（"variableName"）として記述していましたが、これには「変数名を変更した際に文字列の修正を忘れやすい」「タイプミスに気づきにくい」という問題がありました。nameof を使用することで、これらの問題を解決し、リファクタリングに強い安全なコードを実現できます。

実装例：様々な対象の名前を取得する

以下は、クラス、プロパティ、メソッド、そして変数に対して nameof を使用し、その名前を文字列として取得する基本的な実装例です。特にメソッドの引数チェックにおいて、その効果を発揮します。

using System;

namespace NameofExample
{
    class Program
    {
        static void Main(string[] args)
        {
            // 1. クラス名の取得
            // "DateTime" という文字列が取得されます（System.DateTimeでも末尾の名前が取れる）
            string className = nameof(DateTime);
            Console.WriteLine($"クラス: {className}");

            // 2. プロパティ名の取得
            // "Year" という文字列が取得されます
            string propertyName = nameof(DateTime.Year);
            Console.WriteLine($"プロパティ: {propertyName}");

            // 3. メソッド名の取得
            // "AddDays" という文字列が取得されます
            string methodName = nameof(DateTime.AddDays);
            Console.WriteLine($"メソッド: {methodName}");

            Console.WriteLine("------------------------------");

            // 4. 実用例：引数の検証
            // 変数名を変更しても、nameof部分もIDEのリファクタリング機能で自動的に追従します
            try
            {
                ProcessUserData(null);
            }
            catch (ArgumentNullException ex)
            {
                Console.WriteLine($"エラー発生: {ex.Message}");
                // ParamNameプロパティには "user" という文字列が入っています
                Console.WriteLine($"対象の引数名: {ex.ParamName}");
            }
        }

        static void ProcessUserData(string user)
        {
            // 引数がnullの場合、例外をスローする
            // 以前は "user" と書いていたが、nameof(user) と書くことで
            // 引数名が変わってもコードが壊れない
            if (user == null)
            {
                throw new ArgumentNullException(nameof(user), "ユーザー情報は必須です。");
            }

            Console.WriteLine($"処理実行: {user}");
        }
    }
}

nameofを利用するメリット

リファクタリング耐性の向上: IDEの「名前の変更」機能を使用した際、nameof(target) の中身も自動的に新しい名前に修正されます。文字列リテラル（"target"）の場合は手動で修正する必要があり、修正漏れのリスクがありました。
タイプミスの防止: 存在しないメンバー名を nameof に指定するとコンパイルエラーになるため、実行前にミスを検出できます。
可読性の向上: コードの意図として「この変数の名前を使いたい」ということが明確になります。