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

備註

使用這個方法，將資料從來源系結至伺服器控制項。 透過資料庫查詢擷取資料集之後，通常會使用這個方法。 大部分控制項都會自動執行資料系結，這表示您通常不需要明確呼叫這個方法。

當您建立自訂樣板化資料繫結控制項時，通常會覆寫這個方法。 如需詳細資訊，請參閱 How to： Create Templated ASP.NET User Controls and Developing Custom Data-Bound Web Server Controls。 在伺服器控制項上呼叫時，這個方法會解析伺服器控制項及其任何子控制項中的所有資料系結運算式。

另請參閱

適用於

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 方法。

方法 Control.DataBind() 會 Control.DataBind(Boolean) 叫用 raiseOnDataBinding 設定為 true 的方法。

注意

Control.DataBind(Boolean)呼叫 已設定 為 raiseOnDataBindingfalse 的 方法，會導致任何子控制項與 方法系結 Control.DataBind() 資料。

另請參閱

適用於