BaseDataBoundControl.OnDataBound(EventArgs) Methode

Definition

Löst das DataBound-Ereignis aus.Raises the DataBound event.

protected:
 virtual void OnDataBound(EventArgs ^ e);
protected virtual void OnDataBound (EventArgs e);
abstract member OnDataBound : EventArgs -> unit
override this.OnDataBound : EventArgs -> unit
Protected Overridable Sub OnDataBound (e As EventArgs)

Parameter

e
EventArgs

Ein EventArgs-Objekt, das die Ereignisdaten enthält.An EventArgs object that contains the event data.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, OnDataBound wie die-Methode verwendet wird DataBound , um das-Ereignis durch eine abgeleitete, Daten gebundene Steuerelement Klasse zu erhöhen.The following code example demonstrates how the OnDataBound method is used to raise the DataBound event by a derived data-bound control class. Nachdem die GetData -Methode und die-Methode zum Binden von Daten an das Steuerelement verwendet wurden, DataBound löst das Daten gebundene Steuerelement das- PerformDataBinding Ereignis aus, um zu signalisieren, dass die DatenbindungAfter using the GetData and PerformDataBinding methods to bind data to the control, the data-bound control raises the DataBound event to signal that data binding is complete. Dieses Codebeispiel ist Teil eines größeren Beispiels, das für die DataBoundControl -Klasse bereitgestellt wird.This code example is part of a larger example provided for the DataBoundControl class.

protected override void PerformSelect() {            

   // Call OnDataBinding here if bound to a data source using the
   // DataSource property (instead of a DataSourceID), because the
   // databinding statement is evaluated before the call to GetData.       
    if (! IsBoundUsingDataSourceID) {
        OnDataBinding(EventArgs.Empty);
    }            
    
    // The GetData method retrieves the DataSourceView object from  
    // the IDataSource associated with the data-bound control.            
    GetData().Select(CreateDataSourceSelectArguments(), 
        OnDataSourceViewSelectCallback);
    
    // The PerformDataBinding method has completed.
    RequiresDataBinding = false;
    MarkAsDataBound();
    
    // Raise the DataBound event.
    OnDataBound(EventArgs.Empty);
}
Protected Overrides Sub PerformSelect()

    ' Call OnDataBinding here if bound to a data source using the 
    ' DataSource property (instead of a DataSourceID) because the 
    ' data-binding statement is evaluated before the call to GetData.
    If Not IsBoundUsingDataSourceID Then
        OnDataBinding(EventArgs.Empty)
    End If

    ' The GetData method retrieves the DataSourceView object from the 
    ' IDataSource associated with the data-bound control.            
    GetData().Select(CreateDataSourceSelectArguments(), _
        AddressOf OnDataSourceViewSelectCallback)

    ' The PerformDataBinding method has completed.
    RequiresDataBinding = False
    MarkAsDataBound()

    ' Raise the DataBound event.
        OnDataBound(EventArgs.Empty)

End Sub

Hinweise

Diese Methode benachrichtigt ein Server Steuerelement, dass jede dem Steuerelement zugeordnete Daten Bindungs Logik abgeschlossen wurde.This method notifies a server control that any data binding logic associated with the control has completed.

Wichtig

Die DataBind -Methode ist für alle Steuerelemente versiegelt BaseDataBoundControl, die von abgeleitet werden.The DataBind method is sealed on all controls derived from BaseDataBoundControl. Daten gebundene Steuerelemente sollten anstelle PerformDataBinding DataBind der-Methode überschreiben, um Daten zu binden.Data-bound controls should override PerformDataBinding instead of the DataBind method to bind data. Wenn DataBind überschrieben wird, werden OnDataBinding das OnDataBound -Ereignis und das-Ereignis außerhalb der Reihenfolge ausgelöst.If DataBind is overridden, the OnDataBinding and OnDataBound events are raised out of order.

Durch das Auslösen eines Ereignisses wird der Ereignishandler über einen Delegaten aufgerufen.Raising an event invokes the event handler through a delegate. Weitere Informationen finden Sie unter Behandeln und Auslösen von Ereignissen.For more information, see Handling and Raising Events.

Mit der OnDataBound-Methode können auch abgeleitete Klassen das Ereignis ohne Anfügen eines Delegaten behandeln.The OnDataBound method also allows derived classes to handle the event without attaching a delegate. Dies ist das bevorzugte Verfahren für die Behandlung des Ereignisses in einer abgeleiteten Klasse.This is the preferred technique for handling the event in a derived class.

Hinweise für Vererber

Stellen Sie beim Überschreiben OnDataBound(EventArgs) ineinerabgeleitetenKlassesicher,dassdie-MethodederBasisklasseaufgerufenwird,damitregistrierteDelegatendasEreignisempfangen.OnDataBound(EventArgs)When overriding OnDataBound(EventArgs) in a derived class, be sure to call the base class' OnDataBound(EventArgs) method so that registered delegates receive the event.

Gilt für:

Siehe auch