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)