BaseDataBoundControl.OnDataBound(EventArgs) Methode

Definition

Namespace:

System.Web.UI.WebControls

Assembly:

System.Web.dll

Löst das DataBound-Ereignis aus.

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.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die OnDataBound -Methode verwendet wird, um das DataBound Ereignis durch eine abgeleitete datengebundene Steuerelementklasse auszulösen. Nachdem sie die Methoden und PerformDataBinding zum Binden von GetData Daten an das Steuerelement verwendet haben, löst das datengebundene Steuerelement das DataBound -Ereignis aus, um zu signalisieren, dass die Datenbindung abgeschlossen ist. Dieses Codebeispiel ist Teil eines größeren Beispiels, das für die DataBoundControl-Klasse bereitgestellt wird.

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 Serversteuerelement, dass eine dem Steuerelement zugeordnete Datenbindungslogik abgeschlossen wurde.

Wichtig

Die DataBind -Methode wird für alle von BaseDataBoundControlabgeleiteten Steuerelemente versiegelt. Datengebundene Steuerelemente sollten anstelle der DataBind Methode zum Binden von Daten außer Kraft gesetzt PerformDataBinding werden. Wenn DataBind überschrieben wird, werden die OnDataBinding Ereignisse und OnDataBound ungeordnet ausgelöst.

Durch das Auslösen eines Ereignisses wird der Ereignishandler über einen Delegaten aufgerufen. Weitere Informationen finden Sie unter Behandeln und Auslösen von Ereignissen.

Mit der OnDataBound-Methode können auch abgeleitete Klassen das Ereignis ohne Anfügen eines Delegaten behandeln. Dies ist das bevorzugte Verfahren für die Behandlung des Ereignisses in einer abgeleiteten Klasse.

Hinweise für Vererber

Achten Sie beim Überschreiben OnDataBound(EventArgs) in einer abgeleiteten Klasse darauf, die Methode der Basisklasse OnDataBound(EventArgs) aufzurufen, damit registrierte Delegaten das Ereignis empfangen.

Weitere Informationen

• OnDataBinding(EventArgs)