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

CS0069はC#のコンパイラエラーの一つです。

インターフェイス内でイベントを宣言する際に、addやremoveアクセサーを指定すると発生します。

インターフェイスはイベントの実装を持たず宣言する役割を果たすため、具体的な実装は実装クラスに任せることになります。

このエラーを解決するには、インターフェイス内でのアクセサー指定を削除してください。

CS0069エラーの発生原因

インターフェイスにおけるイベント宣言の基本

イベントとアクセサーの役割

C#では、eventはオブジェクトの状態変化を通知するための仕組みです。

イベントは、イベントハンドラー(デリゲート型)を登録するために提供され、通常addとremoveというアクセサーが自動生成されます。

これらのアクセサーは、イベントの購読登録や解除を管理する重要な役割を担っております。

たとえば、次のコードはイベントを宣言した例です。

// SampleEvent.cs
using System;
public delegate void SampleEventHandler(string message);
public class SampleClass
{
    public event SampleEventHandler OnSampleEvent;
    public void TriggerEvent(string message)
    {
        // 登録されているイベントハンドラーを順に呼び出す
        OnSampleEvent?.Invoke(message);
    }
}
public class Program
{
    public static void Main(string[] args)
    {
        SampleClass sample = new SampleClass();
        // イベントにハンドラーを登録
        sample.OnSampleEvent += (msg) => Console.WriteLine("イベントメッセージ: " + msg);
        sample.TriggerEvent("こんにちは、イベント");
    }
}

イベントメッセージ: こんにちは、イベント

この例では、OnSampleEventへの登録と解除が背後で管理され、利用者はイベントの利用に集中できます。

インターフェイス上での不正なアクセサー指定の事例

インターフェイスは、クラスの実装に委ねるための契約を規定する仕組みです。

そのため、インターフェイス内でaddやremoveのアクセサーを明示的に指定することはできません。

下記のコードは誤った記述例であり、コンパイラエラーCS0069が発生します。

// CS0069ErrorExample.cs
public delegate void EventHandlerDelegate();
public interface IExample
{
    // 以下はアクセサーを明示的に指定しており、エラーとなる
    event EventHandlerDelegate OnClick { remove { } }
    // 正しい形のイベント宣言
    event EventHandlerDelegate OnClickValid;
}

このコードのOnClickイベントは、インターフェイス上でアクセサーの実装を含むため、CS0069エラーが発生します。

エラー発生の背景

C#の設計意図と実装委譲の考え方

C#は、インターフェイスによってクラスの実装の詳細を隠蔽し、実装の自由度を高める設計がなされています。

インターフェイスは、メンバのシグネチャ(署名)のみを定義し、具象的な実装は派生するクラスが行う仕組みです。

イベントのaddおよびremoveアクセサーも、具象クラスによって適切に実装されるべき機能と考えられております。

そのため、インターフェイス内で直接アクセサーのコードブロックを記述することが設計の考えに反し、エラーとなります。

コンパイラがエラーを出力する理由

コンパイラは、インターフェイスの契約として純粋なメンバ定義のみを許容しており、アクセサーの実装もその例外ではありません。

インターフェイスでアクセサーを実装しようとすると、クラスの設計上の一貫性が損なわれる可能性があるため、CS0069エラーを出力して利用者に修正を促します。

これにより、開発者は実装の責任を適切な場所(具象クラス)に分散できる仕組みが強化されます。

CS0069エラーへの対処方法

正しいイベント宣言の実装

インターフェイスでの適正なイベント定義

インターフェイス内でイベントを定義する際は、アクセサーの実装を含むことなく、イベントの署名のみを定義する必要があります。

たとえば、以下のように定義することでCS0069エラーを回避できます。

// ProperInterface.cs
public delegate void EventHandlerDelegate(string message);
public interface IProperInterface
{
    // 正しいイベント定義：アクセサーは含まない
    event EventHandlerDelegate OnAction;
}

実装クラスでのイベント処理の実例

イベントの実装は、インターフェイスを実装するクラスで行います。

以下のサンプルコードは、インターフェイスに定義されたイベントを正しく利用し、実際に発火させる例です。

// EventImplementation.cs
using System;
public delegate void EventHandlerDelegate(string message);
public interface IProperInterface
{
    event EventHandlerDelegate OnAction;
}
public class ActionClass : IProperInterface
{
    public event EventHandlerDelegate OnAction;
    public void PerformAction()
    {
        // イベントが登録されている場合にのみ発火させる
        OnAction?.Invoke("イベントが実行されました");
    }
}
public class Program
{
    public static void Main(string[] args)
    {
        IProperInterface instance = new ActionClass();
        // イベントにハンドラーを登録
        instance.OnAction += (msg) => Console.WriteLine("受信メッセージ: " + msg);
        // クラス内のアクションを実行し、イベントを発火
        ((ActionClass)instance).PerformAction();
    }
}

受信メッセージ: イベントが実行されました

この実装例では、インターフェイスで定義されたイベントを適切に扱い、実装クラス内でイベントの発火およびハンドラーの呼び出しを行っています。

エラー回避の修正手順

アクセサー指定の削除とコード修正の手順

CS0069エラーを回避するためには、インターフェイス内でアクセサーaddやremoveの実装を削除し、イベントの署名のみを残す必要があります。

以下の手順に沿ってコードを修正してください。

1. インターフェイス内の問題箇所(アクセサー指定が行われているイベント)を特定します。
2. イベント宣言から{ add { } }または{ remove { } }などの実装部分を削除し、イベントの宣言のみとします。
3. 修正後のインターフェイスを実装する具象クラス内で、イベント発火やハンドラーの管理コードを記述します。

修正時の注意点と確認項目

修正作業を進める際には以下の点に注意してください。

• インターフェイス内には、イベントの署名のみを記述するようにする。
• 具象クラスでイベントの動作を正しく実装する必要があるため、イベントの発火部分(例えば、OnAction?.Invoke(message)など)を確実に記述する。
• 修正後、コンパイルエラーが解消されるか確認し、イベントが正しく動作するか実際の動作確認を行う。

以上の手順と注意点に沿ってコードを修正することで、CS0069エラーの原因を解消し、契約通りのインターフェイス設計を実現できます。

まとめ

本記事では、C# コンパイラ エラー CS0069の原因とその対処法について解説しました。

インターフェイスにおけるイベント宣言は、アクセサー実装を含むとエラーとなるため、イベントの署名のみを定義する必要があることが分かります。

正しいイベントの実装方法と、問題解決に向けた修正手順を実例を交えて説明しており、実践的な知識の習得が可能です。