event (C# 参考)

借助事件成员，对象可以触发通知。 事件用户可以通过提供事件处理程序来附加事件的可执行代码。 event 关键字声明事件。 该事件属于委托类型。 当对象触发事件时，该事件将调用所有提供的事件处理程序。 事件处理程序是添加到事件的委托实例，并在引发事件时执行。 事件用户可以在事件上添加或删除其事件处理程序。

示例

下面的示例演示如何声明和引发使用 EventHandler 作为基础委托类型的事件。 要查看完整代码示例了解如何使用泛型 EventHandler<TEventArgs> 委托类型以及如何订阅事件并创建事件处理程序方法，请参阅如何发布符合 .NET 准则的事件。

public class SampleEventArgs
{
    public SampleEventArgs(string text) { Text = text; }
    public string Text { get; } // 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 in a thread-safe manner using the ?. operator.
        SampleEvent?.Invoke(this, new SampleEventArgs("Hello"));
    }
}

事件是一种特殊的多播委托，仅可以从声明事件的类（或派生类）或结构（发布服务器类）中对其进行调用。 如果其他类或结构订阅该事件，则在发布服务器类引发该事件时，将调用其事件处理程序方法。 有关详细信息和代码示例，请参阅事件和委托。

可以将事件标记为public、private、protected、internal、protected internal 或 private protected。 这些访问修饰符定义该类的用户访问该事件的方式。 有关详细信息，请参阅访问修饰符。

关键字和事件

下列关键字应用于事件。

可以通过使用静态关键字将事件声明为静态事件。 这可使事件可供调用方在任何时候进行调用，即使不存在类的实例。 有关详细信息，请参阅静态类和静态类成员。

可以通过使用虚拟关键字将事件标记为虚事件。 这可使派生类使用重写关键字重写事件行为。 有关详细信息，请参阅继承。 重写虚拟事件的事件也可以为密封，指定对于派生类，它不再是虚拟的。 最后，可以声明事件为抽象，这意味着编译器将不会生成 add 和 remove 事件访问器块。 因此，派生类必须提供其自己的实现。

C# 语言规范

有关详细信息，请参阅 C# 语言规范。 该语言规范是 C# 语法和用法的权威资料。

另请参阅

• C# 关键字
• add
• remove
• 修饰符
• 如何合并委托（多播委托）