BaseDataBoundControl.RequiresDataBinding Vlastnost

Definice

Obor názvů:

System.Web.UI.WebControls

Sestavení:

System.Web.dll

Získá nebo nastaví hodnotu označující, zda DataBind() má být metoda volána.

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

Hodnota vlastnosti

Boolean

Vrácená hodnota je true , pokud se má metoda ovládacího prvku DataBind() vázaného na data volat před vykreslením ovládacího prvku. V opačném případě je falsehodnota .

Příklady

Následující příklad kódu ukazuje, jak RequiresDataBinding je vlastnost používána odvozenou třídou ovládacího prvku vázaného na data. Po načtení dat metodou GetData a svázání s ovládacím prvku s PerformDataBinding metodou RequiresDataBinding se vlastnost nastaví na false a MarkAsDataBound metoda se zavolá, aby se signalizovalo, že ovládací prvek dokončil vazbu a už tuto vlastnost během životního cyklu aktuální stránky nevyžaduje. Tento příklad kódu je součástí většího příkladu DataBoundControl pro třídu .

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

Poznámky

Pokud nastavíte RequiresDataBinding vlastnost na, true když ovládací prvek vázané na data již začal vykreslovat svůj výstup na stránku, aktuální požadavek HTTP není zpětné volání a používáte DataSourceID vlastnost k identifikaci ovládacího prvku zdroje dat, se kterým se má vytvořit vazba, DataBind zavolá se metoda okamžitě. V tomto případě RequiresDataBinding není vlastnost ve skutečnosti nastavená na truehodnotu .

Viz také

• DataBind()
• DataSourceID