Справочник по C#. eventevent (C# reference)

  • Время чтения: 4 мин

Ключевое слово event используется для объявления события в классе Publisher.The event keyword is used to declare an event in a publisher class.

ПримерExample

Следующий пример демонстрирует объявление и вызов события, которое использует EventHandler как базовый тип делегата.The following example shows how to declare and raise an event that uses EventHandler as the underlying delegate type. См. полный пример кода, демонстрирующий использование универсального типа делегата EventHandler<TEventArgs>, создание подписки на событие и создание метода обработчика событий, в руководстве по публикации событий, соответствующих рекомендациям .NET Framework.For the complete code example that also shows how to use the generic EventHandler<TEventArgs> delegate type and how to subscribe to an event and create an event handler method, see How to publish events that conform to .NET Framework Guidelines.

public class SampleEventArgs
{
    public SampleEventArgs(string s) { Text = s; }
    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"));
    }
}

События представляют собой специальный вид многоадресного делегата, который можно вызвать только из класса или структуры, в которых он объявлен (класс Publisher).Events are a special kind of multicast delegate that can only be invoked from within the class or struct where they are declared (the publisher class). Если другие классы или структуры подписываются на событие, их методы обработчиков событий будут вызываться, когда класс Publisher будет вызывать событие.If other classes or structs subscribe to the event, their event handler methods will be called when the publisher class raises the event. Дополнительные сведения и примеры кода см. в разделах События и Делегаты.For more information and code examples, see Events and Delegates.

События могут иметь пометку public, private, protected, internal, protected internal или private protected.Events can be marked as public, private, protected, internal, protected internal, or private protected. Эти модификаторы доступа определяют, каким образом пользователи класса смогут получать доступ к событию.These access modifiers define how users of the class can access the event. Дополнительные сведения см. в статье Модификаторы доступа.For more information, see Access Modifiers.

Ключевые слова и событияKeywords and events

Следующие ключевые слова применяются к событиям.The following keywords apply to events.

Ключевое словоKeyword ОписаниеDescription Дополнительные сведенияFor more information
staticstatic Делает событие доступным для вызывающих объектов в любое время, даже если экземпляр класса не существует.Makes the event available to callers at any time, even if no instance of the class exists. Статические классы и члены статических классовStatic Classes and Static Class Members
virtualvirtual Позволяет производным классам переопределять поведение события с помощью ключевого слова override.Allows derived classes to override the event behavior by using the override keyword. НаследованиеInheritance
sealedsealed Указывает, что для производных классов оно больше не является виртуальным.Specifies that for derived classes it is no longer virtual.
abstractabstract Компилятор не будет создавать блоки доступа к событиям add и remove, и поэтому производные классы должны предоставлять собственную реализацию.The compiler will not generate the add and remove event accessor blocks and therefore derived classes must provide their own implementation.

Событие может быть объявлено как статическое событие с помощью ключевого слова static.An event may be declared as a static event by using the static keyword. Это делает событие доступным для вызывающих объектов в любое время, даже если экземпляр класса не существует.This makes the event available to callers at any time, even if no instance of the class exists. Дополнительные сведения см. в статье Статические классы и члены статических классов.For more information, see Static Classes and Static Class Members.

Событие может быть помечено как виртуальное событие с помощью ключевого слова virtual.An event can be marked as a virtual event by using the virtual keyword. Это позволяет производным классам переопределять поведение события с помощью ключевого слова override.This enables derived classes to override the event behavior by using the override keyword. Дополнительные сведения см. в разделе Наследование.For more information, see Inheritance. Событие, переопределяющее виртуальное событие, также может быть запечатанным (sealed), что указывает, что для производных классов оно больше не является виртуальным.An event overriding a virtual event can also be sealed, which specifies that for derived classes it is no longer virtual. И наконец, можно объявить событие абстрактным (abstract), что означает, что компилятор не будет создавать блоки доступа к событиям add и remove.Lastly, an event can be declared abstract, which means that the compiler will not generate the add and remove event accessor blocks. Поэтому производные классы должны предоставлять собственную реализацию.Therefore derived classes must provide their own implementation.

Спецификация языка C#C# language specification

Дополнительные сведения см. в спецификации языка C#.For more information, see the C# Language Specification. Спецификация языка является предписывающим источником информации о синтаксисе и использовании языка C#.The language specification is the definitive source for C# syntax and usage.

См. такжеSee also