BaseDataBoundControl.OnDataBound(EventArgs) Méthode

Définition

Espace de noms:

System.Web.UI.WebControls

Assembly:

System.Web.dll

Déclenche l’événement DataBound.

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.

Exemples

L’exemple de code suivant montre comment la OnDataBound méthode est utilisée pour déclencher l’événement DataBound par une classe de contrôle liée aux données dérivée. Après avoir utilisé les GetData méthodes et PerformDataBinding pour lier des données au contrôle, le contrôle lié aux données déclenche l’événement DataBound pour signaler que la liaison de données est terminée. Cet exemple de code fait partie d’un exemple plus grand fourni pour la DataBoundControl classe .

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.

Important

La DataBind méthode est scellée sur tous les contrôles dérivés de BaseDataBoundControl. Les contrôles liés aux données doivent remplacer PerformDataBinding la DataBind méthode de liaison des données. Si DataBind est remplacé, les OnDataBinding événements et OnDataBound sont déclenchés dans le désordre.

Le déclenchement d'un événement appelle le gestionnaire des événements par l'intermédiaire d'un délégué. Pour plus d’informations, consultez gestion et déclenchement d’événements.

La méthode OnDataBound permet également aux classes dérivées de gérer l'événement sans y attacher de délégué. Il s'agit de la méthode recommandée pour gérer l'événement dans une classe dérivée.

Notes pour les héritiers

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

Voir aussi

• OnDataBinding(EventArgs)