Control.DataBind Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Привязывает источник данных к вызываемой серверной системе управления и всем дочерним элементам управления.
Перегрузки
| Имя | Описание |
|---|---|
| DataBind() |
Привязывает источник данных к вызываемой серверной системе управления и всем дочерним элементам управления. |
| DataBind(Boolean) |
Привязывает источник данных к вызываемой серверной системе управления и всем его дочерним элементам управления с возможностью вызвать DataBinding событие. |
DataBind()
Привязывает источник данных к вызываемой серверной системе управления и всем дочерним элементам управления.
public:
virtual void DataBind();public virtual void DataBind();abstract member DataBind : unit -> unit
override this.DataBind : unit -> unitPublic Overridable Sub DataBind ()Примеры
В следующем примере метод переопределяется DataBind в пользовательском элементе управления ASP.NET сервера. Он начинается с вызова базового OnDataBinding метода, а затем использует ControlCollection.Clear метод для удаления всех дочерних элементов управления и ClearChildViewState метода для удаления всех сохраненных параметров состояния представления для этих дочерних элементов управления. Наконец, ChildControlsCreated свойству присвоено true значение, и элемент управления предписывается отслеживать изменения состояния представления только что созданных элементов управления с TrackViewState помощью метода. Это распространенный способ привязки данных к элементу управления, чтобы гарантировать, что новые данные не конфликтуют с данными, хранящимися из предыдущего DataBind вызова метода.
public override void DataBind()
{
base.OnDataBinding(EventArgs.Empty);
// Reset the control's state.
Controls.Clear();
// Check for HasChildViewState to avoid unnecessary calls to ClearChildViewState.
if (HasChildViewState)
ClearChildViewState();
ChildControlsCreated = true;
if (!IsTrackingViewState)
TrackViewState();
}
Public Overrides Sub DataBind()
MyBase.OnDataBinding(EventArgs.Empty)
' Reset the control's state.
Controls.Clear()
' Check for HasChildViewState to avoid unnecessary calls to ClearChildViewState.
If HasChildViewState Then
ClearChildViewState()
End If
ChildControlsCreated = True
If Not IsTrackingViewState Then
TrackViewState()
End If
End Sub
Комментарии
Используйте этот метод для привязки данных из источника к элементу управления сервером. Этот метод обычно используется после получения набора данных с помощью запроса базы данных. Большинство элементов управления выполняют привязку данных автоматически, что означает, что обычно не требуется явно вызывать этот метод.
Этот метод обычно переопределяется при создании пользовательского элемента управления с привязкой к данным шаблонов. Дополнительные сведения см. в статье "Практическое руководство. Создание шаблонных ASP.NET пользовательских элементов управления и разработка пользовательских Data-Bound веб-серверных элементов управления. При вызове на серверном элементе управления этот метод разрешает все выражения привязки данных в серверном элементе управления и в любом из дочерних элементов управления.
См. также раздел
- OnDataBinding(EventArgs)
- DataBinding
- DataBindChildren()
- Разработка пользовательских элементов управления ASP.NET сервера
- Обзор жизненного цикла страницы ASP.NET
Применяется к
DataBind(Boolean)
Привязывает источник данных к вызываемой серверной системе управления и всем его дочерним элементам управления с возможностью вызвать DataBinding событие.
protected:
virtual void DataBind(bool raiseOnDataBinding);protected virtual void DataBind(bool raiseOnDataBinding);abstract member DataBind : bool -> unit
override this.DataBind : bool -> unitProtected Overridable Sub DataBind (raiseOnDataBinding As Boolean)Параметры
- raiseOnDataBinding
- Boolean
true Значение DataBinding , falseесли событие вызывается; в противном случае .
Комментарии
Control.DataBind(Boolean) Используйте метод в сценарии, когда пользовательский элемент управления переопределяет DataBind метод и реализует IDataItemContainer интерфейс. В этом сценарии пользовательский элемент управления вызывает Control.DataBind(Boolean) метод с raiseOnDataBinding набором, чтобы false убедиться, что метод базового класса DataBind вызывается.
Метод Control.DataBind() вызывает метод с заданным Control.DataBind(Boolean)raiseOnDataBinding значением true.
Замечание
Вызов метода с raiseOnDataBinding набором, чтобы false все дочерние Control.DataBind(Boolean) элементы управления были привязаны к методуControl.DataBind().
