【C#】名前付き引数を利用してメソッド呼び出しの可読性と柔軟性を向上させる

2025年12月10日

C# 4.0 で導入された「名前付き引数（Named Arguments）」を使用すると、メソッドを呼び出す際に引数の名前を明示的に指定して値を渡すことができます。

通常、メソッドの引数は定義された順序通りに渡す必要がありますが、名前付き引数を使用することで、引数の順序を自由に入れ替えたり、特定のオプション引数（省略可能な引数）だけを指定して渡したりすることが可能になります。これにより、引数が多いメソッドの可読性が大幅に向上します。

本記事では、商品検索機能をシミュレートしたメソッドを例に、名前付き引数の具体的な活用方法を解説します。

実装例：商品検索メソッドでの活用

以下のコードは、検索キーワード（必須）、最小価格（任意）、最大価格（任意）を受け取るメソッドを定義し、それを名前付き引数を使って柔軟に呼び出す例です。

using System;

namespace NamedArgumentsExample
{
    class Program
    {
        static void Main(string[] args)
        {
            Console.WriteLine("--- 商品検索システム ---");

            // 1. 通常の呼び出し（位置指定引数）
            // 定義順序通りに値を渡す必要がある
            // SearchProducts("Keyboard", 0, 5000); と等価
            SearchProducts("Keyboard");

            // 2. 特定の引数だけを指定する（混合使用）
            // 必須引数はそのまま渡し、中間の 'minPrice' を飛ばして 'maxPrice' だけを指定
            SearchProducts("Laptop", maxPrice: 150000);

            // 3. 引数の順序を入れ替える
            // 全ての引数を名前付きにすることで、定義順序に関係なく記述できる
            // 「何を渡しているか」がコード上で明確になり、可読性が高まる
            SearchProducts(maxPrice: 3000, keyword: "Mouse", minPrice: 1000);
        }

        /// <summary>
        /// 条件に一致する商品を検索して表示します。
        /// </summary>
        /// <param name="keyword">検索キーワード（必須）</param>
        /// <param name="minPrice">最小価格（省略時は0）</param>
        /// <param name="maxPrice">最大価格（省略時は無制限）</param>
        static void SearchProducts(string keyword, int minPrice = 0, int maxPrice = int.MaxValue)
        {
            string maxPriceStr = (maxPrice == int.MaxValue) ? "上限なし" : $"{maxPrice}円";
            
            Console.WriteLine($"検索実行 -> キーワード: \"{keyword}\", " +
                              $"価格範囲: {minPrice}円 ～ {maxPriceStr}");
        }
    }
}

解説とメリット

1. 特定のオプション引数のみを指定可能

上記の例 2 のように、minPrice のデフォルト値はそのまま利用し、maxPrice だけを変更したい場合、名前付き引数がなければ SearchProducts("Laptop", 0, 150000) とすべての引数を記述する必要がありました。名前付き引数を使えば、変更したい引数だけをピンポイントで指定できます。

2. コードの自己文書化（可読性向上）

例 3 のように呼び出し側で引数名を書くことで、「この 3000 という数値が何を表しているのか」が一目瞭然となります。 Calculate(true, 10) のようなコードよりも、Calculate(enableLogging: true, retryCount: 10) と書かれていた方が、コードの意図が明確に伝わります。