CS801～2000

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

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

CS1105はC#で拡張メソッドを正しく宣言していない場合に発生するエラーです。

拡張メソッドは非ジェネリックな静的クラス内で静的メソッドとして実装する必要があります。

通常のクラスや非静的メソッドとして記述するとエラーが出るため、クラス定義やメソッドの修正を行ってください。

目次から探す

CS1105エラーの発生原因
- 拡張メソッドの基本仕様
- 静的メソッドとしての定義ルール
拡張メソッドの正しい実装方法
- 正しいコード記述の実例
- 拡張メソッドとジェネリック型の制約
エラー例と修正方法の詳細
- エラー発生例の解析
- 修正手法の具体例
開発環境での検証と対策
- コンパイラメッセージの確認方法
- 修正後の動作確認
まとめ

CS1105エラーの発生原因

拡張メソッドの基本仕様

拡張メソッドの役割と利用方法

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

元の型の定義を変更することなく、簡単に機能拡張を行えるため、コードの再利用性が向上します。

たとえば、文字列型に対して新たな操作を追加する場合、既存のSystem.Stringクラスに直接手を加えずに利用できるのが便利です。

拡張メソッドは、メソッドの最初の引数にthis修飾子を付けることで、その型の拡張であることを表現します。

静的クラスの必要条件

拡張メソッドは、必ず静的クラス内で宣言しなければなりません。

これは、拡張メソッドがインスタンスではなく、クラスレベルで呼び出されるためです。

静的クラス内に定義することで、そのクラスがインスタンス化できず、予期しない使い方を防ぐことができます。

つまり、拡張メソッドの定義は、C#の仕様により静的なコンテキストでのみ許可されています。

静的メソッドとしての定義ルール

エラーが発生するケース

拡張メソッドとして宣言するためには、メソッド自体が静的である必要があります。

もし拡張メソッドを非静的な状態で定義すると、コンパイラはエラー CS1105 を出力します。

また、拡張メソッドが含まれるクラスが静的でない場合にも同様のエラーが発生します。

下記の例では、クラスが静的でないためエラーが発生するケースです。

// 拡張メソッドが定義された非静的なクラス (誤った例)
public class Extensions
{
    // メソッドが非静的で定義されているためエラーが発生する
    public void Test<T>(this string s)
    {
        // サンプル処理
    }
}
public class Program
{
    public static void Main(string[] args)
    {
        // エラーが発生するため、正しくは呼び出せません
        // string sample = "サンプル";
        // sample.Test<int>();
    }
}

上記の例では、クラスExtensionsとそのメソッドTestが静的ではないため、コンパイラは拡張メソッドとして認識できず、エラー CS1105 が発生します。

宣言方法の注意点

拡張メソッドを正しく宣言する際は、以下の点に注意する必要があります：

拡張メソッドは必ず静的メソッドとして定義する。
拡張メソッドを含むクラスは必ず静的クラスであること。
メソッドの最初の引数にはthisキーワードを付け、拡張対象の型を指定する。

これらの条件を守ることで、正しく拡張メソッドを利用することができます。

拡張メソッドの正しい実装方法

正しいコード記述の実例

宣言方法のポイント

以下は、正しく定義された拡張メソッドのサンプルコードです。

クラスStringExtensionsは静的クラスであり、拡張メソッドToJapaneseUpperは静的メソッドとして定義されています。

引数の最初にthis string strを指定することで、string型に対する拡張メソッドであることが明確になります。

using System;
public static class StringExtensions
{
    // string型の拡張メソッド。日本語の一部文字も大文字に変換する例です。
    public static string ToJapaneseUpper(this string str)
    {
        // 仮の処理として、通常のToUpperに加えて"(大文字変換済み)"を付加する
        return str.ToUpper() + "(大文字変換済み)";
    }
}
public class Program
{
    public static void Main(string[] args)
    {
        string sample = "こんにちは";
        // 解説: 拡張メソッドとして呼び出しが可能です。
        string result = sample.ToJapaneseUpper();
        Console.WriteLine(result);
    }
}

こんにちは(大文字変換済み)

拡張メソッドとジェネリック型の制約

型パラメーターの取り扱い

拡張メソッドはジェネリックメソッドとしても定義することができ、型パラメーターに制約を設けることも可能です。

ジェネリック拡張メソッドを利用する場合、型パラメーターは他のジェネリックメソッドと同様に扱われ、必要に応じて制約句を利用することで、その型に対する特定の操作が可能となります。

以下は、ジェネリックな拡張メソッドの例です。

