BaseDataBoundControl.OnDataBound(EventArgs) Método

Definición

Espacio de nombres:

System.Web.UI.WebControls

Ensamblado:

System.Web.dll

Genera el evento 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)

Parámetros

e

EventArgs

Objeto EventArgs que contiene los datos del evento.

Ejemplos

En el ejemplo de código siguiente se muestra cómo se usa el OnDataBound método para generar el DataBound evento mediante una clase de control enlazada a datos derivada. Después de usar los GetData métodos y PerformDataBinding para enlazar datos al control, el control enlazado a datos genera el DataBound evento para indicar que el enlace de datos está completo. Este ejemplo de código es parte de un ejemplo más grande proporcionado para la clase DataBoundControl.

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

Comentarios

Este método notifica a un control de servidor que se ha completado cualquier lógica de enlace de datos asociada al control.

Importante

El DataBind método está sellado en todos los controles derivados de BaseDataBoundControl. Los controles enlazados a datos deben invalidar en PerformDataBinding lugar del DataBind método para enlazar datos. Si DataBind se invalida, los OnDataBinding eventos y OnDataBound se generan de forma desordenada.

Cuando se genera un evento, se invoca el controlador de eventos a través de un delegado. Para obtener más información, consulte controlar y provocar eventos.

El método OnDataBound también permite que las clases derivadas controlen el evento sin adjuntar ningún delegado. Ésta es la técnica preferida para controlar el evento en una clase derivada.

Notas a los desarrolladores de herederos

Al invalidar OnDataBound(EventArgs) en una clase derivada, asegúrese de llamar al método de OnDataBound(EventArgs) la clase base para que los delegados registrados reciban el evento.

Consulte también

• OnDataBinding(EventArgs)