BaseDataBoundControl.OnDataBound(EventArgs) Metod

Definition

Namnområde:
System.Web.UI.WebControls
Sammansättning:
System.Web.dll

Genererar händelsen DataBound .

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)

Parametrar

e
EventArgs

Ett EventArgs objekt som innehåller händelsedata.

Exempel

Följande kodexempel visar hur OnDataBound metoden används för att generera DataBound händelsen av en härledd databunden kontrollklass. När du har använt GetData metoderna och PerformDataBinding för att binda data till kontrollen genererar DataBound den databundna kontrollen händelsen för att signalera att databindningen är klar. Det här kodexemplet är en del av ett större exempel för DataBoundControl klassen.

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

Kommentarer

Den här metoden meddelar en serverkontroll som all databindningslogik som är associerad med kontrollen har slutförts.

Important

Metoden DataBind är förseglad för alla kontroller som härletts från BaseDataBoundControl. Databundna kontroller bör åsidosättas PerformDataBindingDataBind i stället för metoden för att binda data. Om DataBind åsidosättas OnDataBinding , och OnDataBound händelser höjs ur ordning.

När du skapar en händelse anropas händelsehanteraren via ett ombud. Mer information finns i Hantera och höja händelser.

Metoden OnDataBound gör det också möjligt för härledda klasser att hantera händelsen utan att koppla ett ombud. Det här är den bästa tekniken för att hantera händelsen i en härledd klass.

Anteckningar till arvingar

När du OnDataBound(EventArgs) åsidosätter i en härledd klass måste du anropa basklassmetoden OnDataBound(EventArgs) så att registrerade ombud tar emot händelsen.

Gäller för

Se även