EventArgsを継承したクラスを使用する意味はなんでしょうか？

Question

前提・実現したいこと

C#でイベントについて学習しています。

独自のEventArgsを使用する際に、色々なサンプルでEventArgsを継承すると書かれているのですが
継承が必要な理由がよくわかりません。
以下、TextBoxでXキーが押された際に実行されるイベントを作ってみました。

この際、XKeyDownArgsでEventArgsを継承してもしなくても挙動は変わらないように見えます。
EventArgsを継承することの利点や、しなければならない理由が何かあるのでしょうか？

よろしくおねがいします。

該当のソースコード

public partial class Form1 : Form
{
    private event EventHandler<XKeyDownArgs> XKeyDown;

    public Form1()
    {
        InitializeComponent();
    }

    private void Form1_Load(object sender, EventArgs e)
    {
        XKeyDown += XKeyDownMessage;
    }

    private void TextBox1_KeyDown(object sender, KeyEventArgs e)
    {
        if (e.KeyCode == Keys.X)
        {
            XKeyDown?.Invoke(sender, new XKeyDownArgs());
        }
    }

    private void XKeyDownMessage(object sender, XKeyDownArgs e)
    {
        MessageBox.Show("Xキーが押されました");
    }
}

// EventArgsを継承してもしなくても問題なく動作する
public class XKeyDownArgs : EventArgs
{
}

Answer 1

提示された例ですと
private event EventHandler<XKeyDownArgs> XKeyDown;
としているので、デリゲートの引数はXKeyDownArgsという型であればいいことになります。
ですが、EventArgsを継承している必要はありません。
ですが、EventArgsの説明を見ると

イベントのデータを含み、イベント データを含まないイベントに使用する値を提供するクラスの、基本クラスを表します。

とあります。
日本語があやしいですが、要は
イベントデータが必要な場合の基底クラスで、イベントデータを含まない場合の値ということです。
イベントデータとして渡す場合、EventArgsを継承するのはお約束だと思ってください。

では、EventArgsとは何なのかということですが、
これは「イベントの補足情報はありません。」ということを示すものです。

例のXKeyDownイベントは補足情報がありませんので本来は
private event EventHandler XKeyDown;
と定義し、EventArgsを渡すようにすべきです。

イベントハンドラでEventArgsが引数としてある場合、このイベントは補足情報がないというのが一目で分かるからです。
引数にEventArgs以外のクラスが来る場合(例の場合XKeyDownArgsクラス)はそのイベントに補足情報があると判断してしまうことになります。

Comments

[退会済みユーザー]

ご回答ありがとうございます。

丁寧なご説明で全体的に非常にわかりやすかったです。

イベントの理解が進みました。ありがとうございます。

Answer 2

理由はお約束だからとしか言いようがありません。
メリットは基底クラスを引数にもつイベントハンドラを汎用的に使えるとかでしょうかね。

そういった細かい約束が、解りやすく不具合が出にくいプログラムを書くには
必要なことなのです。

Comments

[退会済みユーザー]

ご回答ありがとうございます。

>メリットは基底クラスを引数にもつイベントハンドラを汎用的に使えるとかでしょうかね。

EventArgsというクラスがあることによって、補足情報がないイベントの場合には
誰が作ってもEventArgsをパラメータに使うことになる。
なので、+=できるメソッドのパラメータをEventArgsで統一する事ができる。

逆にEventArgsが無ければ個人個人が好きな型をパラメータにしてしまう可能性がある。
そうなると、+=できるメソッドのパラメータが個人個人でバラバラになってしまい
自分以外の人が作ったメソッドを+=できなくなるかもしれない。

こんな感じの認識であっていますでしょうか？

[hihijiji]

単純に一つのイベントハンドラを複数のイベントで使いまわせるってだけです。
フレームワークによりますが

Answer 3

すでに解決済のようですので今さらながらのレスですが、ちょっと気になったので一言・・・

EventArgsを継承することの利点や、しなければならない理由が何かあるのでしょうか？

イベントと共に何らかの情報をイベントハンドラに渡す場合に EventArgs を継承したカスタムクラスを作ることになります。

情報をイベントハンドラに渡さない場合は EventArgs クラスを使います。

では、情報を渡さないのに何故 Form1_Load(object sender, EventArgs e) というようにするのかという理由は、.NET Framework クラスライブラリ内のすべてのイベントは、次のように定義されている EventHandler デリゲートに基づいているからです。

public delegate void EventHandler(object sender, EventArgs e);

ユーザーが定義するカスタムクラスのイベントも、上記 .NET Framework のパターンに基づいて発行することが推奨されています。

詳しくは以下の記事が参考になると思います。

方法 : .NET Framework ガイドラインに準拠したイベントを発行する (C# プログラミング ガイド)
https://docs.microsoft.com/ja-jp/dotnet/csharp/programming-guide/events/how-to-publish-events-that-conform-to-net-framework-guidelines

記事のサンプルコードに EventArgs を継承したカスタムクラスの使い方が記載されているので見てください。

他に、イベントを起動する OnXxxx メソッドの使い方も書いてありますので、そのあたりも参考になると思います。

Comments

[退会済みユーザー]

ご回答ありがとうございます。

Onメソッドの使い方とクラス外からのイベントの使い方の説明参考になりました。
ありがとうございます。