ICallbackEventHandler Rozhraní

Definice

Obor názvů:

System.Web.UI

Sestavení:

System.Web.dll

Slouží k označení, že ovládací prvek může být cílem události zpětného volání na serveru.

public interface class ICallbackEventHandler

public interface ICallbackEventHandler

type ICallbackEventHandler = interface

Public Interface ICallbackEventHandler

Odvozené

System.Web.UI.WebControls.DetailsView

System.Web.UI.WebControls.GridView

System.Web.UI.WebControls.TreeView

Poznámky

ICallbackEventHandler Implementujte rozhraní pro jakýkoli vlastní ovládací prvek, který potřebuje přijímat události zpětného volání. Další informace najdete v tématu Implementace klientských zpětných volání bez zpětného volání.

Příklady ovládacích prvků, které implementují ICallbackEventHandler rozhraní, zahrnují GridViewovládací prvky , DetailsViewa TreeView . Když událost zpětného volání cílí na ovládací prvek, který implementuje ICallbackEventHandler rozhraní, RaiseCallbackEvent je volána metoda pro zpracování události, předáním argumentu události jako parametru GetCallbackResult a metoda vrátí výsledek zpětného volání.

Ovládací prvky, které načítají data z ovládacího prvku zdroje dat během zpětného volání, to mohou provádět synchronně nebo asynchronně. ASP.NET ovládací prvky jako GridView, DetailsViewa TreeView se implementují synchronně. Synchronní zpětná volání nezabrání uživateli v práci v prohlížeči. V synchronním režimu se může spustit pouze jedno zpětné volání najednou, přičemž poslední zpětné volání má přednost. Když je webový ovládací prvek implementován pro podporu asynchronního chování, lze současně vyvolat více zpětných volání. Podrobnosti o asynchronním programování najdete v tématu Asynchronní vzor založený na událostech (EAP).

Můžete určit, zda se ověřují události zpětného volání pocházející z uživatelského rozhraní vykresleného ovládacím prvek implementující rozhraní ICallbackEventHandler . Ověřování událostí je dobrým postupem zabezpečení. Z důvodů výkonu ho ale můžete zakázat. Chcete-li určit, zda je ověřování událostí provedeno u událostí zpětného volání, nastavte enableEventValidation atribut direktivy @ Page nebo enableEventValidation atribut pages Element (ASP.NET Schéma nastavení) Web.config souboru. Pokud nastavíte EnableEventValidation vlastnost v kódu, nastavte ji ve Page_Init fázi zpracování stránky. Další informace o vyvážení výhod zabezpečení ověřování událostí a nákladů na výkon najdete v tématu přehled výkonu ASP.NET.

Metody

GetCallbackResult()	Vrátí výsledky události zpětného volání, která cílí na ovládací prvek.
RaiseCallbackEvent(String)	Zpracovává událost zpětného volání, která cílí na ovládací prvek.

Viz také

• GetCallbackEventReference
• ICallbackEventHandler.RaiseCallbackEvent(String)
• ICallbackEventHandler.RaiseCallbackEvent(String)
• ICallbackEventHandler.RaiseCallbackEvent(String)