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
Implementujte ICallbackEventHandler rozhraní pro libovolný vlastní ovládací prvek, který potřebuje přijímat události zpětného volání. Další informace naleznete v tématu implementace zpětných volání klienta bez zpětného odeslání.
Příklady ovládacích prvků, které implementují ICallbackEventHandler rozhraní GridView , zahrnují DetailsView TreeView ovládací prvky, a. 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í argumentu události jako parametru a GetCallbackResult 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í, mohou postupovat synchronně nebo asynchronně. ASP.NET ovládací prvky jako GridView , DetailsView a TreeView jsou implementovány synchronně. Synchronní zpětná volání nebrání uživateli v práci v prohlížeči. V synchronním režimu může být spuštěno pouze jedno zpětné volání v čase, přičemž poslední zpětné volání má přednost. Pokud je webový ovládací prvek implementován pro podporu asynchronního chování, lze vyvolat více zpětných volání současně. Podrobnosti o asynchronním programování naleznete v tématu asynchronní vzor založený na událostech (EAP).
Můžete určit, zda mají být ověřovány události zpětného volání pocházející z uživatelského rozhraní vykresleného ovládacím prvkem, který implementuje ICallbackEventHandler rozhraní. Ověření událostí je dobrým zvykem zabezpečení. Z důvodů výkonu ale můžete je 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 atributu elementu pages (schéma nastavení ASP.NET) souboru Web.config. Pokud nastavíte EnableEventValidation vlastnost v kódu, nastavte ji ve Page_Init fázi zpracování stránky. Další informace o vyrovnání výhod zabezpečení při ověřování událostí s náklady na výkon najdete v tématu ASP.NET Performance Overview.
Metody
| GetCallbackResult() |
Vrátí výsledky události zpětného volání, která cílí na ovládací prvek. |
| RaiseCallbackEvent(String) |
Zpracuje událost zpětného volání, která cílí na ovládací prvek. |