CS801～2000

C# CS1501エラーについて解説：適切な引数指定とオーバーロード解決法

2025-03-29更新日: 2025-03-29

CS1501は、C#でメソッド呼び出し時に指定した引数の数または型が、用意されているオーバーロードと一致しない場合に発生するコンパイルエラーです。

詳しいエラーメッセージを確認し、引数の個数や型が正しいか見直すことで解決できます。

目次から探す

CS1501エラーの特徴
- エラーの発生原因
- エラーメッセージの内容と例
メソッドオーバーロードの基本
- オーバーロードの仕組み
エラー解析の実例
- コード例による発生ケース
- 修正のためのコード例
エラー回避のポイント
- チェック項目と修正手順
まとめ

CS1501エラーの特徴

CS1501エラーは、メソッド呼び出し時に引数の数や型が、定義されているメソッドのオーバーロードどれとも一致しない場合に発生します。

ここでは、エラーの原因やコンパイラがどのようにオーバーロードを解決するかについて解説します。

エラーの発生原因

引数の数と型の不一致

引数の数や型が、呼び出し先のメソッドの定義と合致していない場合、CS1501エラーが表示されます。

たとえば、定義されているメソッドが1つの整数引数を受け取るにもかかわらず、2つの引数を渡してしまう場合などが該当します。

また、期待される型と異なる型の引数を渡した場合も同様にエラーとなります。

例えば、int型しか受け付けないメソッドにstring型を渡すと、引数の型不一致によるエラーが発生します。

コンパイラによるオーバーロード解決

C#のコンパイラは、同じ名前で定義された複数のメソッド(オーバーロード)の中から、最も適したものを選択します。

この解決過程では、各オーバーロードの引数の数、型、場合によってはユーザー定義変換などが考慮されます。

しかし、渡された引数に合致するメソッドが見つからなかった場合、すなわち全ての候補が不適合と判断された場合にCS1501エラーが発生します。

例えば、暗黙的な型変換では変換できない場合などが挙げられます。

エラーメッセージの内容と例

エラーメッセージは、どのメソッドの呼び出しが原因かを示します。

よく見られる例は以下の通りです。

ここでは、誤った引数指定の例を示すサンプルコードと、発生するエラーメッセージのイメージを確認してみます。

using System;
class Program
{
    // Addメソッドは整数型1つの引数を受け取ります
    static int Add(int number)
    {
        return number + 10;
    }
    static void Main(string[] args)
    {
        // 以下の呼び出しは引数が2つになっており、定義と一致しないためCS1501エラーが発生します
        int result = Add(5, 15); // 誤った呼び出し例
        Console.WriteLine(result);
    }
}

error CS1501: メソッド 'Program.Add(int)' に対して '2' 個の引数が指定されています。

メソッドオーバーロードの基本

メソッドオーバーロードは、同じ名前で複数のメソッド定義を実現する機能です。

複数のメソッドが定義されている場合、呼び出し時に渡された引数の数や型、暗黙の変換の可能性などにより、最適なオーバーロードが決定されます。

オーバーロードの仕組み

オーバーロードを使用することで、同じ機能を持つが異なるパラメーターセットで動作するメソッドを定義できます。

呼び出し時には、C#のコンパイラが各オーバーロードのパラメーターと渡された引数を比較し、最も適合するものを選択します。

この仕組みにより、同じメソッド名でも用途に応じた処理を記述することが可能です。

署名の一致条件

メソッドの署名は、メソッド名とパラメーターの型、順序、数によって決まります。

戻り値の型は署名には含まれません。

たとえば、以下の2つは署名が異なるため、オーバーロードとして共存できます。

void Process(int number)
void Process(double number)

コンパイラは、呼び出し時に渡された引数の型がどの署名に一致するかを確認します。

基本的には完全一致が求められ、必要な暗黙の変換も考慮されます。

ユーザー定義変換の影響

ユーザー定義変換が定義されている場合、コンパイラは暗黙的な変換や明示的な変換の可能性を評価します。

ただし、複数の変換が存在する場合や、変換が不明瞭な場合は、最適なオーバーロードを決定できず、CS1501エラーが発生する可能性があります。

このような状況では、明示的に型キャストを行うなどして、意図したオーバーロードを呼び出す工夫が必要です。

