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。 在伺服器控制項上呼叫時,這個方法會解析伺服器控制項及其任何子控制項中的所有資料系結運算式。
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)
Control.DataBind(Boolean)當您的自訂控制項覆寫 DataBind 方法並實 IDataItemContainer 作 介面時,請在案例中使用 方法。 在此案例中,自訂控制項會 Control.DataBind(Boolean) 呼叫 方法,並將 raiseOnDataBinding
設為 false
,以確保呼叫基類的 DataBind 方法。
方法 Control.DataBind() 會 Control.DataBind(Boolean) 叫用 raiseOnDataBinding
設定為 true
的方法。
Control.DataBind(Boolean)呼叫 已設定 為 raiseOnDataBinding
false
的 方法,會導致任何子控制項與 方法系結 Control.DataBind() 資料。