BaseDataBoundControl.OnDataBound(EventArgs) BaseDataBoundControl.OnDataBound(EventArgs) BaseDataBoundControl.OnDataBound(EventArgs) BaseDataBoundControl.OnDataBound(EventArgs) Method

Definición

Genera el evento DataBound.Raises the DataBound event.

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 EventArgs EventArgs EventArgs

Objeto EventArgs que contiene los datos del evento.An EventArgs object that contains the event data.

Ejemplos

En el ejemplo de código siguiente se OnDataBound muestra cómo se utiliza el método DataBound para generar el evento mediante una clase derivada de un control enlazado a datos.The following code example demonstrates how the OnDataBound method is used to raise the DataBound event by a derived data-bound control class. Después de usar GetData los PerformDataBinding métodos y para enlazar datos al control, el control enlazado a datos DataBound genera el evento para indicar que el enlace de datos se ha completado.After using the GetData and PerformDataBinding methods to bind data to the control, the data-bound control raises the DataBound event to signal that data binding is complete. Este ejemplo de código forma parte de un ejemplo más extenso proporcionado DataBoundControl para la clase.This code example is part of a larger example provided for the DataBoundControl class.

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.This method notifies a server control that any data binding logic associated with the control has completed.

Importante

El DataBind método está sellado en todos los controles derivados BaseDataBoundControlde.The DataBind method is sealed on all controls derived from BaseDataBoundControl. Los controles enlazados a datos PerformDataBinding deben invalidar en DataBind lugar del método para enlazar datos.Data-bound controls should override PerformDataBinding instead of the DataBind method to bind data. Si DataBind se reemplaza, los OnDataBinding eventos y OnDataBound se generan de forma desordenada.If DataBind is overridden, the OnDataBinding and OnDataBound events are raised out of order.

Cuando se genera un evento, se invoca el controlador de eventos a través de un delegado.Raising an event invokes the event handler through a delegate. Para obtener más información, consulte controlar y provocar eventos.For more information, see Handling and Raising Events.

El método OnDataBound también permite que las clases derivadas controlen el evento sin adjuntar ningún delegado.The OnDataBound method also allows derived classes to handle the event without attaching a delegate. Ésta es la técnica preferida para controlar el evento en una clase derivada.This is the preferred technique for handling the event in a derived class.

Notas a los desarrolladores de herederos

Al reemplazar OnDataBound(EventArgs) en una clase derivada, asegúrese de llamar al OnDataBound(EventArgs) método de la clase base para que los delegados registrados reciban el evento.When overriding OnDataBound(EventArgs) in a derived class, be sure to call the base class' OnDataBound(EventArgs) method so that registered delegates receive the event.

Se aplica a

Consulte también: