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 чтобы удалить все сохраненные параметры состояния представления для этих дочерних элементов управления. Наконец, 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. При вызове для серверного элемента управления этот метод разрешает все выражения привязки данных в серверном элементе управления и в любом из его дочерних элементов управления.

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

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

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) метода с параметром raiseOnDataBinding Set равным false приводит к тому, что все дочерние элементы управления будут привязаны к данным с помощью Control.DataBind() метода.

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

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