Partager via


BaseDataBoundControl.RequiresDataBinding Propriété

Définition

Obtient ou définit une valeur indiquant si la méthode DataBind() doit être appelée.

protected:
 property bool RequiresDataBinding { bool get(); void set(bool value); };
protected bool RequiresDataBinding { get; set; }
member this.RequiresDataBinding : bool with get, set
Protected Property RequiresDataBinding As Boolean

Valeur de propriété

Boolean

La valeur retournée est true si la méthode du DataBind() contrôle lié aux données doit être appelée avant le rendu du contrôle ; sinon, la valeur est false.

Exemples

L’exemple de code suivant montre comment la RequiresDataBinding propriété est utilisée par une classe de contrôle dérivée liée aux données. Une fois que les données sont récupérées par la GetData méthode et liées au contrôle avec la PerformDataBinding méthode, la RequiresDataBinding propriété est définie false et la MarkAsDataBound méthode est appelée pour signaler que le contrôle a terminé la liaison et ne nécessite plus cette propriété pendant le cycle de vie de la page active. 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

Si vous définissez la RequiresDataBinding propriété true sur laquelle le contrôle lié aux données a déjà commencé à afficher sa sortie sur la page, la requête HTTP actuelle n’est pas un rappel et vous utilisez la DataSourceID propriété pour identifier le contrôle de source de données à lier, la DataBind méthode est appelée immédiatement. Dans ce cas, la RequiresDataBinding propriété n’est pas réellement définie truesur .

S’applique à

Voir aussi