BaseDataBoundControl 類別
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
作為控制項的基底類別，這些控制項是使用 ASP.NET 資料來源控制項繫結至資料。
public ref class BaseDataBoundControl abstract : System::Web::UI::WebControls::WebControlpublic abstract class BaseDataBoundControl : System.Web.UI.WebControls.WebControltype BaseDataBoundControl = class
inherit WebControlPublic MustInherit Class BaseDataBoundControl
Inherits WebControl- 繼承
- 衍生
備註
ASP.NET 支援控件架構，可讓 Web 伺服器控制項以一致的方式系結至數據。 系結至數據的 Web 伺服器控制件稱為數據綁定控件，以及有助於系結的類別稱為數據源控件。 設計為使用 ASP.NET 數據源控件的數據綁定控件衍生自 BaseDataBoundControl 控件類別，其定義基底數據綁定控件功能。
您可以使用隨附 ASP.NET 的數據綁定控件，包括 GridView、 DetailsView和 TreeView，來執行涉及顯示數據的大部分 Web 開發工作。 在這些控制項未提供所需功能的案例中，您可以從基底 DataBoundControl 和 HierarchicalDataBoundControl 類別繼承，以實作您自己的自定義數據源控件。
雖然任何支援 DataSource 和 DataSourceID 屬性和 方法的 DataBind 類別都是數據綁定控件，但大部分 ASP.NET 數據綁定控件都會擴充抽象 BaseDataBoundControl 和 DataBoundControl 類別。 值得注意的例外狀況包括 DataGrid、 Repeater和 DropDownList 控件。 如需數據系結的詳細資訊，請參閱 ASP.NET 數據存取內容對應。
建構函式
| BaseDataBoundControl() |
初始化 BaseDataBoundControl 類別的新執行個體。 |
屬性
| AccessKey |
取得或設定便捷鍵 (Access Key)，可讓您快速巡覽至 Web 伺服器控制項。 (繼承來源 WebControl) |
| Adapter |
針對控制項取得瀏覽器的特定配置器。 (繼承來源 Control) |
| AppRelativeTemplateSourceDirectory |
取得或設定包含了此控制項之 Page 或 UserControl 物件的相對應用程式虛擬目錄。 (繼承來源 Control) |
| Attributes |
取得任意屬性 (Attribute) 的集合 (只供呈現)，不與控制項上的屬性 (Property) 對應。 (繼承來源 WebControl) |
| BackColor |
取得或設定 Web 伺服器控制項的背景色彩。 (繼承來源 WebControl) |
| BindingContainer |
取得包含了此控制項之資料繫結的控制項。 (繼承來源 Control) |
| BorderColor |
取得或設定 Web 控制項的框線色彩。 (繼承來源 WebControl) |
| BorderStyle |
取得或設定 Web 伺服器控制項的框線樣式。 (繼承來源 WebControl) |
| BorderWidth |
取得或設定 Web 伺服器控制項的框線寬度。 (繼承來源 WebControl) |
| ChildControlsCreated |
取得值，指出是否已經建立伺服器控制項的子控制項。 (繼承來源 Control) |
| ClientID |
取得 ASP.NET 所產生之 HTML 標記的控制項識別碼。 (繼承來源 Control) |
| ClientIDMode |
取得或設定用來產生 ClientID 屬性值的演算法。 (繼承來源 Control) |
| ClientIDSeparator |
取得字元值，表示在 ClientID 屬性中所使用的分隔字元。 (繼承來源 Control) |
| Context |
取得與目前 Web 要求的伺服器控制項關聯的 HttpContext 物件。 (繼承來源 Control) |
| Controls |
取得 ControlCollection 物件，表示 UI 階層架構中指定之伺服器控制項的子控制項。 (繼承來源 Control) |
| ControlStyle |
取得 Web 伺服器控制項的樣式。 這個屬性主要由控制項開發人員使用。 (繼承來源 WebControl) |
| ControlStyleCreated |
取得值，指出 Style 物件是否已經為 ControlStyle 屬性建立。 這個屬性主要由控制項開發人員使用。 (繼承來源 WebControl) |
| CssClass |
取得或設定用戶端上 Web 伺服器控制項所呈現的階層式樣式表 (CSS)。 (繼承來源 WebControl) |
| DataItemContainer |
如果命名容器實作 IDataItemContainer，則取得命名容器的參考。 (繼承來源 Control) |
| DataKeysContainer |
如果命名容器實作 IDataKeysControl，則取得命名容器的參考。 (繼承來源 Control) |
| DataSource |
取得或設定資料繫結控制項從中擷取其資料項目清單的物件。 |
| DataSourceID |
取得或設定控制項的識別碼，資料繫結控制項會由此擷取其項目清單。 |
| DesignMode |
取得值，指出控制項是否正用於設計介面上。 (繼承來源 Control) |
| Enabled |
取得或設定值，指出 Web 伺服器控制項是否啟用。 (繼承來源 WebControl) |
| EnableTheming |
取得或設定值，指出佈景主題是否套用至此控制項。 (繼承來源 WebControl) |
| EnableViewState |
取得或設定值，該值表示伺服器控制項是否對要求的用戶端而言保持其檢視狀態，以及它包含的任何子控制項狀態。 (繼承來源 Control) |
| Events |
取得控制項事件處理常式委派 (Delegate) 的清單。 這個屬性是唯讀的。 (繼承來源 Control) |
| Font |
取得與 Web 伺服器控制項關聯的字型屬性。 (繼承來源 WebControl) |
| ForeColor |
取得或設定 Web 伺服器控制項的前景色彩 (通常是文字的色彩)。 (繼承來源 WebControl) |
| HasAttributes |
取得值，指出控制項是否已經設定屬性。 (繼承來源 WebControl) |
| HasChildViewState |
取得值，指出目前伺服器控制項的子控制項是否有任何已儲存的檢視狀態設定。 (繼承來源 Control) |
| Height |
取得或設定 Web 伺服器控制項的高度。 (繼承來源 WebControl) |
| ID |
取得或設定指派給伺服器控制項的程式設計識別項。 (繼承來源 Control) |
| IdSeparator |
取得用來分隔控制項識別項的字元。 (繼承來源 Control) |
| Initialized |
取得值，指出是否已初始化資料繫結控制項。 |
| IsBoundUsingDataSourceID |
取得值，指出是否已設定 DataSourceID 屬性。 |
| IsChildControlStateCleared |
取得值，指出這個控制項中所包含的控制項是否有控制項狀態。 (繼承來源 Control) |
| IsDataBindingAutomatic |
取得值，指出資料繫結是否為自動。 |
| IsEnabled |
取得值，指出是否啟用控制項。 (繼承來源 WebControl) |
| IsTrackingViewState |
取得值，指出伺服器控制項是否正在儲存檢視狀態的變更。 (繼承來源 Control) |
| IsUsingModelBinders |
在衍生類別中實作時，取得值，此值指出控制項是否正使用模型繫結器。 |
| IsViewStateEnabled |
取得值，指出這個控制項是否已啟用檢視狀態。 (繼承來源 Control) |
| LoadViewStateByID |
取得值，指出控制項是否依 ID (而不是索引) 參與載入其檢視狀態。 (繼承來源 Control) |
| NamingContainer |
取得伺服器控制項命名容器的參考，其建立唯一命名空間，在具有相同 ID 屬性值的伺服器控制項之間作區別。 (繼承來源 Control) |
| Page |
取得含有伺服器控制項的 Page 執行個體的參考。 (繼承來源 Control) |
| Parent |
在網頁控制階層架構中取得伺服器控制項之父控制項的參考。 (繼承來源 Control) |
| RenderingCompatibility |
取得值，這個值會指定將與呈現 HTML 相容的 ASP.NET 版本。 (繼承來源 Control) |
| RequiresDataBinding |
取得或設定值，指出是否應該呼叫 DataBind() 方法。 |
| Site |
當呈現在設計介面上時，取得裝載目前控制項之容器的資訊。 (繼承來源 Control) |
| SkinID |
取得或設定要套用至控制項的面板。 (繼承來源 WebControl) |
| Style |
取得文字屬性的集合，將呈現為 Web 伺服器控制項的外部標記上的樣式屬性。 (繼承來源 WebControl) |
| SupportsDisabledAttribute |
取得值，這個值表示當控制項的 |
| SupportsDisabledAttribute |
取得值，這個值表示當控制項的 |
| TabIndex |
取得或設定 Web 伺服器控制項的定位索引。 (繼承來源 WebControl) |
| TagKey |
取得對應至這個 Web 伺服器控制項的 HtmlTextWriterTag 值。 這個屬性主要由控制項開發人員使用。 (繼承來源 WebControl) |
| TagName |
取得控制項標記的名稱。 這個屬性主要由控制項開發人員使用。 (繼承來源 WebControl) |
| TemplateControl |
取得或設定包含了此控制項之樣板的參考。 (繼承來源 Control) |
| TemplateSourceDirectory |
取得包含目前伺服器控制項的 Page 或 UserControl 的虛擬目錄。 (繼承來源 Control) |
| ToolTip |
取得或設定當滑鼠指標停留在 Web 伺服器控制項時顯示的文字。 (繼承來源 WebControl) |
| UniqueID |
取得伺服器控制項唯一的、符合階層架構的識別項。 (繼承來源 Control) |
| ValidateRequestMode |
取得或設定值，指出控制項是否對來自瀏覽器的用戶端輸入檢查潛在的危險值。 (繼承來源 Control) |
| ViewState |
取得狀態資訊的字典，允許您在相同網頁的多個要求之間，儲存和還原伺服器控制項的檢視狀態。 (繼承來源 Control) |
| ViewStateIgnoresCase |
取得值，指出 StateBag 物件是否不區分大小寫。 (繼承來源 Control) |
| ViewStateMode |
取得或設定這個控制項的檢視狀態模式。 (繼承來源 Control) |
| Visible |
取得或設定值，指出伺服器控制項是否會轉譯為頁面上的 UI。 (繼承來源 Control) |
| Width |
取得或設定 Web 伺服器控制項的寬度。 (繼承來源 WebControl) |
方法
| AddAttributesToRender(HtmlTextWriter) |
將需要呈現的 HTML 屬性和樣式加入至指定的 HtmlTextWriterTag 中。 這個方法主要由控制項開發人員使用。 (繼承來源 WebControl) |
| AddedControl(Control, Int32) |
在子控制項加入 Control 物件的 Controls 集合後呼叫。 (繼承來源 Control) |
| AddParsedSubObject(Object) |
通知伺服器控制項，XML 或 HTML 項目已剖析，並將項目加入伺服器控制項的 ControlCollection 物件中。 (繼承來源 Control) |
| ApplyStyle(Style) |
將指定樣式的任何非空白項目加入到 Web 控制項中，覆寫控制項的任何現有的樣式項目。 這個方法主要由控制項開發人員使用。 (繼承來源 WebControl) |
| ApplyStyleSheetSkin(Page) |
將頁面樣式表中所定義的樣式屬性套用至控制項。 (繼承來源 Control) |
| BeginRenderTracing(TextWriter, Object) |
開始進行轉譯資料的設計階段追蹤。 (繼承來源 Control) |
| BuildProfileTree(String, Boolean) |
收集伺服器控制項的相關資訊，並在頁面啟用追蹤時將此資訊傳遞至 Trace 屬性以顯示之。 (繼承來源 Control) |
| ClearCachedClientID() |
將快取的 ClientID 值設定為 |
| ClearChildControlState() |
刪除伺服器控制項之子控制項的控制項狀態資訊。 (繼承來源 Control) |
| ClearChildState() |
刪除所有伺服器控制項之子控制項的檢視狀態和控制項狀態資訊。 (繼承來源 Control) |
| ClearChildViewState() |
刪除所有伺服器控制項之子控制項的檢視狀態資訊。 (繼承來源 Control) |
| ClearEffectiveClientIDMode() |
將目前的控制項執行個體和任何子控制項的 ClientIDMode 屬性設定為 Inherit。 (繼承來源 Control) |
| ConfirmInitState() |
設定資料繫結控制項之初始化的狀態。 |
| CopyBaseAttributes(WebControl) |
將不被 Style 物件封裝的屬性從指定的 Web 伺服器控制項複製到呼叫這個方法的 Web 伺服器控制項上。 這個方法主要由控制項開發人員使用。 (繼承來源 WebControl) |
| CreateChildControls() |
由 ASP.NET 網頁架構呼叫，通知使用組合實作的伺服器控制項來建立所包含的任何子控制項，以準備回傳或呈現。 (繼承來源 Control) |
| CreateControlCollection() |
建立新的 ControlCollection 物件來保存伺服器控制項的子控制項 (常值和伺服器)。 (繼承來源 Control) |
| CreateControlStyle() |
建立樣式物件，這個物件被 WebControl 類別內部使用，以實作所有的樣式相關屬性。 這個方法主要由控制項開發人員使用。 (繼承來源 WebControl) |
| DataBind() |
將資料來源繫結至所叫用的伺服器控制項及其所有子控制項。 |
| DataBind(Boolean) |
使用會引發 DataBinding 事件的選項，繫結資料來源至叫用的伺服器控制項及其所有子控制項。 (繼承來源 Control) |
| DataBindChildren() |
繫結資料來源至伺服器控制項的子控制項。 (繼承來源 Control) |
| Dispose() |
啟用伺服器控制項，在它從記憶體釋放之前執行最後清除。 (繼承來源 Control) |
| EndRenderTracing(TextWriter, Object) |
結束轉譯資料的設計階段追蹤。 (繼承來源 Control) |
| EnsureChildControls() |
判斷伺服器控制項是否包含子控制項。 如果不包含，則建立子控制項。 (繼承來源 Control) |
| EnsureDataBound() |
如果設定了 DataBind() 屬性且資料繫結控制項標記為需要繫結，則會呼叫 DataSourceID 方法。 |
| EnsureID() |
為尚未指定識別項的控制項，建立識別項。 (繼承來源 Control) |
| Equals(Object) |
判斷指定的物件是否等於目前的物件。 (繼承來源 Object) |
| FindControl(String) |
在目前命名容器搜尋具有指定 |
| FindControl(String, Int32) |
使用指定的 |
| Focus() |
設定控制項的輸入焦點。 (繼承來源 Control) |
| GetDesignModeState() |
取得控制項的設計階段資料。 (繼承來源 Control) |
| GetHashCode() |
做為預設雜湊函式。 (繼承來源 Object) |
| GetRouteUrl(Object) |
取得會對應於一組路由參數的 URL。 (繼承來源 Control) |
| GetRouteUrl(RouteValueDictionary) |
取得會對應於一組路由參數的 URL。 (繼承來源 Control) |
| GetRouteUrl(String, Object) |
取得 URL，此 URL 對應於一組路由參數及一個路由名稱。 (繼承來源 Control) |
| GetRouteUrl(String, RouteValueDictionary) |
取得 URL，此 URL 對應於一組路由參數及一個路由名稱。 (繼承來源 Control) |
| GetType() |
取得目前執行個體的 Type。 (繼承來源 Object) |
| GetUniqueIDRelativeTo(Control) |
傳回指定之控制項 UniqueID 屬性的前置部分。 (繼承來源 Control) |
| HasControls() |
判斷伺服器控制項是否包含任何子控制項。 (繼承來源 Control) |
| HasEvents() |
傳回值，指出控制項或任何子控制項的事件是否已註冊。 (繼承來源 Control) |
| IsLiteralContent() |
判斷伺服器控制項是否只儲存常值內容。 (繼承來源 Control) |
| LoadControlState(Object) |
從 SaveControlState() 方法所儲存的上一頁要求中，還原控制項狀態資訊。 (繼承來源 Control) |
| LoadViewState(Object) |
從上一個使用 SaveViewState() 方法儲存的要求中，還原檢視狀態資訊。 (繼承來源 WebControl) |
| MapPathSecure(String) |
擷取虛擬絕對路徑或相對路徑所對應至的實體路徑。 (繼承來源 Control) |
| MemberwiseClone() |
建立目前 Object 的淺層複製。 (繼承來源 Object) |
| MergeStyle(Style) |
將指定樣式的任何非空白項目複製到 Web 控制項，但不覆寫控制項的任何現有樣式項目。 這個方法主要由控制項開發人員使用。 (繼承來源 WebControl) |
| OnBubbleEvent(Object, EventArgs) |
決定伺服器控制項的事件是否要在頁面的 UI 伺服器控制項階層架構中向上傳遞。 (繼承來源 Control) |
| OnDataBinding(EventArgs) |
引發 DataBinding 事件。 (繼承來源 Control) |
| OnDataBound(EventArgs) |
引發 DataBound 事件。 |
| OnDataPropertyChanged() |
其中一個基底資料來源識別屬性變更之後，將資料繫結控制項重新繫結至其資料。 |
| OnInit(EventArgs) |
處理 Init 事件。 |
| OnLoad(EventArgs) |
引發 Load 事件。 (繼承來源 Control) |
| OnPagePreLoad(Object, EventArgs) |
設定資料繫結控制項在載入控制項之前的初始化狀態。 |
| OnPreRender(EventArgs) |
處理 PreRender 事件。 |
| OnUnload(EventArgs) |
引發 Unload 事件。 (繼承來源 Control) |
| OpenFile(String) |
取得用來讀取檔案的 Stream。 (繼承來源 Control) |
| PerformSelect() |
在衍生類別中覆寫時，控制如何擷取資料以及如何將資料繫結至控制項。 |
| RaiseBubbleEvent(Object, EventArgs) |
指派事件的任何來源和它的資訊至控制項的父控制項。 (繼承來源 Control) |
| RemovedControl(Control) |
從 Control 物件的 Controls 集合中移除子控制項之後呼叫。 (繼承來源 Control) |
| Render(HtmlTextWriter) |
將控制項呈現在指定的 HTML 寫入器中。 (繼承來源 WebControl) |
| RenderBeginTag(HtmlTextWriter) |
將控制項的 HTML 開頭標記呈現在指定的寫入器中。 這個方法主要由控制項開發人員使用。 (繼承來源 WebControl) |
| RenderChildren(HtmlTextWriter) |
將伺服器控制項子系的內容輸出至提供的 HtmlTextWriter 物件，再由這個物件在用戶端上寫入要轉譯的內容。 (繼承來源 Control) |
| RenderContents(HtmlTextWriter) |
將控制項的內容呈現在指定的寫入器。 這個方法主要由控制項開發人員使用。 (繼承來源 WebControl) |
| RenderControl(HtmlTextWriter) |
將伺服器控制項內容輸出至提供的 HtmlTextWriter 物件，並在啟用追蹤時儲存控制項的追蹤資訊。 (繼承來源 Control) |
| RenderControl(HtmlTextWriter, ControlAdapter) |
使用提供的 HtmlTextWriter 物件，輸出伺服器控制項內容至提供的 ControlAdapter 物件。 (繼承來源 Control) |
| RenderEndTag(HtmlTextWriter) |
將控制項的 HTML 結尾標記呈現至指定的寫入器。 這個方法主要由控制項開發人員使用。 (繼承來源 WebControl) |
| ResolveAdapter() |
取得負責呈現指定之控制項的控制項配置器。 (繼承來源 Control) |
| ResolveClientUrl(String) |
取得瀏覽器可使用的 URL。 (繼承來源 Control) |
| ResolveUrl(String) |
將 URL 轉換為要求用戶端可使用的 URL。 (繼承來源 Control) |
| SaveControlState() |
儲存頁面回傳至伺服器以來，所發生的任何伺服器控制項狀態變更。 (繼承來源 Control) |
| SaveViewState() |
儲存叫用 TrackViewState() 方法後已修改的任何狀態。 (繼承來源 WebControl) |
| SetDesignModeState(IDictionary) |
設定控制項的設計階段資料。 (繼承來源 Control) |
| SetRenderMethodDelegate(RenderMethod) |
指定事件處理常式委派，以呈現伺服器控制項及其內容至其父控制項。 (繼承來源 Control) |
| SetTraceData(Object, Object) |
使用追蹤資料機碼和追蹤資料值，設定設計階段期間追蹤呈現資料的追蹤資料。 (繼承來源 Control) |
| SetTraceData(Object, Object, Object) |
使用追蹤的物體、追蹤資料機碼和追蹤資料值，設定設計階段期間追蹤呈現資料的追蹤資料。 (繼承來源 Control) |
| ToString() |
傳回代表目前物件的字串。 (繼承來源 Object) |
| TrackViewState() |
讓控制項追蹤其檢視狀態的變更，以便將這些變更儲存在物件的 ViewState 屬性中。 (繼承來源 WebControl) |
| ValidateDataSource(Object) |
在衍生類別中覆寫時，驗證資料繫結控制項繫結的物件是它可以使用的物件。 |
事件
| DataBinding |
發生於伺服器控制項繫結至資料來源時。 (繼承來源 Control) |
| DataBound |
在伺服器控制項繫結至資料來源之後發生。 |
| Disposed |
發生於伺服器控制項從記憶體釋放時，這是在要求 ASP.NET 網頁時，伺服器控制項生命週期的最後階段。 (繼承來源 Control) |
| Init |
發生於初始化伺服器控制項時，是其生命週期中的第一個步驟。 (繼承來源 Control) |
| Load |
發生於載入伺服器控制項至 Page 物件時。 (繼承來源 Control) |
| PreRender |
在 Control 物件載入之後但在呈現之前發生。 (繼承來源 Control) |
| Unload |
發生於伺服器控制項從記憶體卸載時。 (繼承來源 Control) |
明確介面實作
擴充方法
| EnablePersistedSelection(BaseDataBoundControl) |
已淘汰.
啟用要保存於資料控制項中且支援選取和分頁的選項。 |
| FindDataSourceControl(Control) |
傳回與指定之控制項的資料控制項相關聯的資料來源。 |
| FindFieldTemplate(Control, String) |
傳回在指定之控制項的命名容器中所指定資料行的欄位樣板。 |
| FindMetaTable(Control) |
傳回包含資料控制項的中繼資料表物件。 |
