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 méthodes et GetData les méthodes pour lier des PerformDataBinding données au contrôle, le contrôle lié aux données déclenche l’événement pour signaler que la DataBound 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 être substitué PerformDataBinding au lieu de la DataBind méthode pour lier des données. En DataBind cas de substitution, les OnDataBinding événements sont OnDataBound déclenchés hors de l’ordre.

Le déclenchement d’un événement appelle le gestionnaire d’événements par le biais d’un délégué. Pour plus d’informations, consultez Gestion et déclenchement d’événements.

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

Notes pour les héritiers

En cas de 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.

S’applique à

Voir aussi