BaseDataBoundControl.OnDataBound(EventArgs) Metoda

Definicja

Podnosi DataBound zdarzenie.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)

Parametry

e
EventArgs

EventArgsObiekt, który zawiera dane zdarzenia.An EventArgs object that contains the event data.

Przykłady

Poniższy przykład kodu demonstruje, jak OnDataBound Metoda jest używana do podniesienia DataBound zdarzenia przez pochodną klasę formantu powiązanego z danymi.The following code example demonstrates how the OnDataBound method is used to raise the DataBound event by a derived data-bound control class. Po użyciu GetData metod i PerformDataBinding , aby powiązać dane z kontrolką, formant powiązany z danymi wywołuje DataBound zdarzenie, aby sygnalizować zakończenie wiązania danych.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. Ten przykład kodu jest częścią większego przykładu dostarczonego dla DataBoundControl klasy.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

Uwagi

Ta metoda powiadamia formant serwera o zakończeniu każdej logiki powiązania danych skojarzonej z kontrolką.This method notifies a server control that any data binding logic associated with the control has completed.

Ważne

DataBindMetoda jest zapieczętowana dla wszystkich kontrolek pochodnych BaseDataBoundControl .The DataBind method is sealed on all controls derived from BaseDataBoundControl. Formanty powiązane z danymi powinny zostać przesłonięte PerformDataBinding zamiast DataBind metody, aby powiązać dane.Data-bound controls should override PerformDataBinding instead of the DataBind method to bind data. Jeśli DataBind zostanie zastąpiona, OnDataBinding OnDataBound zdarzenia i są wywoływane poza kolejnością.If DataBind is overridden, the OnDataBinding and OnDataBound events are raised out of order.

Podnoszenie zdarzenia wywołuje program obsługi zdarzeń przez delegata.Raising an event invokes the event handler through a delegate. Aby uzyskać więcej informacji, zobacz Obsługa iwywoływanie zdarzeń.For more information, see Handling and Raising Events.

OnDataBoundMetoda umożliwia również klasom pochodnym obsłużenia zdarzenia bez dołączania delegata.The OnDataBound method also allows derived classes to handle the event without attaching a delegate. Jest to preferowana technika obsługi zdarzenia w klasie pochodnej.This is the preferred technique for handling the event in a derived class.

Uwagi dotyczące dziedziczenia

Podczas zastępowania OnDataBound(EventArgs) klasy pochodnej należy wywołać metodę klasy bazowej, OnDataBound(EventArgs) Aby zarejestrowani pełnomocnicy otrzymywali zdarzenie.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.

Dotyczy

Zobacz też