BaseDataBoundControl.OnDataBound(EventArgs) Méthode

Définition

Déclenche l’événement 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)

Paramètres

e
EventArgs

Objet EventArgs qui contient les données d’événement.An EventArgs object that contains the event data.

Exemples

L’exemple de code suivant montre comment la OnDataBound méthode est utilisée pour déclencher l' DataBound événement par une classe de contrôle liée aux données dérivée.The following code example demonstrates how the OnDataBound method is used to raise the DataBound event by a derived data-bound control class. Après l’utilisation GetData des PerformDataBinding méthodes et pour lier des données au contrôle, le contrôle lié aux données déclenche l' DataBound événement pour signaler que la liaison de données est terminée.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. Cet exemple de code fait partie d’un exemple plus complet fourni pour la DataBoundControl 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

Remarques

Cette méthode avertit un contrôle serveur que toute logique de liaison de données associée au contrôle est terminée.This method notifies a server control that any data binding logic associated with the control has completed.

Important

La DataBind méthode est sealed sur tous les contrôles dérivés de BaseDataBoundControl .The DataBind method is sealed on all controls derived from BaseDataBoundControl. Les contrôles liés aux données doivent substituer PerformDataBinding au lieu de la DataBind méthode pour lier des données.Data-bound controls should override PerformDataBinding instead of the DataBind method to bind data. Si DataBind est substitué, les OnDataBinding événements et OnDataBound sont déclenchés dans le désordre.If DataBind is overridden, the OnDataBinding and OnDataBound events are raised out of order.

Le déclenchement d'un événement appelle le gestionnaire des événements par l'intermédiaire d'un délégué.Raising an event invokes the event handler through a delegate. Pour plus d’informations, consultez gestion et déclenchement d’événements.For more information, see Handling and Raising Events.

La méthode OnDataBound permet également aux classes dérivées de gérer l'événement sans y attacher de délégué.The OnDataBound method also allows derived classes to handle the event without attaching a delegate. Il s'agit de la méthode recommandée pour gérer l'événement dans une classe dérivée.This is the preferred technique for handling the event in a derived class.

Notes pour les héritiers

Lors d' OnDataBound(EventArgs) une substitution dans une classe dérivée, veillez à appeler la méthode de la classe de base OnDataBound(EventArgs) afin que les délégués inscrits reçoivent l’événement.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.

S’applique à

Voir aussi