using System;
public static class GenericExtensions
{
    // 型TがIComparableインターフェースを実装していることを要求するジェネリック拡張メソッドです。
    public static string CompareToDefault<T>(this T value) where T : IComparable<T>
    {
        // デフォルト値と比較して、比較結果を文字列で返す例
        T defaultValue = default(T);
        int comparison = value.CompareTo(defaultValue);
        return $"比較結果: {comparison}";
    }
}
public class Program
{
    public static void Main(string[] args)
    {
        int number = 10;
        // int型はIComparable<int>を実装しているため問題なく呼び出せます。
        string compareResult = number.CompareToDefault();
        Console.WriteLine(compareResult);
    }
}

比較結果: 1

エラー例と修正方法の詳細

エラー発生例の解析

問題のコード例

以下は、コンパイラエラー CS1105 を発生させる問題のコード例です。

静的でないクラス内で拡張メソッドを定義しているため、エラーが発生します。

using System;
// 静的でないクラス内で拡張メソッドを定義 (誤った例)
public class Extensions
{
    // 拡張メソッドとして定義されるためには、メソッド自体が静的である必要があります。
    public void Test<T>(this string s)
    {
        // サンプル処理
    }
}
public class Program
{
    public static void Main(string[] args)
    {
        // 呼び出し例 (エラーとなるため実行できません)
        // string sample = "サンプル";
        // sample.Test<int>();
    }
}

エラー内容の解説

上記のコード例では、Extensionsクラスが静的クラスとして定義されておらず、メソッドTestも静的ではありません。

そのため、拡張メソッドの定義に必要な条件を満たしておらず、コンパイラは CS1105 エラー「拡張メソッドは静的でなければなりません」としてエラーを出力します。

修正手法の具体例

修正前のコード分析

問題のコードでは、拡張メソッドが以下の2点で誤っていました：

Extensionsクラスが静的ではない。
メソッドTestが静的メソッドとして宣言されていない。

これらの点が、拡張メソッドとしての要件を満たしていない原因です。

修正後のコード例のポイント

正しく修正するためには、クラスを静的クラスとして宣言し、メソッドも静的に定義する必要があります。

以下は修正後のコード例です。

using System;
// 拡張メソッドを定義するための静的クラス (正しい例)
public static class Extensions
{
    // static修飾子を付けた拡張メソッドです。
    public static void Test<T>(this string s)
    {
        // サンプル処理として、文字列と型情報を出力する例
        Console.WriteLine($"入力文字列: {s}, 型パラメータ: {typeof(T)}");
    }
}
public class Program
{
    public static void Main(string[] args)
    {
        string sample = "サンプル";
        // 正しく拡張メソッドとして呼び出せます。
        sample.Test<int>();
    }
}

入力文字列: サンプル, 型パラメータ: System.Int32

この修正例では、拡張メソッドが正しく静的クラス内に定義されているため、CS1105 エラーは発生せず正常に動作します。

開発環境での検証と対策

コンパイラメッセージの確認方法

検証手順とポイント

開発環境において、コンパイラエラーや警告はエラーメッセージウィンドウや出力コンソールで確認できます。

Visual Studioを利用している場合、以下の点に注意してください：

エラーリストからエラー番号 CS1105 を検索して、どの部分に問題があるかを確認する。
該当するソースコード上で、拡張メソッドが正しく静的クラス内に定義されているかをチェックする。
エラー箇所に表示される詳細情報を参考にして、必要な修正内容を把握する。

また、コマンドラインでコンパイルする場合は、コンパイラの出力結果を確認して、エラーメッセージに記載されたファイル番号と行番号を手掛かりに調査を進めます。

修正後の動作確認

再コンパイル時の注意点

修正後は、再度ソリューション全体のビルドを行い、エラーが解消されたかどうか必ず確認してください。

以下のポイントに注意することで、再発防止が期待できます：

拡張メソッドの定義がすべての対象クラスに対して静的クラスかどうか確認する。
コード修正後に、対象のプロジェクトやライブラリを再コンパイルする際エラーリストを再チェックする。
実行前にサンプルコードを含むユニットテストを実施し、拡張メソッドが期待通りに動作していることを確認する。

適切な検証と対策を行うことで、今後同様のエラー発生を予防することが可能です。

まとめ

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

拡張メソッドは既存の型に機能を追加する便利な仕組みですが、必ず静的クラス内の静的メソッドとして定義する必要がある点や、ジェネリック拡張メソッドにおける型パラメーターの扱い方について具体例を用いて説明しています。

また、実際にエラーが発生するケースの解析と修正方法、開発環境での検証手順についても詳述されており、正しい実装方法や原因究明のポイントが理解できる内容となっています。