共用方式為

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 刪除這些子控件的任何已儲存檢視狀態設定的方法。 最後，屬性會設定為 true ，ChildControlsCreated並指示控件使用 方法追蹤新建立控件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 網頁伺服器控制件。 在伺服器控制項上呼叫時，這個方法會解析伺服器控件及其任何子控件中的所有數據系結運算式。

另請參閱

適用於

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)叫用 設定為 true的方法raiseOnDataBinding。

注意

Control.DataBind(Boolean)呼叫 設定為 false 的方法raiseOnDataBinding會導致任何子控件系結至 Control.DataBind() 方法的數據。

另請參閱

適用於