Freigeben über


ICallbackEventHandler Schnittstelle

Definition

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

Hinweise

Implementieren Sie die ICallbackEventHandler Schnittstelle für jedes benutzerdefinierte Steuerelement, das Rückrufereignisse empfangen muss. 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 Daten während des Rückrufs 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, überprüft werden. Die Validierung von Ereignissen ist eine gute Sicherheitsmethode. 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 Settings Schema) 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 Ereignisvalidierung 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.

Gilt für:

Weitere Informationen