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 naleznete v tématu Implementace zpětných volání klienta bez postbacků.
Mezi příklady ovládacích prvků, které implementují ICallbackEventHandler rozhraní, patří GridView, DetailsViewa TreeView ovládací prvky. Když událost zpětného volání cílí na ovládací prvek, který implementuje ICallbackEventHandler rozhraní, RaiseCallbackEvent metoda je volána pro zpracování události, předání argumentu události jako parametr 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í, můžou provést synchronně nebo asynchronně. ASP.NET ovládací prvky, jako GridViewje , DetailsViewa TreeView jsou implementovány synchronně. Synchronní zpětné volání nezabrání uživateli v práci v prohlížeči. V synchronním režimu může být spuštěno vždy pouze jedno zpětné volání s předností poslední zpětného volání. Při implementaci webového ovládacího prvku 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é ovládacím prvku implementujícího ICallbackEventHandler rozhraní. Ověření událostí je dobrým postupem zabezpečení. Z důvodů výkonu ho ale můžete zakázat. Chcete-li určit, zda se provádí ověřování událostí u událostí zpětného volání, nastavte enableEventValidation atribut direktivy @ Page nebo enableEventValidation atribut elementu pages (ASP.NET Nastavení schématu) souboru Web.config. Pokud vlastnost nastavíte v kódu, nastavte EnableEventValidation ji ve Page_Init fázi zpracování stránky. Další informace o vyrovnávání výhod zabezpečení ověřování událostí s jeho náklady na výkon najdete v tématu ASP.NET Přehled výkonu.
Metody
| Name | Description |
|---|---|
| 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. |
