C# コンパイルエラー CS1736 の原因と対策について解説

CS1736はC#で発生するコンパイルエラーです。

既定のパラメーター値にコンパイル時の定数以外の値を設定すると、このエラーが出ます。

たとえば、関数呼び出しの結果など実行時に評価される値を既定値に設定するとエラーとなります。

回避策として、仮の定数値を設定し、実行時に必要な値へ置き換える方法が推奨されます。

CS1736エラーの原因分析

コンパイル時定数の要件と役割

C#では、メソッドの既定パラメーター値はコンパイル時に解決される必要があります。

つまり、既定値として使用できる値は、コンパイル時に固定された定数でなければなりません。

このため、関数の中で計算や関数呼び出しを行った結果は、既定値として設定することができず、コンパイルエラー CS1736が発生する原因となります。

たとえば、以下の例では関数G()の呼び出し結果を既定パラメーターとして利用しようとしているため、コンパイル時定数として認識されることができず、エラーとなります。

// エラーとなる例
public class SampleClass
{
    static void F(int i = G())  // G()はコンパイル時定数ではない
    {
        // 処理内容
    }
    static int G() => 0;
    public static void Main(string[] args)
    {
        F();
    }
}

関数呼び出しによる非定数値の使用問題

関数呼び出しは実行時に評価されるため、その結果はコンパイル時に決まっていません。

既定パラメーターとして設定する際に、関数呼び出しが利用されると、コンパイラはこの値が常に同じになるかどうかを保証できないため、定数として納得できずエラーを発生させます。

つまり、既定値に動的な要素が入ると、意図しない挙動が生じる可能性があるため、C#の設計上、既定パラメーターにはあらかじめ確定している定数のみを使用することが求められているのです。

エラー発生の具体的要因

デフォルトパラメーター値の仕様上の制約

C#の仕様では、既定パラメーター値はコンパイル段階で確定している必要があります。

そのため、定数以外の値、具体的には関数の呼び出し結果や変数、計算結果は利用できません。

この制約は、メソッド呼び出し時に引数が省略された場合に、どの値を利用すべきかを明確にするための設計上の措置です。

例えば、既定値に計算結果や外部関数の返り値を用いると、呼び出しのたびに異なる結果が得られる可能性があり、コードの予測性が失われるため厳格な定数の利用が求められます。

コンパイル時評価の限界

コンパイル時評価は、プログラムの安全性と予測可能性を高めるための仕組みですが、すべての処理をコンパイル時に行えるわけではありません。

たとえば、関数呼び出しやループ、条件分岐といった実行時のロジックはコンパイル時に評価できないため、既定パラメーターとして使用することは不可能です。

$$\text{既定パラメーター値}=\text{コンパイル時定数}$$

と表現できるように、既定値は常に固定化された値でなければならず、その結果、動的な評価はコンパイル時定数から除外されることになります。

エラー回避の実装方法

仮の定数値を利用する対処法

コード例と修正ポイントの検討

既定パラメーターに動的な値を使用する代わりに、特定のマーカー値(たとえば-1など)を既定値として設定し、メソッド内部でそのマーカー値を検知して実行時に適切な値を設定する方法があります。

以下のサンプルコードでは、引数に-1が指定された場合に、実行時に関数G()を呼び出してその返り値を使用する方法を示しています。

// 仮の定数値を利用する例
public class SampleClass
{
    // Fメソッドはデフォルトで-1を受け取る
    static void F(int i = -1)
    {
        // マーカー値-1ならば、実行時にG()を呼び出して正しい値を設定する
        if(i == -1)
            i = G();
        // 日本語メッセージを出力する例
        System.Console.WriteLine("引数の値: " + i);
    }
    static int G() => 42; // 任意の処理を表す関数
    public static void Main(string[] args)
    {
        // 引数を省略すると、デフォルト値-1が設定され、実行時にG()が呼ばれる
        F();
    }
}

引数の値: 42

この方法では、「-1」というマーカー値を利用することで、既定値としてコンパイル時定数を設定しながら、実行時に正しい動的評価を行うことが可能になります。

修正のポイントは、既定パラメーターに直接関数呼び出しを記述するのではなく、マーカー値を使い、実行時に必要な処理を追加することです。

実行時評価へ切り替える対応策

プログラム修正手順の確認

実行時評価に切り替える方法として、既定パラメーターの使用を避け、メソッドの内部で必要な値を設定する手法があります。

この方法では、メソッドの呼び出し時に引数を省略する代わりに、呼び出し先で引数の有無をチェックし、引数が渡されていない場合に実行時に値を決める処理を追加します。

コード例は以下の通りです。

// 実行時評価に切り替える例
public class SampleClass
{
    static void F(int? i = null)
    {
        // nullの場合は、実行時に関数G()で値を設定
        if(i == null)
            i = G();
        System.Console.WriteLine("引数の値: " + i);
    }
    static int G() => 100; // 実行時評価される関数
    public static void Main(string[] args)
    {
        // 引数を指定せずに呼び出すと、nullチェックによってG()が呼ばれる
        F();
    }
}

引数の値: 100

この対応策では、引数としてnull可能な型(ここではint?)を使用して、引数が渡されなかった場合に実行時で処理を行います。

プログラム修正の手順は以下の通りです。

• 既定パラメーターに動的な値を設定しないようにする
• 引数型をnull可能な型に変更する
• メソッド内部で、引数がnullの場合に動的に必要な値を設定する

これにより、CS1736エラーを回避しつつ、柔軟な引数処理が実現できます。

注意すべきポイント

コンパイル時定数の適用範囲と留意点

コンパイル時定数は、既定パラメーターだけでなく、定数フィールドやアノテーションなど多くの場所で利用されます。

そのため、定数として設定される値は、基本的に変更不能であり、実行時に値が変動するものは利用できません。

具体的には、以下の点に注意する必要があります。

• 関数呼び出しや計算結果を直接既定パラメーターに設定しない
• 定数として利用可能なリテラルや定数フィールドを活用する
• 変更が必要な場合は、実行時評価に切り替える設計を検討する

開発環境での挙動確認方法

既定パラメーターの動作やエラー発生時の挙動は、開発環境やコンパイラのバージョンによって若干異なる場合があります。

そのため、以下の方法で挙動の確認を行うと良いでしょう。

• Visual StudioやVisual Studio Codeなどの統合開発環境でコンパイルエラーを確認する
• サンプルコードを実際にビルドし、実行時の出力をチェックする
• コンパイル時定数に関する仕様が変更される場合の最新情報を、Microsoftの公式ドキュメントで確認する

このように開発環境でのテストを重ねることで、既定パラメーターの設定や値の評価に関する理解を深め、CS1736エラーの再発を防ぐことが可能です。

まとめ

本記事では、C#のコンパイルエラー CS1736 の原因と対策を解説しています。

既定パラメーターにはコンパイル時定数が必要な理由や、関数呼び出しなど動的な要素が既定値として指定できない問題、仕様上の制約について説明しました。

さらに、仮の定数値や実行時評価を用いた解決策とその具体的な手順、開発環境での挙動確認のポイントについても解説しています。