Control.DataBind Метод

Определение

Привязывает источник данных к вызываемому серверному элементу управления и всем его дочерним элементам управления.

Перегрузки

DataBind()

Привязывает источник данных к вызываемому серверному элементу управления и всем его дочерним элементам управления.

DataBind(Boolean)

Привязывает источник данных к вызванному серверному элементу управления и всем его дочерними элементами управления с возможностью вызова события DataBinding.

DataBind()

Привязывает источник данных к вызываемому серверному элементу управления и всем его дочерним элементам управления.

public:
 virtual void DataBind();
public virtual void DataBind ();
abstract member DataBind : unit -> unit
override this.DataBind : unit -> unit
Public Overridable Sub DataBind ()

Примеры

В следующем примере метод переопределяется DataBind в пользовательском серверном элементе управления ASP.NET. Он начинается с вызова базового OnDataBinding метода, а затем использует ControlCollection.Clear метод для удаления всех дочерних элементов управления и ClearChildViewState метода для удаления всех сохраненных параметров состояния представления для этих дочерних элементов управления. Наконец, свойству true присваивается значение, ChildControlsCreated и элемент управления предписывается отслеживать любые изменения состояния представления вновь созданных элементов управления с 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

Комментарии

Используйте этот метод для привязки данных из источника к серверной системе управления. Этот метод обычно используется после получения набора данных с помощью запроса к базе данных. Большинство элементов управления выполняют привязку данных автоматически, что означает, что обычно не требуется явно вызывать этот метод.

Этот метод обычно переопределяется при создании пользовательского элемента управления с привязкой к данным шаблонов. Дополнительные сведения см. в разделе "How to: Create Templated ASP.NET User Controls and Developing Custom Data-Bound Web Server Controls". При вызове серверного элемента управления этот метод разрешает все выражения привязки данных в серверном элементе управления и в любом из его дочерних элементов управления.

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

Применяется к

DataBind(Boolean)

Привязывает источник данных к вызванному серверному элементу управления и всем его дочерними элементами управления с возможностью вызова события DataBinding.

protected:
 virtual void DataBind(bool raiseOnDataBinding);
protected virtual void DataBind (bool raiseOnDataBinding);
abstract member DataBind : bool -> unit
override this.DataBind : bool -> unit
Protected 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.

Примечание

Вызов метода с наборомControl.DataBind(Boolean), чтобы false все дочерние элементы управления были привязаны к данным с методомControl.DataBind().raiseOnDataBinding

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

Применяется к