ICallbackEventHandler ICallbackEventHandler ICallbackEventHandler ICallbackEventHandler Interface

Definition

Wird verwendet, um anzugeben, dass ein Steuerelement Ziel eines Rückrufereignisses auf dem Server sein kann.Used to indicate that a control can be the target of a callback event on the server.

public interface class ICallbackEventHandler
public interface ICallbackEventHandler
type ICallbackEventHandler = interface
Public Interface ICallbackEventHandler
Abgeleitet

Hinweise

Implementieren Sie ICallbackEventHandler die-Schnittstelle für alle benutzerdefinierten Steuerelemente, die Rückruf Ereignisse empfangen müssen.Implement the ICallbackEventHandler interface for any custom control that needs to receive callback events. Weitere Informationen finden Sie unter Implementieren von Client Rückrufen ohne Postbacks.For more information, see Implementing Client Callbacks Without Postbacks.

Beispiele für Steuerelemente, die ICallbackEventHandler die-Schnitt GridViewStelle implementieren, TreeView sind die Steuerelemente, DetailsViewund.Examples of controls that implement the ICallbackEventHandler interface include the GridView, DetailsView, and TreeView controls. Wenn ein Rückruf Ereignis ein Steuerelement als Ziel hat ICallbackEventHandler , das die RaiseCallbackEvent -Schnittstelle implementiert, wird die-Methode aufgerufen, um das-Ereignis zu behandeln GetCallbackResult , wobei das Ereignis Argument als Parameter übergeben wird und die Methode das Ergebnis des Rückrufs zurückgibt.When a callback event targets a control that implements the ICallbackEventHandler interface, the RaiseCallbackEvent method is called to handle the event, passing the event argument as a parameter and the GetCallbackResult method returns the result of the callback.

Steuerelemente, die während des Rückrufs Daten aus einem Datenquellen-Steuerelement abrufen, können dies synchron oder asynchron ausführen.Controls that retrieve data from a data source control during callback can do so synchronously or asynchronously. ASP.net-Steuer GridViewElemente DetailsViewwie, TreeView und werden synchron implementiert.ASP.NET controls like GridView, DetailsView, and TreeView are implemented synchronously. Synchrone Rückrufe verhindern nicht, dass der Benutzer im Browser arbeitet.Synchronous callbacks do not prevent the user from working in the browser. Im synchronen Modus kann nur jeweils ein Rückruf ausgeführt werden, wobei der letzte Rückruf Vorrang hat.In synchronous mode, only one callback at a time can execute, with the last callback taking precedence. Wenn ein websteuer Element implementiert wird, um asynchrones Verhalten zu unterstützen, können gleichzeitig mehrere Rückrufe ausgelöst werden.When a Web control is implemented to support asynchronous behavior, multiple callbacks can be raised simultaneously. Ausführliche Informationen zur asynchronen Programmierung finden Sie unter Ereignis basiertes asynchrones Muster (EAP).For details on asynchronous programming, see Event-based Asynchronous Pattern (EAP).

Sie können angeben, ob Rückruf Ereignisse von der Benutzeroberfläche, die von einem Steuerelement ICallbackEventHandler , das die-Schnittstelle implementiert, ausgelöst werden.You can specify whether callback events originating from the user interface rendered by a control implementing the ICallbackEventHandler interface are validated. Die Überprüfung von Ereignissen ist eine gute Sicherheitsmaßnahme.Validation of events is a good security practice. Aus Leistungsgründen können Sie Sie jedoch deaktivieren.However, for performance reasons you can disable it. Legen Sie das enableEventValidation -Attribut der @ Page -Direktive oder das enableEventValidation -Attribut des pages- Elements (ASP.NET Settings Schema) der Datei "Web. config" fest, um zu steuern, ob die Ereignis Validierung für Rückruf Ereignisse ausgeführt wird.To control whether event validation is performed on callback events, set the enableEventValidation attribute of the @ Page directive or the enableEventValidation attribute of the pages Element (ASP.NET Settings Schema) of the Web.config file. Wenn Sie die EnableEventValidation -Eigenschaft im Code festlegen, legen Sie Sie Page_Init in der Phase der Seiten Verarbeitung fest.If you set the EnableEventValidation property in code, set it in the Page_Init phase of page processing. Weitere Informationen zum Ausgleichen des Sicherheits Vorteils der Ereignis Überprüfung durch die Leistungskosten finden Sie unter ASP.NET Performance Overview.For more information on balancing the security benefit of event validation with its performance cost, see ASP.NET Performance Overview.

Methoden

GetCallbackResult() GetCallbackResult() GetCallbackResult() GetCallbackResult()

Gibt die Ergebnisse eines Rückrufereignisses zurück, das ein Steuerelement als Ziel hat.Returns the results of a callback event that targets a control.

RaiseCallbackEvent(String) RaiseCallbackEvent(String) RaiseCallbackEvent(String) RaiseCallbackEvent(String)

Verarbeitet ein Rückrufereignis, das ein Steuerelement als Ziel hat.Processes a callback event that targets a control.

Gilt für:

Siehe auch