方法 : .NET Framework ガイドラインに準拠したイベントを発行する (C# プログラミング ガイド)
ここでは、.NET Framework の標準のパターンに従うイベントをクラスおよび構造体に追加する方法について説明します。.NET Framework クラス ライブラリ内のすべてのイベントは、次のように定義されている EventHandler デリゲートに基づいています。
public delegate void EventHandler(object sender, EventArgs e);
[!メモ]
.NET Framework 2.0 には、このデリゲートのジェネリック バージョンである EventHandler<TEventArgs> が導入されています。次の例では、両方のバージョンの使用方法を示します。
ユーザー定義のクラス内のイベントは、値を返すデリゲートを含む、あらゆる有効なデリゲートを基にすることができますが、一般には、次の例のように EventHandler を使用して、.NET Framework のパターンを基にすることをお勧めします。
EventHandler パターンに基づいてイベントを発行するには
イベントと共にカスタム データを送信する必要がない場合は、この手順を省略し、手順 3a. に進んでください。パブリッシャー クラスとサブスクライバー クラスの両方から参照できるスコープで、カスタム データのクラスを宣言します。次に、カスタム イベント データを保持する必須メンバーを追加します。この例では、単純な文字列が 1 つ返されます。
public class CustomEventArgs : EventArgs { public CustomEventArgs(string s) { msg = s; } private string msg; public string Message { get { return msg; } } }ジェネリック バージョンの EventHandler<TEventArgs> を使用する場合、この手順は省略します。パブリッシャー クラス内にデリゲートを宣言します。EventHandler で終わる名前を指定します。2 番目のパラメーターに、カスタムの EventArgs 型を指定します。
public delegate void CustomEventHandler(object sender, CustomEventArgs a);次のいずれかの手順で、パブリッシャー クラス内にイベントを宣言します。
カスタムの EventArgs クラスがない場合、Event 型は非ジェネリック バージョンの EventHandler デリゲートになります。このデリゲートは、C# プロジェクトを作成したときに含まれている System 名前空間で既に宣言されているため、ここで宣言する必要はありません。パブリッシャー クラスに次のコードを追加します。
public event EventHandler RaiseCustomEvent;非ジェネリック バージョンの EventHandler を使用し、EventArgs から派生したカスタム クラスがある場合は、パブリッシャー クラス内でイベントを宣言し、手順 2. のデリゲートを型として使用します。
public event CustomEventHandler RaiseCustomEvent;ジェネリック バージョンを使用する場合、カスタム デリゲートは不要です。代わりに、パブリッシャー クラス内でイベントの種類として EventHandler<CustomEventArgs> を指定します。山かっこの部分は、実際のクラス名で置き換えます。
public event EventHandler<CustomEventArgs> RaiseCustomEvent;
使用例
次に示すのは前の手順の具体例です。この例では、カスタムの EventArgs クラスを使用し、イベントの種類として EventHandler<TEventArgs> を使用しています。
namespace DotNetEvents
{
using System;
using System.Collections.Generic;
// Define a class to hold custom event info
public class CustomEventArgs : EventArgs
{
public CustomEventArgs(string s)
{
message = s;
}
private string message;
public string Message
{
get { return message; }
set { message = value; }
}
}
// Class that publishes an event
class Publisher
{
// Declare the event using EventHandler<T>
public event EventHandler<CustomEventArgs> RaiseCustomEvent;
public void DoSomething()
{
// Write some code that does something useful here
// then raise the event. You can also raise an event
// before you execute a block of code.
OnRaiseCustomEvent(new CustomEventArgs("Did something"));
}
// Wrap event invocations inside a protected virtual method
// to allow derived classes to override the event invocation behavior
protected virtual void OnRaiseCustomEvent(CustomEventArgs e)
{
// Make a temporary copy of the event to avoid possibility of
// a race condition if the last subscriber unsubscribes
// immediately after the null check and before the event is raised.
EventHandler<CustomEventArgs> handler = RaiseCustomEvent;
// Event will be null if there are no subscribers
if (handler != null)
{
// Format the string to send inside the CustomEventArgs parameter
e.Message += String.Format(" at {0}", DateTime.Now.ToString());
// Use the () operator to raise the event.
handler(this, e);
}
}
}
//Class that subscribes to an event
class Subscriber
{
private string id;
public Subscriber(string ID, Publisher pub)
{
id = ID;
// Subscribe to the event using C# 2.0 syntax
pub.RaiseCustomEvent += HandleCustomEvent;
}
// Define what actions to take when the event is raised.
void HandleCustomEvent(object sender, CustomEventArgs e)
{
Console.WriteLine(id + " received this message: {0}", e.Message);
}
}
class Program
{
static void Main(string[] args)
{
Publisher pub = new Publisher();
Subscriber sub1 = new Subscriber("sub1", pub);
Subscriber sub2 = new Subscriber("sub2", pub);
// Call the method that raises the event.
pub.DoSomething();
// Keep the console window open
Console.WriteLine("Press Enter to close this window.");
Console.ReadLine();
}
}
}