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.ClearClearChildViewState 方法删除这些子控件的任何已保存视图状态设置。 最后, 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)设置为 falseraiseOnDataBinding 方法,以确保基类的 DataBind 方法得到调用。

方法 Control.DataBind() 调用 方法, Control.DataBind(Boolean) 并将 raiseOnDataBinding 设置为 true

注意

Control.DataBind(Boolean)调用 设置为 false 的 方法raiseOnDataBinding会导致任何子控件与 方法绑定Control.DataBind()数据。

另请参阅

适用于