一尘不染

如何在C#中向UserControl添加事件?

c#

我有一个包含3个标签的UserControl。我想为其添加一个事件,该事件在其中一个标签的文本更改时发生。
我正在使用Visual Studio 2010


阅读 780

收藏
2020-05-19

共1个答案

一尘不染

首先,您需要在类中声明事件(以及方法和构造函数):

public event EventHandler LabelsTextChanged;

然后,您需要创建一个方法来处理各个标签的TextChanged事件。

private void HandleLabelTextChanged(object sender, EventArgs e)
{
    // we'll explain this in a minute
    this.OnLabelsTextChanged(EventArgs.Empty);
}

某个地方,可能在控件的构造函数中,您需要订阅标签的TextChanged事件。

myLabel1.TextChanged += this.HandleLabelTextChanged;
myLabel2.TextChanged += this.HandleLabelTextChanged;
myLabel3.TextChanged += this.HandleLabelTextChanged;

现在为HandleLabelsTextChanged方法。我们可以LabelsTextChanged直接加薪;但是,.NET框架设计指南指出,创建OnEventName受保护的虚拟方法来为我们引发事件是一种最佳实践。这样,继承类可以通过重写OnEventName方法来“处理”事件,事实证明,该方法比预订事件具有更好的性能。即使您认为您永远都不会重写该OnEventName方法,还是要习惯于这样做,这是一个好主意,因为它简化了事件引发过程。

这是我们的OnLabelsTextChanged

protected virtual void OnLabelsTextChanged(EventArgs e)
{
    EventHandler handler = this.LabelsTextChanged;
    if (handler != null)
    {
        handler(this, e);
    }
}

我们必须检查是否为空,因为没有订阅者的事件为空。如果我们尝试引发null事件,则会得到一个NullReferenceException。请注意,在将事件EventHandler检查为null并引发事件之前,我们会将事件复制到本地变量。如果我们改为这样做:

if (this.LabelsTextChanged != null)
{
    this.LabelsTextChanged(this, e);
}

我们将在无效检查和事件引发之间有一个竞争条件。如果恰好发生在事件引发之前,但在我们检查为空之后,事件的订阅者取消了订阅,则将引发异常。您通常不会遇到此问题,但是最好养成以安全方式编写它的习惯。

编辑: 这是public event EventHandler LabelsTextChanged;应放置行的方式:

namespace YourNamespace
{
    class MyUserControl : UserControl
    {
        // it needs to be here:
        public event EventHandler LabelsTextChanged;

        ...
    }
}

以下是有关事件设计的框架设计指南,以供进一步阅读。

2020-05-19