CS801～2000

C# コンパイラエラー CS1102：this と out の併用エラーについて解説

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

C# のコンパイラエラー CS1102 は、拡張メソッドの最初のパラメーターに this と out などの複数の修飾子を併用すると発生します。

拡張メソッドでは、this 修飾子を使って対象オブジェクトを指定するだけで十分なため、不要な修飾子を付与すると誤認識されエラーとなります。

エラー解消には、不要な修飾子を削除してください。

目次から探す

エラー発生の仕組み
- 拡張メソッドと this キーワードの役割
- out 修飾子の不適切な使用
エラー解消方法
拡張メソッド利用時の注意点
- this キーワードと他の修飾子の相互作用
- 関連エラーとの違い
まとめ

エラー発生の仕組み

拡張メソッドと this キーワードの役割

拡張メソッドの定義と使用条件

拡張メソッドは既存の型に新しいメソッドを追加するための機能です。

拡張メソッドを定義する際は、静的クラス内に静的メソッドを宣言し、その最初のパラメーターに this キーワードを付与して対象の型を指定します。

例えば、数値型に対して拡張メソッドを用意する場合、以下のように記述します。

using System;
public static class NumberExtensions
{
    // 拡張メソッドの定義。int型のオブジェクトに対してIsEvenメソッドが利用可能になる。
    public static bool IsEven(this int number)
    {
        return number % 2 == 0;
    }
}
public class Program
{
    public static void Main()
    {
        int sample = 42;
        // 拡張メソッド呼び出し。sampleが偶数かどうかを判定する。
        bool isEven = sample.IsEven();
        Console.WriteLine($"サンプルの値 {sample} は偶数か: {isEven}");
    }
}

サンプルの値 42 は偶数か: True

拡張メソッドは対象となる型の機能を拡張するために用意されており、通常のインスタンスメソッドと同様の感覚で呼び出すことができます。

静的メソッドにおける this キーワードの位置付け

静的メソッドで使用される this キーワードは、拡張メソッドであることを示すための専用の役割を担います。

this が付けられたパラメーターは対象となる型を指定しており、静的メソッドとして宣言されていなければなりません。

また、拡張メソッドの最初のパラメーター以外に、その他の修飾子が不要な点も特徴です。

つまり、this キーワードは他のパラメーター修飾子と併用しないように設計されています。

out 修飾子の不適切な使用

out キーワードの使用制限

out キーワードはメソッド呼び出しにおいて、引数に値を出力する場合に使用されます。

しかし、拡張メソッドの最初のパラメーターにおいては this 修飾子が既に指定されているため、他の修飾子(例えば out や ref)を併用することはできません。

C# の設計においては、拡張メソッドのシグネチャの一貫性を保つために、最初のパラメーター以外の修飾子が認められていません。

CS1102 エラーの発生状況

実際に拡張メソッドの定義において最初のパラメーターに this と out を同時に指定すると、コンパイラエラー CS1102 が発生します。

コンパイラエラーは、「パラメーター修飾子 ‘out’ は ‘this’ と共に使用できません」というメッセージで出力され、修正すべきポイントとして最初のパラメーターの修飾子構成が問題であることを示します。

以下はエラーが発生するサンプルコードです。

public static class Extensions
{
    // 拡張メソッドで this と out を同時に使用しているためエラー CS1102 が発生する。
    public static void Test(this out int number) { }
}
public class Program
{
    public static void Main()
    {
        int value;
        // 以下のコードはコンパイル時にエラーとなる。
        Extensions.Test(out value);
    }
}

エラー解消方法

不要な修飾子の削除手順

問題のあるコード例と修正方法

CS1102 エラーを解決するためには、拡張メソッドの最初のパラメーターから out 修飾子を削除する必要があります。

以下にエラーが発生するコード例と、その修正例を示します。

エラーが発生するコード例

public static class Extensions
{
    // 'this' と 'out' の併用によりコンパイルエラー CS1102 が発生。
    public static void Test(this out int number) { }
}
public class Program
{
    public static void Main()
    {
        int result;
        Extensions.Test(out result);
    }
}

修正後のコード例

using System;
public static class Extensions
{
    // 'out' 修飾子を削除し、拡張メソッドとして正しい定義に変更。
    public static void Test(this int number)
    {
        // サンプル処理：numberが偶数かどうかを出力する。
        Console.WriteLine($"{number} の値は拡張メソッド Test 内で処理されました。");
    }
}
public class Program
{
    public static void Main()
    {
        int sample = 10;
        // 拡張メソッドの呼出し(戻り値が必要な場合は返り値の定義に合わせる)。
        sample.Test();
    }
}

10 の値は拡張メソッド Test 内で処理されました。

修正前後の比較ポイント

修正前は最初のパラメーターに this out int と記述しており、this キーワードと out 修飾子が同時に使用されることでエラーが発生していました。

修正後は out を削除し、正しい拡張メソッドのシグネチャ this int に変更したため、エラーが解消され、メソッドが正しく呼び出せるようになりました。

コード修正時の留意事項

修正時の確認ポイント

コード修正の際は、以下の点を確認することが重要です。

拡張メソッドの最初のパラメーターに this キーワードが正しく使用されているか。
他の修飾子(特に out や ref)が誤って追加されていないかどうか。
修正後のメソッドシグネチャにより、既存の呼び出し箇所に影響が出ないか確認すること。

これらの確認を行うことで、修正作業がスムーズに進むとともに、拡張メソッドが意図した動作を行うことを確認できるでしょう。

拡張メソッド利用時の注意点

this キーワードと他の修飾子の相互作用

静的メソッド内での適用ルール

拡張メソッドは静的メソッド内で定義される必要があり、最初のパラメーターに this キーワードを付与することで対象の型を示します。

拡張メソッドで使用される this は、インスタンスメソッドのように呼び出すための手段であり、対象型のメソッドではないため、他の修飾子との組み合わせに制限があります。

例えば、他のパラメーターに out や ref を使用しても問題はありませんが、最初のパラメーターでは禁止されているため、注意が必要です。

また、拡張メソッドを定義する際には、対象となる型に対して意味のある操作を行うメソッドとして設計することが望ましく、無理な修飾子の併用は避けるべきです。

これにより、拡張メソッドが意図した通りに機能し、コードの可読性も向上します。

まとめ

この記事では、拡張メソッドがどのように定義されるか、最初のパラメーターにおける this キーワードの役割について説明しています。

また、this と out を同時に使用した場合に発生する CS1102 エラーの原因と、その解決方法(不要な out の削除)について、具体的なコード例を交えて解説しています。

これにより、エラーの発生メカニズムと正しい拡張メソッドの実装方法が理解できます。