BaseDataBoundControl.OnDataBound(EventArgs) Method

Definition

Genera l'evento 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)

Parameters

e
EventArgs

Oggetto EventArgs contenente i dati dell'evento.An EventArgs object that contains the event data.

Examples

Nell'esempio di codice riportato di seguito viene illustrato come utilizzare il metodo OnDataBound per generare l'evento DataBound da una classe di controlli con associazione a dati derivata.The following code example demonstrates how the OnDataBound method is used to raise the DataBound event by a derived data-bound control class. Dopo aver usato i metodi GetData e PerformDataBinding per associare dati al controllo, il controllo con associazione a dati genera l'evento DataBound per segnalare che data binding è completo.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. Questo esempio di codice fa parte di un esempio più ampio fornito per la classe 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

Remarks

Questo metodo notifica a un controllo server che qualsiasi logica di data binding associata al controllo è stata completata.This method notifies a server control that any data binding logic associated with the control has completed.

Important

Il metodo DataBind è sealed in tutti i controlli derivati da BaseDataBoundControl.The DataBind method is sealed on all controls derived from BaseDataBoundControl. I controlli associati a dati devono eseguire l'override di PerformDataBinding al posto del metodo DataBind per associare i dati.Data-bound controls should override PerformDataBinding instead of the DataBind method to bind data. Se DataBind viene sottoposto a override, gli eventi OnDataBinding e OnDataBound vengono generati in modo non corretto.If DataBind is overridden, the OnDataBinding and OnDataBound events are raised out of order.

Quando viene generato un evento, il gestore dell'evento viene richiamato tramite un delegato.Raising an event invokes the event handler through a delegate. Per altre informazioni, vedere la gestione e generazione di eventi.For more information, see Handling and Raising Events.

Il metodo OnDataBound consente inoltre alle classi derivate di gestire l'evento senza associare un delegato.The OnDataBound method also allows derived classes to handle the event without attaching a delegate. È la tecnica consigliata per la gestione dell'evento in una classe derivata.This is the preferred technique for handling the event in a derived class.

Notes to Inheritors

Quando si esegue l'override di OnDataBound(EventArgs) in una classe derivata, assicurarsi di chiamare il metodo della classe base ' OnDataBound(EventArgs) in modo che i delegati registrati ricevano l'evento.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.

Applies to

See also