C#コンパイラ エラー CS1909：DefaultParameterValue属性適用エラーについて解説

CS1909エラーは、C#のコンパイル時にDefaultParameterValue属性を不適切なパラメーター型に適用した際に発生します。

対象のパラメーターが属性の使用対象であるか確認する必要があります。

エラーの詳細については、CS1910も参照してください。

エラーの原因

DefaultParameterValue属性の仕様

適用対象の制限

C#のDefaultParameterValue属性は、メソッドや関数のパラメーターにあらかじめ定数値を設定するために使用されます。

ただし、この属性はすべてのパラメーター型に適用できるわけではなく、コンパイル時定数が適用可能な型に限られます。

たとえば、プリミティブ型(int、double、boolなど)や文字列型には使用できますが、ユーザー定義の構造体やクラス、コンパイル時に決定できない値を持つ型には適用できません。

コンパイラは型の特性をチェックし、適用が不正な場合にエラーを報告します。

不正な適用例の解説

以下のサンプルコードでは、System.Collections.Hashtable型に対してDefaultParameterValue属性を適用していますが、Hashtableはコンパイル時定数として扱えないためエラーが発生します。

using System;
using System.Collections;
using System.Runtime.InteropServices;
class Program {
    static void Main() {
        SampleMethod(null);
    }
    // Hashtable型に対してDefaultParameterValue属性を不正に適用
    static void SampleMethod([DefaultParameterValue(null)] Hashtable table) {
        Console.WriteLine("サンプルメソッドの実行");
    }
}

CS1909: DefaultParameterValue属性は型 'System.Collections.Hashtable' のパラメーターに対して適用できません。

パラメーター型の誤用

コード例による問題点

パラメーター型がコンパイル時定数として扱えない場合でも、DefaultParameterValue属性を使用して初期値を設定しようとするとエラーになります。

たとえば、ユーザー定義の構造体や値型であっても、属性に設定された値がその型に適合しない場合、コンパイラが型の一致を確認してエラーを発生させます。

以下の例では、構造体型に対して無効な初期値を指定してエラーを誘発しています。

using System;
using System.Runtime.InteropServices;
struct SampleStruct {
    public int Number;
}
class Program {
    static void Main() {
        TestMethod(default(SampleStruct));
    }
    // SampleStruct型はコンパイル時定数に適していないため、エラーとなる
    static void TestMethod([DefaultParameterValue(null)] SampleStruct data) {
        Console.WriteLine($"Number: {data.Number}");
    }
}

CS1909: DefaultParameterValue属性は型 'SampleStruct' のパラメーターに対して適用できません。

エラー生成のメカニズム

コンパイラは、DefaultParameterValue属性が適用されたパラメーターの型を解析します。

ここで、属性に設定された値がパラメーターの型のコンパイル時定数として有効かどうかを検証します。

型の制限に反する場合、エラーCS1909が発生します。

コンパイラは、対象の型が属性に適合するかどうかを静的に判断するため、実行前に問題点を明確に示す仕組みになっています。

エラー発生の検証手法

コンパイラ出力の確認

エラーメッセージの解析

開発環境でプロジェクトのビルドを実行すると、エラー一覧にエラーCS1909が表示されます。

エラーメッセージには「DefaultParameterValue属性は型 ‘型名’ のパラメーターに対して適用できません」と記載されており、不正な型に属性が適用されたことが原因であると指摘されています。

エラーメッセージを参照することで、どのパラメーターに問題があるかを特定できます。

再現手順の確認

開発環境での検証ポイント

以下の手順に従ってエラーを再現できます。

• 該当箇所にDefaultParameterValue属性を適用するコードを書き込みます。
• 不正なパラメーター型(例：Hashtableやユーザー定義の構造体)を使用します。
• ソリューションをビルドし、出力ウィンドウまたはエラーログに表示されるエラーメッセージを確認します。

これにより、どのパラメーターに対してエラーが発生しているか、エラーの原因が明確になります。

エラー対処方法

適切な属性適用の実装方法

修正例の提示

属性の適用対象となる型に変更するか、あるいは初期値の指定はメソッドシグネチャの引数の初期化として実装する方法があります。

以下の例は、文字列型のパラメーターに対してメソッドシグネチャで初期値を指定する正しい方法です。

using System;
class Program {
    static void Main() {
        // 引数を省略して呼び出すと、デフォルト値が利用される
        SampleMethod();
        SampleMethod("指定されたメッセージ");
    }
    // メソッドシグネチャで初期値を指定
    static void SampleMethod(string message = "デフォルトメッセージ") {
        Console.WriteLine(message);
    }
}

デフォルトメッセージ
指定されたメッセージ

デバッグ手順の確認

問題箇所の特定と修正方法

エラー発生時は、まずエラーメッセージを確認し、該当する属性が適用されているパラメーターをピンポイントで特定します。

その後、該当パラメーターの型がコンパイル時定数として利用可能かどうかを判断し、必要に応じて型の変更やメソッドシグネチャ内での初期化に切り替えます。

原因特定の際には、Visual Studioなどの開発環境に備わっているデバッグ機能やエラーログの解析機能を活用すると効率的です。

CS1910エラーとの比較

CS1910エラーの概要

エラー内容の違い

CS1910エラーは、DefaultParameterValue属性の使用に対する新たな検査が行われるために発生するエラーです。

従来のCS1909エラーは、属性が不正な型に適用された場合に表示されました。

一方、CS1910エラーは、さらに厳格な型チェックが導入された際に発生し、属性の利用方法に対してより詳細な制限が設けられる経緯があります。

どちらのエラーも、不正な適用を防ぐための仕組みですが、CS1910はより最新の仕様に沿った検証結果となっています。

適用条件の比較

C#仕様に基づく違いの解説

C#の仕様では、属性の適用対象に関して明確な規定が設けられており、コンパイル時定数として評価可能な型にのみ適用が許可されています。

CS1909エラーは、従来の仕様に基づく制限が守られていない場合に発生しました。

一方、CS1910エラーは、仕様の改訂により、より厳格なチェックが導入された結果として現れ、属性使用の適用条件が拡充されています。

たとえば、CS1910では、型の互換性や評価可能な定数かどうかに対する検査がさらに詳細に行われるため、以前は見逃されていた問題点が明確に指摘されるようになっています。

まとめ

本記事では、C#のDefaultParameterValue属性に関するエラーCS1909の原因と、その適用対象型の制限、不正な適用例を解説しました。

また、コンパイラ出力の確認や再現手順を通じてエラー発生を検証する方法、正しい属性適用方法と修正例、デバッグ手順を説明しました。

さらに、CS1910エラーとの違いやC#仕様に基づく適用条件の比較を行い、エラー解決に必要な知識を網羅的に理解できる内容となっています。