BaseDataBoundControl.OnDataBound(EventArgs) Метод

Определение

Создает событие 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)

Параметры

e
EventArgs

Объект EventArgs, содержащий данные о событии.An EventArgs object that contains the event data.

Примеры

В следующем примере кода показано, как OnDataBound метод используется для DataBound вызова события с помощью производного класса элемента управления с привязкой к данным.The following code example demonstrates how the OnDataBound method is used to raise the DataBound event by a derived data-bound control class. После использования GetData методов и PerformDataBinding для привязки данных к элементу управления элемент управления с привязкой к данным вызывает DataBound событие для сигнализации о завершении привязки данных.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. Этот пример кода является частью большого примера, DataBoundControl приведенного для класса.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

Комментарии

Этот метод уведомляет серверный элемент управления о завершении любой логики привязки данных, связанной с элементом управления.This method notifies a server control that any data binding logic associated with the control has completed.

Важно!

Метод запечатан на всех элементах управления, производных от BaseDataBoundControl. DataBindThe DataBind method is sealed on all controls derived from BaseDataBoundControl. Для привязки данных элементы управления с PerformDataBinding привязкой к DataBind данным должны переопределяться вместо метода.Data-bound controls should override PerformDataBinding instead of the DataBind method to bind data. Если DataBind переопределен OnDataBound , события и вызываются не по порядку. OnDataBindingIf DataBind is overridden, the OnDataBinding and OnDataBound events are raised out of order.

При возникновении события через делегат вызывается обработчик события.Raising an event invokes the event handler through a delegate. Дополнительные сведения см. в разделе обработка и вызов событий.For more information, see Handling and Raising Events.

Метод OnDataBound также позволяет производным классам обрабатывать событие, не присоединяя делегат.The OnDataBound method also allows derived classes to handle the event without attaching a delegate. Это предпочтительная методика обработки событий в производном классе.This is the preferred technique for handling the event in a derived class.

Примечания для тех, кто наследует этот метод

При переопределении OnDataBound(EventArgs) в производном классе обязательно вызовите OnDataBound(EventArgs) метод базового класса, чтобы зарегистрированные делегаты получили событие.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.

Применяется к

Дополнительно