BaseDataBoundControl.OnDataBound(EventArgs) BaseDataBoundControl.OnDataBound(EventArgs) BaseDataBoundControl.OnDataBound(EventArgs) BaseDataBoundControl.OnDataBound(EventArgs) Method

Definizione

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)

Parametri

e
EventArgs EventArgs EventArgs EventArgs

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

Esempi

Nell'esempio di codice riportato di seguito OnDataBound viene illustrato come utilizzare il metodo DataBound per generare l'evento 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 GetData i PerformDataBinding metodi e per associare i dati al controllo, il controllo con associazione a dati DataBound genera l'evento 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 DataBoundControl per la classe.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 'PerformSelect

Commenti

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.

Importante

Il DataBind metodo è sealed su tutti i controlli BaseDataBoundControlderivati da.The DataBind method is sealed on all controls derived from BaseDataBoundControl. I controlli associati a dati devono PerformDataBinding eseguire l'override DataBind di anziché il metodo per associare i dati.Data-bound controls should override PerformDataBinding instead of the DataBind method to bind data. Se DataBind viene sottoposto a override OnDataBinding , OnDataBound gli eventi e non vengono generati in ordine.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.

Note per gli eredi

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

Si applica a

Vedi anche