方法 : イベントサブスクリプションとサブスクリプションの解除 (C# プログラミングガイド)

[アーティクル]
09/30/2008

更新 : 2007 年 11 月

イベントの発生時に呼び出されるカスタムコードを作成するときは、別のクラスによって発行されたイベントをサブスクライブします。たとえば、ユーザーのボタンクリックでアプリケーションに何らかの処理を実行させるには、ボタンの click イベントをサブスクライブします。

Visual Studio IDE を使用してイベントをサブスクライブするには

[プロパティ] ウィンドウが表示されていない場合は、[デザイン] ビューで、イベントハンドラを作成するフォームまたはコントロールを右クリックし、[プロパティ] をクリックします。
[プロパティ] ウィンドウの上部にある [イベント] アイコンをクリックします。
Load イベントなど、作成するイベントをダブルクリックします。

Visual C# により空のイベントハンドラメソッドが作成され、コードに追加されます。[コード] ビューを使用して手動でコードを追加することもできます。たとえば次のコード行では、Form クラスが Load イベントを発生させたときに呼び出されるイベントハンドラメソッドを宣言しています。
```
private void Form1_Load(object sender, System.EventArgs e)
{
    // Add your form load event handling code here.
}
```
プロジェクトの Form1.Designer.cs ファイルの InitializeComponent メソッド内に、イベントをサブスクライブする必要があるコード行も自動生成されます。次のようになります。
```
  this.Load += new System.EventHandler(this.Form1_Load);
```

プログラムを使用してイベントをサブスクライブするには

シグネチャがイベントのデリゲートシグネチャと一致するイベントハンドラメソッドを定義します。たとえばイベントがデリゲート型 EventHandler に基づいている場合は、次のコードがメソッドスタブになります。
```
  void HandleCustomEvent(object sender, CustomEventArgs a)
  {
     // Do something useful here.
  }
```
加算代入演算子 (+=) を使用して、イベントにイベントハンドラをアタッチします。次の例では、オブジェクト publisher に RaiseCustomEvent という名前のイベントがあることを想定しています。サブスクライバクラスがイベントをサブスクライブするには、パブリッシャクラスの参照が必要です。
```
publisher.RaiseCustomEvent += HandleCustomEvent;
```
これは、C# 2.0 で新しく導入された構文です。new キーワードを使用してカプセル化する側のデリゲートを明示的に作成する必要がある点では、C# 1.0 の構文と同じです。
```
publisher.RaiseCustomEvent += new CustomEventHandler(HandleCustomEvent);
```
イベントハンドラは、ラムダ式を使用して追加することもできます。
```
public Form1()
{
    InitializeComponent();
    // Use a lambda expression to define an event handler.
    this.Click += (s,e) => { MessageBox.Show(
       ((MouseEventArgs)e).Location.ToString());};
}
```
詳細については、「方法 : LINQ 以外でラムダ式を使用する (C# プログラミングガイド)」を参照してください。

匿名メソッドを使用してイベントをサブスクライブするには

後でイベントのサブスクリプションを解除する必要がない場合は、加算代入演算子 (+=) を使用して、イベントに匿名メソッドをアタッチします。次の例では、オブジェクト publisher に RaiseCustomEvent という名前のイベントがあり、特別なイベント情報を格納する CustomEventArgs クラスが定義されていることを想定しています。サブスクライバクラスがイベントをサブスクライブするには、publisher の参照が必要です。
```
  publisher.RaiseCustomEvent += delegate(object o, CustomEventArgs e)
  {
    string s = o.ToString() + " " + e.ToString();
    Console.WriteLine(s);
  };
```
匿名関数を使用してイベントをサブスクライブした場合は、簡単にサブスクリプションを解除できない点に注意してください。この場合、サブスクリプションを解除するには、イベントをサブスクライブしたコードに戻り、匿名メソッドをデリゲート変数に格納して、このデリゲートをイベントに追加する必要があります。通常は、後でコード内のイベントからサブスクリプションを解除する必要がある場合、イベントのサブスクライブに匿名関数を使用しないことをお勧めします。匿名関数の詳細については、「匿名関数 (C# プログラミングガイド)」を参照してください。

サブスクリプション解除

イベントの発生時にイベントハンドラが呼び出されるのを防ぐには、イベントサブスクリプションを解除します。リソースのリークを防ぐには、サブスクライバオブジェクトを破棄する前にイベントサブスクリプションを解除する必要があります。イベントサブスクリプションを解除しない限り、パブリッシャオブジェクト内のイベントの基礎となるマルチキャストデリゲートは、サブスクライバのイベントハンドラをカプセル化するデリゲートを参照します。パブリッシャオブジェクトに参照が含まれている限り、ガベージコレクションはサブスクライバオブジェクトを削除しません。

イベントサブスクリプションを解除するには

減算代入演算子 (-=) を使用して、イベントサブスクリプションを解除します。
```
  publisher.RaiseCustomEvent -= HandleCustomEvent;
```
すべてのサブスクライバのサブスクリプションが解除されたら、パブリッシャクラス内のイベントインスタンスが null に設定されます。