ICallbackEventHandler Schnittstelle

Definition

Namespace:

System.Web.UI

Assembly:

System.Web.dll

Wird verwendet, um anzugeben, dass ein Steuerelement Ziel eines Rückrufereignisses auf dem Server sein kann.

public interface class ICallbackEventHandler

public interface ICallbackEventHandler

type ICallbackEventHandler = interface

Public Interface ICallbackEventHandler

Abgeleitet

System.Web.UI.WebControls.DetailsView

System.Web.UI.WebControls.GridView

System.Web.UI.WebControls.TreeView

Hinweise

Implementieren Sie die ICallbackEventHandler Schnittstelle für alle benutzerdefinierten Steuerelemente, die Rückrufereignisse empfangen müssen. Weitere Informationen finden Sie unter Implementieren von Clientrückrufen ohne Postbacks.

Beispiele für Steuerelemente, die die ICallbackEventHandler Schnittstelle implementieren, sind die GridViewSteuerelemente , DetailsViewund TreeView . Wenn ein Rückrufereignis auf ein Steuerelement abzielt, das die ICallbackEventHandler Schnittstelle implementiert, wird die RaiseCallbackEvent -Methode aufgerufen, um das Ereignis zu behandeln. Dabei wird das Ereignisargument als Parameter übergeben, und die GetCallbackResult Methode gibt das Ergebnis des Rückrufs zurück.

Steuerelemente, die Während des Rückrufs Daten aus einem Datenquellensteuerelement abrufen, können dies synchron oder asynchron tun. ASP.NET Steuerelemente wie GridView, DetailsViewund TreeView werden synchron implementiert. Synchrone Rückrufe hindern den Benutzer nicht daran, im Browser zu arbeiten. Im synchronen Modus kann jeweils nur ein Rückruf ausgeführt werden, wobei der letzte Rückruf Vorrang hat. Wenn ein Websteuerelement implementiert wird, um asynchrones Verhalten zu unterstützen, können mehrere Rückrufe gleichzeitig ausgelöst werden. Ausführliche Informationen zur asynchronen Programmierung finden Sie unter Ereignisbasiertes asynchrones Muster (EAP).

Sie können angeben, ob Rückrufereignisse, die von der Benutzeroberfläche stammen, die von einem Steuerelement, das die ICallbackEventHandler Schnittstelle implementiert, gerendert werden, überprüft werden. Die Überprüfung von Ereignissen ist eine gute Sicherheitspraxis. Aus Leistungsgründen können Sie sie jedoch deaktivieren. Um zu steuern, ob die Ereignisüberprüfung für Rückrufereignisse ausgeführt wird, legen Sie das enableEventValidation Attribut der @ Page-Anweisung oder das enableEventValidation Attribut des pages-Elements (ASP.NET Einstellungsschema) der Web.config-Datei fest. Wenn Sie die EnableEventValidation Eigenschaft im Code festlegen, legen Sie sie in der Phase der Page_Init Seitenverarbeitung fest. Weitere Informationen zum Ausgleich des Sicherheitsvorteils der Ereignisüberprüfung mit den Leistungskosten finden Sie unter ASP.NET Leistungsübersicht.

Methoden

GetCallbackResult()	Gibt die Ergebnisse eines Rückrufereignisses zurück, das ein Steuerelement als Ziel hat.
RaiseCallbackEvent(String)	Verarbeitet ein Rückrufereignis, das ein Steuerelement als Ziel hat.

Weitere Informationen

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