ICallbackEventHandler Rozhraní
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
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 ICallbackEventHandlerpublic interface ICallbackEventHandlertype ICallbackEventHandler = interfacePublic Interface ICallbackEventHandler- Odvozené
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. |
