BaseDataBoundControl.RequiresDataBinding Свойство

Определение

Пространство имен:

System.Web.UI.WebControls

Сборка:

System.Web.dll

Получает или задает значение, указывающее, должен ли вызываться метод DataBind().

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

Значение свойства

Boolean

Возвращаемое значение равно , true если метод элемента управления DataBind() с привязкой к данным должен быть вызван до отрисовки элемента управления; в противном случае значение равно false.

Примеры

В следующем примере кода показано, как RequiresDataBinding свойство используется производным классом элемента управления с привязкой к данным. После того как данные извлекаются методом GetData и привязаны к элементу управления с PerformDataBinding помощью метода , свойству RequiresDataBinding присваивается значение false и MarkAsDataBound вызывается метод , чтобы сигнализировать о том, что элемент управления завершил привязку и больше не требует этого свойства в течение жизненного цикла текущей страницы. Этот пример входит в состав более крупного примера использования класса DataBoundControl.

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

Комментарии

Если присвоить свойству RequiresDataBinding значение true , когда элемент управления с привязкой к данным уже начал отображать свои выходные данные на странице, текущий HTTP-запрос не является обратным вызовом и вы используете DataSourceID свойство для идентификации элемента управления источником данных для привязки DataBind , метод вызывается немедленно. В этом случае RequiresDataBinding для свойства фактически не задано значение true.

См. также раздел

• DataBind()
• DataSourceID