Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / C#

System.EventArgs — podatki dogodka

System.EventArgs je osnovni razred, ki se uporablja v standardnem vzorcu dogodkov .NET. Lasten izpeljani razred prenaša podatke obravnavalnikom, EventArgs.Empty pa se uporablja pri proženju dogodkov brez dodatnih podatkov.

Različica: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification

Sintaksa

public class EventArgs
public class MessageEventArgs : EventArgs
public event EventHandler<MessageEventArgs>? MessageReceived;

System.EventArgs je razred knjižnice .NET, ne ključna beseda jezika C#. V standardnem vzorcu dogodkov je osnovni razred za razrede, ki hranijo podatke dogodka. Sam ne določa lastnosti za podatke aplikacije; njegov javni konstruktor EventArgs() ustvari prazen primerek. Na voljo je v .NET 10 in v tej različici ni novost.

Za prenos podatkov določite izpeljani razred, katerega ime se konča z EventArgs, na primer MessageEventArgs, in dodajte potrebne lastnosti. Dogodek EventHandler<MessageEventArgs> obravnavalniku posreduje dva argumenta: sender, vir dogodka, in e, podatke. Izpeljava iz EventArgs je konvencija tega vzorca, ne splošna zahteva za vsak dogodek v C#.

Če dogodek ne prenaša dodatnih podatkov, uporabite EventHandler in polje EventArgs.Empty namesto null ali ustvarjanja dodatnega praznega predmeta. EventArgs opisuje podatke, medtem ko delegat EventHandler opisuje podpis obravnavalnika — to sta različni vlogi.

V primeru MessageReceived posreduje besedilo prek lastnosti samo za branje, Completed pa uporablja EventArgs.Empty. this označuje vir obeh dogodkov; ?.Invoke preskoči klic, če ni naročnikov. Pričakovani izhod je najprej Hello, nato Completed.

Primeri

#nullable enable
using System;

var source = new MessageSource();
source.MessageReceived += (sender, e) => Console.WriteLine(e.Message);
source.Completed += (sender, e) => Console.WriteLine("Completed");
source.Run();

public sealed class MessageEventArgs : EventArgs
{
    public MessageEventArgs(string message) => Message = message;
    public string Message { get; }
}

public sealed class MessageSource
{
    public event EventHandler<MessageEventArgs>? MessageReceived;
    public event EventHandler? Completed;

    public void Run()
    {
        MessageReceived?.Invoke(this, new MessageEventArgs("Hello"));
        Completed?.Invoke(this, EventArgs.Empty);
    }
}

Rezultat

Hello
Completed

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri