通过

Control.DataBind 方法

  • 参考

定义

命名空间:
System.Web.UI
程序集:
System.Web.dll

将数据源绑定到调用的服务器控件及其所有子控件。

重载

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) 设置为 false 的方法raiseOnDataBinding，以确保调用基类DataBind的方法。

方法Control.DataBind()调用 Control.DataBind(Boolean) 设置为 true的 raiseOnDataBinding 方法。

注意

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

另请参阅

适用于