事件（C# 编程指南）

类或对象可以通过事件向其他类或对象通知发生的相关事情。发送（或引发）事件的类称为“发行者”，接收（或处理）事件的类称为“订户”。

在典型的 C# Windows 窗体或 Web 应用程序中，可订阅由控件（如按钮和列表框）引发的事件。可使用 Visual C# 集成开发环境 (IDE) 来浏览控件发布的事件，选择要处理的事件。IDE 会自动添加空事件处理程序方法和订阅事件的代码。有关更多信息，请参见如何：订阅和取消订阅事件（C# 编程指南）。

事件具有以下特点：

发行者确定何时引发事件，订户确定执行何种操作来响应该事件。

一个事件可以有多个订户。一个订户可处理来自多个发行者的多个事件。

没有订户的事件永远也不会引发。

事件通常用于通知用户操作，例如，图形用户界面中的按钮单击或菜单选择操作。

如果一个事件有多个订户，当引发该事件时，会同步调用多个事件处理程序。要异步调用事件，请参见使用异步方式调用同步方法。

可以利用事件同步线程。

在 .NET Framework 类库中，事件是基于 EventHandler 委托和 EventArgs 基类的。

如何：订阅和取消订阅事件（C# 编程指南）

使用 Visual Studio IDE 订阅事件

如果看不到“属性”窗口，请在“设计”视图中，右击要为其创建事件处理程序的窗体或控件，然后选择“属性”。

在“属性”窗口的顶部，单击“事件”图标。

双击要创建的事件，例如 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);

Form1.Designer.cs

namespace WindowsFormsApplication1
{
    partial class Form1
    {
        /// <summary>
        /// 必需的设计器变量。
        /// </summary>
        private System.ComponentModel.IContainer components = null;

        /// <summary>
        /// 清理所有正在使用的资源。
        /// </summary>
        /// <param name="disposing">如果应释放托管资源，为 true；否则为 false。</param>
        protected override void Dispose(bool disposing)
        {
            if (disposing && (components != null))
            {
                components.Dispose();
            }
            base.Dispose(disposing);
        }

        #region Windows 窗体设计器生成的代码

        /// <summary>
        /// 设计器支持所需的方法 - 不要
        /// 使用代码编辑器修改此方法的内容。
        /// </summary>
        private void InitializeComponent()
        {
            this.SuspendLayout();
            // 
            // Form1
            // 
            this.AutoScaleDimensions = new System.Drawing.SizeF(6F, 12F);
            this.AutoScaleMode = System.Windows.Forms.AutoScaleMode.Font;
            this.ClientSize = new System.Drawing.Size(590, 371);
            this.Name = "Form1";
            this.Text = "Form1";
          this.Load += new System.EventHandler(this.Form1_Load);            this.ResumeLayout(false);

        }

        #endregion
    }
}

Form1.cs

using System;
using System.Collections.Generic;
using System.ComponentModel;
using System.Data;
using System.Drawing;
using System.Linq;
using System.Text;
using System.Threading.Tasks;
using System.Windows.Forms;

namespace WindowsFormsApplication1
{
    public partial class Form1 : Form
    {
        public Form1()
        {
            InitializeComponent();
        }

        private void Form1_Load(object sender, EventArgs e)
        {

        }
    }
}

以编程方式订阅事件

1、定义一个事件处理程序方法，其签名与该事件的委托签名匹配。例如，如果事件基于 EventHandler 委托类型，则下面的代码表示方法存根：

void HandleCustomEvent(object sender, CustomEventArgs a)
  {
     // Do something useful here. <span style="font-family: Arial, Helvetica, sans-serif;"> }  </span>

2、使用加法赋值运算符 (+=) 来为事件附加事件处理程序。在下面的示例中，假设名为 publisher 的对象拥有一个名为 RaiseCustomEvent 的事件。请注意，订户类需要引用发行者类才能订阅其事件。

publisher.RaiseCustomEvent += HandleCustomEvent;

3、还可以通过使用 lambda 表达式添加事件处理程序：

public Form1()
{
    InitializeComponent();
	
    // Use a lambda expression to define an event handler.  
    this.Click += (s,e) => { MessageBox.Show(((MouseEventArgs)e).Location.ToString());};
}

使用匿名方法订阅事件

如果以后不必取消订阅某个事件，则可以使用加法赋值运算符 (+=) 将匿名方法附加到此事件。在下面的示例中，假设名为 publisher 的对象拥有一个名为 RaiseCustomEvent 的事件，并且还定义了一个 CustomEventArgs 类以承载某些类型的专用事件信息。请注意，订户类需要引用 publisher 才能订阅其事件。

publisher.RaiseCustomEvent += delegate(object o, CustomEventArgs e)
  {
    string s = o.ToString() + " " + e.ToString();
    Console.WriteLine(s);
  };

请务必注意，如果使用匿名函数订阅事件，事件的取消订阅过程将比较麻烦。这种情况下若要取消订阅，必须返回到该事件的订阅代码，将该匿名方法存储在委托变量中，然后将此委托添加到该事件中。一般来说，如果必须在后面的代码中取消订阅某个事件，则建议您不要使用匿名函数订阅此事件。

取消订阅

要防止在引发事件时调用事件处理程序，请取消订阅该事件。要防止资源泄露，应在释放订户对象之前取消订阅事件。在取消订阅事件之前，在发布对象中作为该事件的基础的多路广播委托会引用封装了订户的事件处理程序的委托。只要发布对象保持该引用，垃圾回收功能就不会删除订户对象。

取消订阅事件

使用减法赋值运算符 (-=) 取消订阅事件：

publisher.RaiseCustomEvent -= HandleCustomEvent;