event (C# リファレンス)

event キーワードを使用して、パブリッシャー クラス内にイベントを宣言します。

使用例

次の例では、基になるデリゲート型として EventHandler を使用するイベントを宣言し、発生させる方法について説明します。完全なコード例については、「方法 : .NET Framework ガイドラインに準拠したイベントを発行する (C# プログラミング ガイド)」を参照してください。完全なコード例では、ジェネリック EventHandler<TEventArgs> デリゲート型の使用方法、イベント サブスクリプションの実行方法、およびイベント ハンドラー メソッドの作成方法も確認できます。

    public class SampleEventArgs
    {
        public SampleEventArgs(string s) { Text = s; }
        public String Text {get; private set;} // readonly
    }
    public class Publisher
    {
        // Declare the delegate (if using non-generic pattern).
        public delegate void SampleEventHandler(object sender, SampleEventArgs e);

        // Declare the event.
        public event SampleEventHandler SampleEvent;

        // Wrap the event in a protected virtual method
        // to enable derived classes to raise the event.
        protected virtual void RaiseSampleEvent()
        {
            // Raise the event by using the () operator.
            if (SampleEvent != null)
                SampleEvent(this, new SampleEventArgs("Hello"));
        }
    }

イベントは、宣言元 (パブリッシャー クラス) のクラスまたは構造体内でしか呼び出せない特殊なマルチキャスト デリゲートです。その他のクラスまたは構造体のイベントをサブスクライブすると、パブリッシャー クラスがイベントを発生させるときにイベント ハンドラー メソッドが呼び出されます。詳細およびコード例については、「イベント (C# プログラミング ガイド)」および「デリゲート (C# プログラミング ガイド)」を参照してください。

イベントは、public、private、protected、internal、または protectedinternal とマークできます。これらのアクセス修飾子により、クラスのユーザーがイベントにどのようにアクセスできるかが定義されます。詳細については、「アクセス修飾子 (C# プログラミング ガイド)」を参照してください。

キーワードとイベント

イベントには次のキーワードが適用されます。

イベントは、static キーワードを使用して静的イベントと宣言することもできます。このように宣言すると、クラスのインスタンスが存在しない場合でも、呼び出し元がいつでもイベントを使用できるようになります。詳細については、「静的クラスと静的クラス メンバー (C# プログラミング ガイド)」を参照してください。

また、イベントは、virtual キーワードを使用して仮想イベントとマークできます。この場合、派生クラスでは、override キーワードを使用して、イベントの動作をオーバーライドできます。詳細については、「継承 (C# プログラミング ガイド)」を参照してください。仮想イベントをオーバーライドするイベントは、sealed にすることもできます。この場合、派生クラスでは、イベントが仮想でなくなります。最後に、イベントは abstract としても宣言できます。この場合、コンパイラはイベント アクセサー ブロック add および remove を生成しません。したがって、各派生クラスで固有の実装を提供する必要があります。

C# 言語仕様

詳細については、「C# 言語仕様」を参照してください。言語仕様は、C# の構文と使用法に関する信頼性のある情報源です。

参照

処理手順

方法 : デリゲートを結合する (マルチキャスト デリゲート) (C# プログラミング ガイド)

関連項目

C# のキーワード

add (C# リファレンス)

remove (C# リファレンス)

修飾子 (C# リファレンス)

概念

C# プログラミング ガイド

その他の技術情報

C# リファレンス