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 zum Auslösen des DataBound Ereignisses durch eine abgeleitete datengebundene Steuerelementklasse verwendet wird. Nachdem die GetData Daten und Methoden zum Binden von Daten an das Steuerelement verwendet wurden PerformDataBinding , 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 alle datenbindungslogik, die dem Steuerelement zugeordnet ist, abgeschlossen ist.

Important

Die DataBind Methode ist für alle steuerelemente versiegelt, die von BaseDataBoundControl. Datengebundene Steuerelemente sollten anstelle der DataBind Methode zum Binden von Daten außer Kraft setzenPerformDataBinding. Wenn DataBind überschrieben wird, werden die OnDataBinding Ereignisse OnDataBound außer Ordnung ausgelöst.

Das Auslösen eines Ereignisses ruft den Ereignishandler über einen Delegaten auf. Weitere Informationen finden Sie unter Behandeln und Auslösen von Ereignissen.

Mit der OnDataBound Methode können abgeleitete Klassen auch das Ereignis behandeln, ohne einen Delegaten anzufügen. Dies ist die bevorzugte Technik für die Behandlung des Ereignisses in einer abgeleiteten Klasse.

Hinweise für Vererber

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

Gilt für:

Weitere Informationen