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 Web 服务器控件。 在服务器控件上调用时,此方法解析服务器控件及其任何子控件中的所有数据绑定表达式。

另请参阅

适用于

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

如果引发 DataBinding 事件,则为 true;否则为 false

注解

Control.DataBind(Boolean)当自定义控件重写DataBind该方法并实现IDataItemContainer接口时,请在方案中使用该方法。 在此方案中,自定义控件调用Control.DataBind(Boolean)了设置为raiseOnDataBinding``false确保调用基类DataBind的方法的方法。

The Control.DataBind() method invokes the Control.DataBind(Boolean) method with raiseOnDataBinding set to true.

备注

Control.DataBind(Boolean)调用设置为raiseOnDataBinding使false任何子控件都与Control.DataBind()该方法绑定的方法。

另请参阅

适用于