将数据源绑定到被调用的服务器控件及其所有子控件。
命名空间:System.Web.UI
程序集:System.Web（在 system.web.dll 中）
Public Overridable Sub DataBind
Dim instance As Control
instance.DataBind
public virtual void DataBind ()
public:
virtual void DataBind ()
public function DataBind ()
使用此方法将数据从源绑定到服务器控件。此方法通常用在通过数据库查询检索数据集之后。
.gif) 注意 |
|---|
| 在服务器控件上调用该方法时，它会解析服务器控件及其所有子控件中的所有数据绑定表达式。 |
当创建自定义模板数据绑定控件时，通常重写此方法。有关更多信息，请参见 如何：创建模板化的 ASP.NET 用户控件。
有关将数据绑定到服务器控件的更多信息，请参见 数据绑定表达式语法。
下面的示例重写自定义 ASP.NET 服务器控件中的 DataBind 方法。它首先调用基 OnDataBinding 方法，然后使用 ControlCollection.Clear 方法删除所有子控件，并使用 ClearChildViewState 方法删除那些子控件的所有已保存的视图状态设置。最后，ChildControlsCreated 属性将设置为 true，并将指示控件用 TrackViewState 方法跟踪对新创建控件的视图状态所做的任何更改。这是将数据绑定到控件时常用的技术，用于确保新数据不会与以前调用 DataBind 方法时存储的数据发生冲突。
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
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 void DataBind()
{
super.OnDataBinding(EventArgs.Empty);
// Reset the control's state.
get_Controls().Clear();
// Check for HasChildViewState to avoid unnecessary calls to
// ClearChildViewState.
if (get_HasChildViewState()) {
ClearChildViewState();
}
set_ChildControlsCreated(true);
if (!(get_IsTrackingViewState())) {
TrackViewState();
}
} //DataBind
Windows 98、Windows 2000 SP4、Windows Server 2003、Windows XP Media Center Edition、Windows XP Professional x64 Edition、Windows XP SP2、Windows XP Starter Edition
.NET Framework 并不是对每个平台的所有版本都提供支持。有关受支持版本的列表，请参见系统要求。
.NET Framework
受以下版本支持：2.0、1.1、1.0