BaseDataBoundControl.OnDataBound(EventArgs) Methode

Definitie

Naamruimte:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Hiermee wordt de DataBound gebeurtenis gegenereerd.

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)

Parameters

e
EventArgs

Een EventArgs object dat de gebeurtenisgegevens bevat.

Voorbeelden

In het volgende codevoorbeeld ziet u hoe de methode wordt gebruikt om de OnDataBoundDataBound gebeurtenis te genereren door een afgeleide gegevensgebonden besturingsklasse. Nadat u de GetData en PerformDataBinding methoden hebt gebruikt om gegevens aan het besturingselement te binden, wordt de gebeurtenis gegenereerd door het DataBound gegevensgebonden besturingselement om aan te geven dat de gegevensbinding is voltooid. Dit codevoorbeeld maakt deel uit van een groter voorbeeld voor de DataBoundControl klasse.

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

Opmerkingen

Met deze methode wordt een serverbesturingselement aangegeven dat alle logica voor gegevensbinding die aan het besturingselement is gekoppeld, is voltooid.

Important

De DataBind methode wordt verzegeld voor alle besturingselementen die zijn afgeleid van BaseDataBoundControl. Gegevensgebonden besturingselementen moeten worden overschreven PerformDataBinding in plaats van de DataBind methode om gegevens te binden. Als DataBind dit wordt overschreven, worden de OnDataBinding gebeurtenissen OnDataBound buiten de orde gesteld.

Als u een gebeurtenis aanroept, wordt de gebeurtenis-handler via een gemachtigde aangeroepen. Zie Afhandeling en het genereren van gebeurtenissen voor meer informatie.

Met OnDataBound de methode kunnen afgeleide klassen de gebeurtenis ook verwerken zonder een gemachtigde te koppelen. Dit is de voorkeurstechniek voor het verwerken van de gebeurtenis in een afgeleide klasse.

Notities voor overnemers

Wanneer u OnDataBound(EventArgs) overschrijft in een afgeleide klasse, moet u de methode van de basisklasse OnDataBound(EventArgs) aanroepen, zodat geregistreerde gemachtigden de gebeurtenis ontvangen.

Van toepassing op

Zie ook