BaseDataBoundControl.RequiresDataBinding Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает или задает значение, указывающее, следует ли 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
Значение свойства
Возвращаемое значение — если true метод элемента управления DataBind() с привязкой к данным должен вызываться перед отрисовки элемента управления; в противном случае значение равно false.
Примеры
В следующем примере кода показано, как RequiresDataBinding свойство используется производным классом управления с привязкой к данным. После получения данных методом GetData и привязки к элементу управления с PerformDataBinding помощью метода свойство устанавливается falseMarkAsDataBound и вызывается методом, чтобы сигнализировать о том, RequiresDataBinding что элемент управления завершил привязку и больше не требует этого свойства во время жизненного цикла текущей страницы. Этот пример кода является частью более крупного примера, предоставленного для 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
Комментарии
Если свойство RequiresDataBindingtrue задано, когда элемент управления с привязкой к данным уже начал отображать выходные данные на странице, текущий HTTP-запрос не является обратным вызовом, и вы используете DataSourceID свойство для идентификации элемента управления источниками данных для привязки, DataBind метод вызывается немедленно. В этом случае RequiresDataBinding свойство не задано true.