BaseDataBoundControl.OnDataBound(EventArgs) 方法

定义

命名空间:

System.Web.UI.WebControls

程序集:

System.Web.dll

引发 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)

参数

e

EventArgs

包含事件数据的 EventArgs 对象。

示例

下面的代码示例演示如何 OnDataBound 使用 方法由派生的数据绑定控件类引发 DataBound 事件。 使用 GetData 和 PerformDataBinding 方法将数据绑定到控件后，数据绑定控件将引发 DataBound 事件以指示数据绑定已完成。 此代码示例是为 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

注解

此方法通知服务器控件与控件关联的任何数据绑定逻辑已完成。

重要

方法 DataBind 在派生自 BaseDataBoundControl的所有控件上密封。 数据绑定控件应替代 PerformDataBinding 而不是 DataBind 方法以绑定数据。 如果 DataBind 重写 ，则 OnDataBinding 和 OnDataBound 事件将无序引发。

引发事件时，将通过委托调用事件处理程序。 有关详细信息，请参阅 处理和引发事件。

OnDataBound 方法还允许派生类对事件进行处理而不必附加委托。 这是在派生类中处理事件的首选技术。

继承者说明

在派生类中重写 OnDataBound(EventArgs) 时，请务必调用基类的 OnDataBound(EventArgs) 方法，以便注册的委托接收 事件。

另请参阅

• OnDataBinding(EventArgs)