CS2001～

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

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

CS8147は、C#で発生するコンパイラエラーです。

refで返すプロパティにsetアクセサーを定義するとエラーが発生します。

参照渡しのプロパティは値の不整合を防ぐため、getアクセサーのみとする必要があります。

setアクセサーを削除することで対処でき、正しい実装となります。

目次から探す

エラー発生の背景
- 参照渡しプロパティの基本仕様
- setアクセサーが引き起こす問題点
CS8147エラーの実例
エラー解消のポイント
- 正しいプロパティ実装方法
- コードのリファクタリング方法
公式ドキュメントと参考資料
- Microsoft Learnの情報活用法
- その他の参考リソース
まとめ

エラー発生の背景

参照渡しプロパティの基本仕様

プロパティでのref返却の仕組み

C#では、プロパティで変数への参照を返すために、戻り値にref intなどの参照渡しの型を指定できます。

これにより、外部からプロパティを通して直接変数の値を変更できる仕組みとなります。

たとえば、変数の実体を直接取得することで、値の変更や共有が柔軟に行える利点があります。

なお、プロパティでrefを返す場合、必ずgetアクセサーで参照を返却する必要があります。

setアクセサーの制約について

参照渡しのプロパティにsetアクセサーを用いると、内部の変数をどのように更新するかの整合性が崩れる可能性があります。

C#コンパイラは、参照返却プロパティに対してsetアクセサーを許容しない設計になっており、実装するとCS8147エラーが発生します。

この制約は、参照を通じた直接操作の意図を明確にし、プログラムの安全性を保つためのものです。

setアクセサーが引き起こす問題点

エラー発生の具体的な理由

プロパティがrefで値を返却する場合、プロパティは変数の実体への直接的なリンクを提供します。

ここにsetアクセサーを加えると、参照渡しの意味する透明性が失われ、値の更新方法が曖昧になるため、コンパイラがCS8147エラーを発生させます。

すなわち、setアクセサーが存在すると、参照を通して変数の状態を一貫して管理することが難しくなり、コードの可読性や安全性に問題が生じるためです。

CS8147エラーの実例

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

該当コードの解説

以下のコードは、参照渡しプロパティにsetアクセサーが含まれているため、コンパイル時にCS8147エラーが発生します。

コード内のコメントで、エラーとなる部分を示しています。

// 以下のコードはCS8147エラー発生例です。
// refプロパティにsetアクセサーを持たせているため、エラーとなります。
/*
public class C
{
    // プライベートな変数numberの参照を保持しています。
    private ref int number;
    // プロパティNumberはrefで値を返しますが、setアクセサーがあるためエラーです。
    ref int Number { get => ref number; set => number = value; }
}
*/
public class Program
{
    public static void Main()
    {
        // このサンプルはCS8147エラーの発生例としてコードをコメントアウトしています。
        System.Console.WriteLine("CS8147エラーのサンプルコードはコメントアウトされています。");
    }
}

CS8147エラーのサンプルコードはコメントアウトされています。

コード修正事例

修正前後の比較

次に、CS8147エラーを解消した修正前後のコード例を示します。

修正のポイントは、参照渡しプロパティからsetアクセサーを削除することです。

以下に、修正前(エラー発生版)と修正後のコードを比較して記述します。

修正前(エラー発生版、コメントアウト)

/*
public class C
{
    private ref int number;
    ref int Number { get => ref number; set => number = value; }
}
*/

修正後

public class C
{
    // 内部で保持する変数numberValueに参照を持たせます。
    private int numberValue = 10; // 初期値10
    // setアクセサーを削除し、getアクセサーのみで値の参照を返します。
    public ref int Number
    {
        get { return ref numberValue; }
    }
}
public class Program
{
    public static void Main()
    {
        C obj = new C();
        // 修正後のプロパティはgetアクセサーのみとなるため、直接値の変更はできません。
        System.Console.WriteLine("修正後のコードはコンパイルが成功します。");
    }
}

修正後のコードはコンパイルが成功します。

エラー解消のポイント

正しいプロパティ実装方法

setアクセサー削除の手順

正しい実装方法は、参照渡しプロパティからsetアクセサーを削除し、getアクセサーでのみ変数の参照を返すように変更することです。

次のコードは、その修正手順を示す例です。

public class C
{
    // 内部変数numberValueに初期値42を設定しています。
    private int numberValue = 42;
    // getアクセサーのみ定義し、numberValueの参照を返します。
    public ref int Number
    {
        get { return ref numberValue; }
    }
}
public class Program
{
    public static void Main()
    {
        C obj = new C();
        // プロパティから取得した値をローカル変数に代入します。
        int value = obj.Number;
        System.Console.WriteLine($"Numberの値: {value}");
    }
}

Numberの値: 42

コードのリファクタリング方法

変更時の注意事項

リファクタリング時には、参照渡しプロパティの根本的な目的と使用方法を十分に理解する必要があります。

具体的には、以下の点に注意してください。

プロパティが参照を返す場合、setアクセサーを追加しないことを確認する。
対象の変数の更新が必要な場合は、外部から直接変更する用のメソッドや別の設計を検討する。
プロパティを利用して参照を返すことで、コードの可読性やメンテナンス性に影響が出ないように実装する。

これらの注意点を踏まえることで、CS8147エラーの発生を避けつつ、クリーンなコード設計を維持することができます。

公式ドキュメントと参考資料

Microsoft Learnの情報活用法

参照すべき公式ドキュメント

Microsoft Learnの公式ドキュメントは、C#の参照渡しプロパティの仕様やCS8147エラーについて詳細に説明されています。

公式サイトでは、具体例とともにエラーの原因や正しい実装方法が記載されているため、実装時の疑問解消に役立ちます。

特に、以下の公式ドキュメントの内容を参照すると理解が深まります。

コンパイラエラー CS8147 – 参照渡しプロパティの制約と使い方

その他の参考リソース

まとめ

この記事では、C#における参照渡しプロパティの仕組みと、その実装時に発生するCS8147エラーの原因を解説しています。

特に、ref返却プロパティにsetアクセサーを定義するとエラーが発生する理由と、その解決方法としてsetアクセサーの削除による正しい実装手法、そしてリファクタリング時の注意点について学べます。

正しい実装方法を理解することで、安全でクリーンなコード設計が可能となる内容です。