CS401～800

C#コンパイラエラー CS0666 の原因と対策について解説

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

CS0666 は C# のコンパイラエラーで、構造体内に protected メンバーを宣言すると発生します。

構造体は暗黙的に sealed され、継承がサポートされないため、protected 修飾子が無意味となりエラーとなります。

構造体を扱う際には、メンバーのアクセス修飾子に注意してください。

目次から探す

エラー発生の背景と基本
- C#における構造体の特性
- protectedメンバーが禁止される理由
CS0666エラーの発生パターン
- エラーが生じるコード例
- コンパイラメッセージの解析方法
エラー対策と修正方法
- 修正方法の基本アプローチ
- 実例を通じた対策解説
まとめ

エラー発生の背景と基本

C#における構造体の特性

継承非対応と暗黙のsealed

C#の構造体はクラスとは異なり、継承をサポートしません。

そのため、構造体は暗黙的にsealedとなり、他の型からの継承を禁止しています。

継承が存在しないため、プロテクトメンバーの概念も意味を持たなくなります。

例えば、ある構造体に対して継承可能な要素を定義しても、その定義は実際には利用されず、コンパイラがエラーを発生させる原因となります。

アクセス修飾子の役割

アクセス修飾子は、型やメンバーが外部からどのように利用できるかを制御する役割を担っています。

クラスにおいては、protected修飾子を用いることで、継承したクラス内でもメンバーにアクセスできるようにできます。

しかし、構造体の場合は継承が存在しないため、protectedを利用しても意味がなく、誤った記述として処理されます。

protectedメンバーが禁止される理由

protectedの意味と動作範囲

protectedはクラスのメンバーに対して、同一クラスまたはその派生クラス内でのアクセスを許可するための修飾子です。

クラスは継承を前提としているため、派生クラスでの利用が可能となります。

しかし、構造体にはこの継承の仕組みが存在しないため、protectedが正しく機能しません。

コンパイラエラーCS0666の意図

エラーCS0666は、構造体内でprotectedメンバーを宣言した場合に発生します。

C#コンパイラは、構造体においては継承が許可されないため、protected修飾子を使う意味がなく、不適切なコードとして扱います。

このエラーは、設計上の誤りをユーザーに知らせるために表示されます。

CS0666エラーの発生パターン

エラーが生じるコード例

不適切なアクセス修飾子の使用ケース

構造体内でprotected修飾子を使用すると、継承に依存するアクセス制限がそもそも意味をなさないため、エラーCS0666が発生します。

下記のサンプルコードは、構造体内で不適切にprotected修飾子を使用した例です。

using System;
struct SampleStruct
{
    // 不適切なアクセス修飾子の使用例です。
    // 構造体では継承が存在しない為、protectedは利用できません。
    protected int wrongField;  // ここでCS0666エラーが発生します。
}
class Program
{
    static void Main()
    {
        Console.WriteLine("CS0666 エラーの発生例");
    }
}

(コンパイル時にCS0666エラーが発生します)

コード例に見るエラー発生条件

上記のサンプルコードでは、構造体SampleStructにおいて、wrongFieldがprotected修飾子で宣言されています。

C#コンパイラは、構造体が継承をサポートしていないことを前提としているため、このような宣言は無効と判断し、エラーCS0666を出力します。

使用されるアクセス修飾子が構造体の特性に合致していないことが、エラー発生の直接的な原因です。

コンパイラメッセージの解析方法

メッセージ内容の読み取りポイント

コンパイラからのCS0666エラーのメッセージは、構造体内でprotectedなメンバーが宣言されていることを指摘しています。

エラーメッセージに含まれる「新規のプロテクトメンバー」という文言は、開発者が意図的にprotectedを適用してしまった可能性を示唆します。

また、Microsoftの公式ドキュメントにある説明では、構造体は常にsealedであるため、継承が不可能であり、protectedメンバーを持つ意義がないと明記されています。

メッセージからは、コードのどの部分が原因であるかを確認し、修正の方向性を検討するための重要な情報が得られます。

エラー対策と修正方法

修正方法の基本アプローチ

アクセス修飾子の変更による対応

CS0666エラーを解決するための基本的な対策は、構造体内で使用されるアクセス修飾子をprotectedから、意味のある別の修飾子に変更することです。

一般的には、構造体内でのメンバーアクセスはprivateやpublicを使用します。

継承が前提となっていないため、これらの修飾子が正しく動作します。

コード書き換え時の注意点

コードを修正する際は、構造体が意図した通りに動作するか、また、アクセスの範囲が正しく制御されるかどうかを検証する必要があります。

修正前にコード全体を把握し、該当箇所のみを対象に変更を加えるとともに、余計な影響が及ばないように留意します。

実例を通じた対策解説

修正前後のコード比較

以下は、修正前のコードと修正後のコードを比較したサンプルです。

修正前のコード(エラー発生例):

using System;
struct SampleStruct
{
    // 構造体内でprotected修飾子を使用しており、CS0666エラーが発生します。
    protected int errorField;
}
class Program
{
    static void Main()
    {
        Console.WriteLine("CS0666 エラーのサンプルコード");
    }
}

修正後のコード(エラー解決例):

using System;
struct SampleStruct
{
    // 修正例では、protectedをprivateに変更して、エラーを回避しています。
    private int correctField;
}
class Program
{
    static void Main()
    {
        SampleStruct instance = new SampleStruct();
        Console.WriteLine("修正後のサンプルコード");
    }
}

修正後のサンプルコード

対策実施時のポイント詳細

対策を実施する際は、以下のポイントに注意してください。

構造体内で継承に依存するメンバーを定義していないか確認する
不必要なアクセス修飾子が使用されていないか、特にprotected修飾子の有無をチェックする
変更後のコードが、意図した通りにデータのカプセル化やアクセス制御を行っているか確認する

上記の内容に沿ってコードを見直すことで、CS0666エラーの発生を防ぐことが可能です。

まとめ

この記事では、C#の構造体は継承をサポートしないため、暗黙的にsealedとなり、protected修飾子が無効であることを解説しています。

CS0666エラーの発生理由と、誤ったアクセサの使用例を示し、正しい対策としてprivateやpublicに変更する方法を具体的なコードとともに説明しています。

この記事を通じて、エラー原因の把握と効果的な修正手法が理解できる内容となっています。