CS801～2000

C# コンパイラエラー CS1615 について解説

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

コンパイラエラーCS1615は、関数定義に合わせずに引数へ余分なキーワード(例：refやout)を付けた場合に発生します。

たとえば、通常の値渡しで定義された関数に対してrefを使用するとエラーとなり、メッセージは「引数 ‘number’ を ‘keyword’ キーワードと共に渡すことはできません」と表示されます。

キーワードを削除するか、宣言と一致するように修正する必要があります。

目次から探す

エラー発生の背景
- 関数定義と引数の不整合
- エラーメッセージの内容
エラー原因の分析
- 関数呼び出しにおける引数渡しの注意点
- ref/outキーワードの正しい利用方法
エラー解消の方法
- 不要なキーワードの削除方法
- 関数宣言との整合性確認
開発環境での検証
- コンパイラのエラーチェック確認
まとめ

エラー発生の背景

関数定義と引数の不整合

不適切なキーワード(ref/out)の指定事例

関数定義で引数に対して特に参照渡しを意図していない場合、呼び出し時に誤ってrefまたはoutキーワードを指定すると、コンパイラはエラーCS1615を返します。

たとえば、以下のサンプルコードでは関数FaultyFunctionの定義には通常の引数が定義されている一方、呼び出し時にrefキーワードをつけているためエラーが発生します。

using System;
class Program
{
    // 引数にref/outが指定されていない関数定義
    static void FaultyFunction(int number)
    {
        // numberの値を表示する処理
        Console.WriteLine("FaultyFunction: " + number);
    }
    static void Main()
    {
        int i = 10;
        // refキーワードを付けて呼び出すと関数定義と不整合となりエラーCS1615が発生する
        FaultyFunction(ref i);
    }
}

このコードはコンパイル時にエラーが発生し、正しく引数を渡すためにはrefを削除する必要があります。

エラーメッセージの内容

「引数 ‘number’ を ‘keyword’ キーワードと共に渡すことはできません」の説明

このエラーメッセージは、関数定義で指定されていないrefやoutキーワードを、関数呼び出し時に誤って付与した場合に表示されます。

エラーメッセージの構造は以下の通りで、具体的な引数名やキーワード名(例：numberやref)が示されるため、どの箇所の記述が誤っているかを特定しやすくなっています。

つまり、関数定義に整合していないキーワード渡しが原因であることを意味しており、不要なキーワードを削除することで解消可能です。

エラー原因の分析

関数呼び出しにおける引数渡しの注意点

関数定義との整合性について

関数呼び出し時に渡す引数が、関数の宣言と一致していない場合、エラーが発生します。

たとえば、関数定義でint型の引数のみを受け取る関数に対して、refあるいはoutを指定して呼び出すと、定義と呼び出しの間に不整合が生じます。

このため、引数を渡す際は、関数の定義に記載されている仕様に従い、参照渡しが意図されていない場合はキーワードを使用しないようにする必要があります。

ref/outキーワードの正しい利用方法

使用可能なケースと不要なケース

refやoutキーワードは、関数に対して変数の参照を渡し、関数内でその変数の値を更新する場合に利用します。

具体的な使用可能なケースは以下の通りです。

関数宣言時に引数にrefまたはoutが指定されている場合
呼び出し側でも同様にrefまたはoutを指定して引数を渡す場合

一方、関数定義で参照渡しが必要ない場合には、キーワードを使用しないことが正しい記述となります。

この点を正しく認識することで、意図しないエラーを回避できるようになります。

エラー解消の方法

不要なキーワードの削除方法

誤った記述の見直し

エラーが発生した場合、まずは関数定義と呼び出しの両方を確認し、意図しないキーワードが使用されていないかを確認してください。

以下のサンプルコードは、先ほどのエラーコードを修正した例です。

関数CorrectFunctionは通常の引数を受け取り、呼び出し時にキーワードを使用していないため、エラーが解消されます。

using System;
class Program
{
    // キーワードなしの通常の引数定義
    static void CorrectFunction(int number)
    {
        // numberの値を表示する処理
        Console.WriteLine("CorrectFunction: " + number);
    }
    static void Main()
    {
        int i = 10;
        // 定義と一致しているためrefキーワードは不要
        CorrectFunction(i);
    }
}

CorrectFunction: 10

関数宣言との整合性確認

コード修正時のポイント

コード修正の際には、関数定義と呼び出しがどちらも同じ引数の受け渡し方法を採用しているかを重点的に確認してください。

もし参照渡しが必要な場面であれば、以下のように関数定義側も呼び出し側もrefやoutを使用する必要があります。

using System;
class Program
{
    // refキーワードを使用した関数定義
    static void RefFunction(ref int number)
    {
        // numberの値を更新する処理
        number += 5;
        Console.WriteLine("RefFunction: " + number);
    }
    static void Main()
    {
        int i = 10;
        // 関数定義と呼び出しの両方にrefキーワードを使用
        RefFunction(ref i);
    }
}

RefFunction: 15

このように、関数定義と呼び出し側の記述が一致しているかどうかを確認することが、エラー解消のポイントとなります。

開発環境での検証

コンパイラのエラーチェック確認

修正後の動作テスト方法

開発環境上では、コードを修正後に必ずコンパイラのエラーチェックを実施してください。

具体的な手順は以下の通りです。

コードを保存し、開発環境のビルド機能を利用してコンパイルする
コンパイルが正常に完了し、エラーメッセージが表示されないことを確認する
実行環境でプログラムを動かし、期待した出力が得られるかテストする

以下のサンプルコードは、修正済みの例として参考にしていただけます。

using System;
class Program
{
    // 正しい引数渡しを行う関数定義
    static void TestFunction(int number)
    {
        // numberの値を表示する処理
        Console.WriteLine("TestFunction: " + number);
    }
    static void Main()
    {
        int i = 20;
        // 定義に合わせた呼び出しを実施
        TestFunction(i);
    }
}

TestFunction: 20

このように、エラーチェックと動作テストを通じてコードが正しく修正されているかを確認することが重要です。

まとめ

本記事では、C#のエラーCS1615の原因と対策について解説しています。

誤ってref/outキーワードを使用すると関数定義との不整合が発生する点や、正しい引数渡し方法について具体例を示しました。

関数定義と呼び出しの整合性を確認し、不要なキーワードの削除や正しいキーワード指定でエラーを解消する方法を学ぶ内容となっています。