BaseDataBoundControl.OnDataBound(EventArgs) Método

Definição

Espaço de Nomes:
System.Web.UI.WebControls
Assemblagem:
System.Web.dll

Eleva o DataBound evento.

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

Um objeto que contém os dados do EventArgs evento.

Exemplos

O exemplo de código seguinte demonstra como o OnDataBound método é usado para elevar o DataBound evento por uma classe de controlo derivada baseada em dados. Após usar os GetData métodos e PerformDataBinding para ligar dados ao controlo, o controlo data-bound levanta o DataBound evento para sinalizar que a ligação de dados está concluída. Este exemplo de código faz parte de um exemplo maior fornecido para a DataBoundControl classe.

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

Observações

Este método notifica o controlo do servidor que qualquer lógica de ligação de dados associada ao controlo foi concluída.

Importante

O DataBind método é selado em todos os controlos derivados de BaseDataBoundControl. Os controlos vinculados aos dados devem sobrepor-se PerformDataBinding em vez do DataBind método para ligar dados. Se DataBind for sobreposto, os OnDataBinding eventos e OnDataBound são levantados fora de ordem.

Levantar um evento invoca o gestor de eventos através de um delegado. Para mais informações, consulte Manuseio e Levantamento de Eventos.

O OnDataBound método também permite que classes derivadas tratem do evento sem anexar um delegado. Esta é a técnica preferida para lidar com o evento numa classe derivada.

Notas para Herdeiros

Ao substituir OnDataBound(EventArgs) uma classe derivada, certifique-se de chamar o método da OnDataBound(EventArgs) classe base para que os delegados registados recebam o evento.

Aplica-se a

Ver também