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() вызывает метод с raiseOnDataBinding значением Control.DataBind(Boolean)true.

Примечание

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

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

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