エラー解析の実例

実際に発生するケースからエラーの原因や修正方法を見ていきます。

ここでは、誤った引数指定によるエラーと、その修正例について解説します。

コード例による発生ケース

誤った引数指定の例

下記のサンプルコードは、定義されたメソッドに対して余分な引数を渡してしまう例です。

この場合、呼び出し側とメソッド定義の引数数が異なるため、コンパイラは適切なオーバーロードを見つけることができず、エラーが発生します。

using System;
class Program
{
    // 一つの整数を受け取るAddメソッド
    static int Add(int number)
    {
        return number + 10;
    }
    static void Main(string[] args)
    {
        // Addメソッドには1つの引数しか定義されていないため、2つ渡すとエラーになります
        int sum = Add(5, 20); // 誤った呼び出し例
        Console.WriteLine(sum);
    }
}

出力されるエラーメッセージ

上記コードをコンパイルすると、以下のようなエラーメッセージが表示されます。

error CS1501: メソッド 'Program.Add(int)' に対して '2' 個の引数が指定されています。

このメッセージは、指定された引数の数がメソッド定義と合致しないことを示しています。

修正のためのコード例

適切な引数指定の実装例

呼び出し側で正しい数と型の引数を指定することで、エラーは解消されます。

下記の例は、正しい引数指定によりエラーを回避する方法です。

using System;
class Program
{
    // 一つの整数を受け取るAddメソッド
    static int Add(int number)
    {
        return number + 10;
    }
    static void Main(string[] args)
    {
        // 正しい呼び出し: 引数が1つだけ渡されている
        int sum = Add(5);
        Console.WriteLine(sum);  // 出力: 15
    }
}

メソッドオーバーロードの見直し

場合によっては、呼び出し側の引数と複数のオーバーロードを用意することで、柔軟にエラーを回避することも可能です。

下記の例では、異なる引数数に対応するためにオーバーロードを実装しています。

using System;
class Program
{
    // 整数を1つ受け取るAddメソッド
    static int Add(int number)
    {
        return number + 10;
    }
    // 整数を2つ受け取るAddメソッド(オーバーロード)
    static int Add(int number1, int number2)
    {
        return number1 + number2;
    }
    static void Main(string[] args)
    {
        // 引数の数に応じて適切なAddメソッドが呼ばれます
        int result1 = Add(5);       // 一つの引数を使用
        int result2 = Add(5, 20);   // 二つの引数を使用
        Console.WriteLine(result1);  // 出力: 15
        Console.WriteLine(result2);  // 出力: 25
    }
}

15
25

エラー回避のポイント

エラーを未然に防ぐためには、コードレビューやIDEのツールを活用して、メソッド呼び出し時の引数の数や型が正しいかを確認することが重要です。

以下に具体的なチェック項目と活用法を説明します。

チェック項目と修正手順

引数の数がメソッドの定義と一致しているか確認する
引数型が正しいか、または必要な暗黙／明示的変換が存在するかをチェックする
ユーザー定義変換が影響していないか検討し、必要な場合は明示的な型キャストを検討する
オーバーロードされたメソッド間に曖昧さがないか、コードの意図を明確にするためのコメントを追加する

コードレビュー時の確認事項

各メソッド呼び出しが、対象のメソッド定義と整合性が取れているか
複数のオーバーロードが存在する場合に、誤ったオーバーロードが選択されていないか
変数の型や変換に関する記述に誤りがないか

IDEの支援機能の活用

Visual Studioなどの開発環境では、呼び出し先の候補がポップアップ表示されるため、意図しない呼び出しを未然に防ぐ手助けになります。

また、リアルタイムでエラーや警告が表示されるため、早期に問題を発見し、正しい修正を加えることが可能です。

まとめ

この記事では、CS1501エラーが引数の数や型の不一致により発生する仕組みを解説しています。

コンパイラによるオーバーロード解決過程や、署名の一致条件、ユーザー定義変換が影響するポイントを理解することができます。

また、誤った引数指定とその修正例、複数のオーバーロードを用いた解消方法、コードレビューやIDEの活用手法についても学ぶことができ、より正確なメソッド呼び出しの実装が可能になる内容となっています。