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)