event (odwołanie w C#)event (C# Reference)

event Słowo kluczowe jest używane do deklarowania zdarzenia w klasie wydawcy.The event keyword is used to declare an event in a publisher class.

PrzykładExample

Poniższy przykład pokazuje, jak zadeklarować i zgłosić zdarzenie używające EventHandler jako bazowego typu delegata.The following example shows how to declare and raise an event that uses EventHandler as the underlying delegate type. Aby zapoznać się z kompletnym przykładem kodu, który pokazuje również EventHandler<TEventArgs> , jak używać ogólnego typu delegata oraz jak subskrybować zdarzenie i utworzyć metodę procedury obsługi zdarzeń , zobacz How to: Publikuj zdarzenia zgodne z wytycznymi.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 by using the () operator.
        if (SampleEvent != null)
            SampleEvent(this, new SampleEventArgs("Hello"));
    }
}

Zdarzenia są specjalnym rodzajem delegatów multiemisji, który można wywołać tylko z poziomu klasy lub struktury, w której są zadeklarowane (Klasa wydawcy).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). Jeśli inne klasy lub struktury subskrybują zdarzenie, ich metody obsługi zdarzeń będą wywoływane, gdy Klasa wydawcy zgłasza zdarzenie.If other classes or structs subscribe to the event, their event handler methods will be called when the publisher class raises the event. Aby uzyskać więcej informacji i przykładów kodu, zobacz Events and delegats.For more information and code examples, see Events and Delegates.

Zdarzenia mogą być oznaczone jako publiczne, prywatne, chronione, wewnętrzne, chronione wewnętrznie lub chronione prywatnie.Events can be marked as public, private, protected, internal, protected internal or private protected. Te Modyfikatory dostępu definiują sposób, w jaki użytkownicy klasy mogą uzyskać dostęp do zdarzenia.These access modifiers define how users of the class can access the event. Aby uzyskać więcej informacji, zobacz Modyfikatory dostępu.For more information, see Access Modifiers.

Słowa kluczowe i zdarzeniaKeywords and Events

Poniższe słowa kluczowe mają zastosowanie do zdarzeń.The following keywords apply to events.

Słowo kluczoweKeyword OpisDescription Więcej informacjiFor more information
staticstatic Sprawia, że zdarzenie jest dostępne dla wywoływania w dowolnym momencie, nawet jeśli nie istnieje żadne wystąpienie klasy.Makes the event available to callers at any time, even if no instance of the class exists. Klasy statyczne i statyczne elementy członkowskie klasStatic Classes and Static Class Members
virtualvirtual Umożliwia klasom pochodnym przesłonięcie zachowania zdarzenia za pomocą słowa kluczowego override .Allows derived classes to override the event behavior by using the override keyword. DziedziczenieInheritance
sealedsealed Określa, że dla klas pochodnych nie jest już wirtualna.Specifies that for derived classes it is no longer virtual.
abstractabstract Kompilator nie będzie generował bloków dostępu add do remove zdarzeń i, dlatego klasy pochodne muszą zapewnić własną implementację.The compiler will not generate the add and remove event accessor blocks and therefore derived classes must provide their own implementation.

Zdarzenie może być zadeklarowane jako zdarzenie statyczne za pomocą słowa kluczowego static .An event may be declared as a static event by using the static keyword. To sprawia, że zdarzenie jest dostępne dla wywoływania w dowolnym momencie, nawet jeśli nie istnieje żadne wystąpienie klasy.This makes the event available to callers at any time, even if no instance of the class exists. Aby uzyskać więcej informacji, zobacz klasy statyczne i statyczne elementy członkowskie klas.For more information, see Static Classes and Static Class Members.

Zdarzenie może być oznaczone jako zdarzenie wirtualne przy użyciu słowa kluczowego Virtual .An event can be marked as a virtual event by using the virtual keyword. Dzięki temu klasy pochodne zastępują zachowanie zdarzeń za pomocą słowa kluczowego override .This enables derived classes to override the event behavior by using the override keyword. Aby uzyskać więcej informacji, Zobacz dziedziczenie.For more information, see Inheritance. Zdarzenie przesłaniające zdarzenie wirtualne może być również zapieczętowane, które określa, że dla klas pochodnych nie jest już wirtualna.An event overriding a virtual event can also be sealed, which specifies that for derived classes it is no longer virtual. Na koniec zdarzenie może być zadeklarowane jako abstract, co oznacza, że kompilator nie będzie generował bloków add dostępu remove do zdarzeń i.Lastly, an event can be declared abstract, which means that the compiler will not generate the add and remove event accessor blocks. W związku z tym klasy pochodne muszą dostarczać własne implementacje.Therefore derived classes must provide their own implementation.

Specyfikacja języka C#C# Language Specification

Aby uzyskać więcej informacji, zobacz Specyfikacja języka C#.For more information, see the C# Language Specification. Specyfikacja języka jest ostatecznym źródłem informacji o składni i użyciu języka C#.The language specification is the definitive source for C# syntax and usage.

Zobacz takżeSee also