event（C# 参考） · MSDN C# 编程指南 & 参考手册 2015

# event（C# 参考） **event** 关键字用于在发行者类中声明事件。下面的示例演示如何声明和引发将 [EventHandler](https://msdn.microsoft.com/zh-cn/library/system.eventhandler.aspx) 用作基础委托类型的事件。有关演示如何使用泛型 [EventHandler<TEventArgs>](https://msdn.microsoft.com/zh-cn/library/db0etb8x.aspx) 委托类型、如何订阅事件以及如何创建事件处理程序方法的完整代码示例，请参见[如何：发布符合 .NET Framework 准则的事件（C# 编程指南）](https://msdn.microsoft.com/zh-cn/library/w369ty8x.aspx)。 ``` public class SampleEventArgs { public SampleEventArgs(string s) { Text = s; } public String Text {get; private set;} // readonly } public class Publisher { // Declare the delegate (if using non-generic pattern). public delegate void SampleEventHandler(object sender, SampleEventArgs e); // Declare the event. public event SampleEventHandler SampleEvent; // Wrap the event in a protected virtual method // to enable derived classes to raise the event. protected virtual void RaiseSampleEvent() { // Raise the event by using the () operator. if (SampleEvent != null) SampleEvent(this, new SampleEventArgs("Hello")); } } ``` 事件是特殊类型的多路广播委托，仅可从声明它们的类或结构（发行者类）中调用。如果其他类或结构订阅了该事件，则当发行者类引发该事件时，会调用其事件处理程序方法。有关更多信息和代码示例，请参见[事件（C# 编程指南）](https://msdn.microsoft.com/zh-cn/library/awbftdfh.aspx) 和[委托（C# 编程指南）](https://msdn.microsoft.com/zh-cn/library/ms173171.aspx)。事件可标记为 [public](https://msdn.microsoft.com/zh-cn/library/yzh058ae.aspx)、[private](https://msdn.microsoft.com/zh-cn/library/st6sy9xe.aspx)、[protected](https://msdn.microsoft.com/zh-cn/library/bcd5672a.aspx)、[internal](https://msdn.microsoft.com/zh-cn/library/7c5ka91b.aspx) 或 **protected****internal**。这些访问修饰符定义类的用户访问事件的方式。有关更多信息，请参见 [访问修饰符（C# 编程指南）](https://msdn.microsoft.com/zh-cn/library/ms173121.aspx)。 ## 关键字和事件下面的关键字可应用于事件。 | 关键字 | 说明 | 更多信息 | | --- | --- | --- | | [static](https://msdn.microsoft.com/zh-cn/library/98f28cdx.aspx) | 即使类没有实例，调用方也能在任何时候使用该事件。 | [静态类和静态类成员（C# 编程指南）](https://msdn.microsoft.com/zh-cn/library/79b3xss3.aspx) | | [virtual](https://msdn.microsoft.com/zh-cn/library/9fkccyh4.aspx) | 允许派生类通过使用 [override](https://msdn.microsoft.com/zh-cn/library/ebca9ah3.aspx) 关键字来重写事件行为。 | [继承（C# 编程指南）](https://msdn.microsoft.com/zh-cn/library/ms173149.aspx) | | [sealed](https://msdn.microsoft.com/zh-cn/library/88c54tsw.aspx) | 指定对于派生类它不再属虚拟性质。 | | [abstract](https://msdn.microsoft.com/zh-cn/library/sf985hc5.aspx) | 编译器不会生成 **add** 和 **remove** 事件访问器块，因此派生类必须提供自己的实现。 | 通过使用 [static](https://msdn.microsoft.com/zh-cn/library/98f28cdx.aspx) 关键字，可以将事件声明为静态事件。即使类没有任何实例，调用方也能在任何时候使用静态事件。有关更多信息，请参见 [静态类和静态类成员（C# 编程指南）](https://msdn.microsoft.com/zh-cn/library/79b3xss3.aspx)。通过使用 [virtual](https://msdn.microsoft.com/zh-cn/library/9fkccyh4.aspx) 关键字，可以将事件标记为虚拟事件。这样，派生类就可以通过使用 [override](https://msdn.microsoft.com/zh-cn/library/ebca9ah3.aspx) 关键字来重写事件行为。有关更多信息，请参见 [继承（C# 编程指南）](https://msdn.microsoft.com/zh-cn/library/ms173149.aspx)。重写虚事件的事件也可以为 [sealed](https://msdn.microsoft.com/zh-cn/library/88c54tsw.aspx)，以表示其对于派生类不再是虚事件。最后，可以将事件声明为 [abstract](https://msdn.microsoft.com/zh-cn/library/sf985hc5.aspx)，这意味着编译器不会生成 **add** 和 **remove** 事件访问器块。因此派生类必须提供其自己的实现。 ## C# 语言规范有关详细信息，请参阅 [C# 语言规范](https://msdn.microsoft.com/zh-cn/library/ms228593.aspx)。该语言规范是 C# 语法和用法的权威资料。 ## 请参阅 [C# 参考](https://msdn.microsoft.com/zh-cn/library/618ayhy6.aspx) [C# 编程指南](https://msdn.microsoft.com/zh-cn/library/67ef8sbd.aspx) [C# 关键字](https://msdn.microsoft.com/zh-cn/library/x53a06bb.aspx) [add（C# 参考）](https://msdn.microsoft.com/zh-cn/library/cc713648.aspx) [remove（C# 参考）](https://msdn.microsoft.com/zh-cn/library/cc713642.aspx) [修饰符（C# 参考）](https://msdn.microsoft.com/zh-cn/library/6tcf2h8w.aspx) [如何：合并委托（多路广播委托）（C# 编程指南）](https://msdn.microsoft.com/zh-cn/library/ms173175.aspx)