ICallbackEventHandler Schnittstelle
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Wird verwendet, um anzugeben, dass ein Steuerelement Ziel eines Rückrufereignisses auf dem Server sein kann.
public interface class ICallbackEventHandlerpublic interface ICallbackEventHandlertype ICallbackEventHandler = interfacePublic 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. |
