共用方式為


建立資料繫結 Web 組件控制項

更新:2007 年 11 月

藉由繼承自 WebPart 基底類別,可以將 Web 組件能力提供給一般資料繫結伺服器控制項。在 Web 組件應用程式中,使用者可以修改 (個人化) 伺服器控制項的行為和使用者介面 (UI),並將其設定儲存在長期儲存區內,以用於未來的瀏覽器工作階段 (Session)。使用者可以透過加入或移除控制項、編輯控制項的屬性和外觀、重新整理頁面配置、匯入或匯出控制項的設定,或甚至形成可讓控制項共用資料的連接,大幅度地變更頁面的外觀及操作。如需有關 Web 組件應用程式的詳細資訊,請參閱 ASP.NET Web 組件控制項中所列的主題。本主題會描述在 Web 組件應用程式中使用自訂、資料繫結 WebPart 控制項 (或任何伺服器控制項) 的必要條件,並摘要說明基底 WebPart 類別的某些成員,在建立自訂控制項時實作或覆寫這些成員通常會很有用。資料繫結 Web 組件控制項範例主題中提供覆寫和實作這些成員的範例。

使用 Web 組件控制項之必備的項目

沒有任何 Web 組件控制項可以在單獨執行時仍保有其 Web 組件功能。如果您在 Web 應用程式中執行 WebPart 控制項,但沒有 Web 組件應用程式之其他必備的項目,則該控制項會失去其 Web 組件功能,並當做一般的伺服器控制項來運作。下列清單說明在您可以使用具備 Web 組件功能的自訂 WebPart 控制項之前,必須已存在之必備的項目:

常被覆寫或使用的 WebPart 成員

雖然可以在 Web 組件應用程式中使用任何型別的伺服器控制項,但是建立自訂 WebPart 控制項有許多優點 (如需詳細資訊,請參閱在 Web 組件應用程式中使用 ASP.NET 伺服器控制項)。當繼承自 WebPart 基底類別時,沒有任何需要實作的成員。不過,您可能會想使用或覆寫某些常用的成員,這些成員在下表中摘要說明。如需實作為 WebPart 控制項之資料繫結伺服器控制項的完整範例,請參閱資料繫結 Web 組件控制項範例。下表會摘要說明一些常用的成員。

成員

說明

WebPart

這個建構函式的常見用法是設定一些屬性的預設值,這些屬性會決定 WebPart 控制項的外觀和行為,例如繼承自 Part 類別的屬性,或是如 AllowEditAllowLayoutChange 屬性等行為屬性。

行為屬性

包括類別的一些 Allow 屬性,例如 AllowCloseAllowConnectAllowEditAllowMinimizeAllowLayoutChangeAllowZoneChange。除了單純在建構函式中指派預設值給這些屬性外,開發人員還可以完整控制屬性,例如防止使用控制項的使用者或開發人員關閉控制項。

CreateChildControls

當繼承自 WebPart 類別時,需要提供自訂控制項的 UI。一個非常有效的執行方式是覆寫 CreateChildControls 方法,然後在這個方法中加入其他伺服器控制項,以組成自訂控制項的 UI。在加入這些控制項時,可能需要執行一些額外的工作,例如為控制項建立自訂事件處理常式,或將控制項繫結至資料來源。

呈現方法

您可能需要覆寫一般的呈現方法,例如 RenderControlRenderContents。在這些方法中,您可以完整覆寫呈現,或是先呼叫基底方法,然後修改呈現的某些方面。

Verbs

如果您建立了將與標準動作 (例如關閉和最小化) 一起顯示在控制項之動作功能表中的自訂 WebPartVerb 物件,則必須將這些物件加入至控制項的 Verbs 集合。

CreateEditorParts

如果您建立了自訂 EditorPart 控制項,若要讓使用者可以在控制項上編輯自訂屬性,必須藉由覆寫 CreateEditorParts 方法,使這些屬性與控制項產生關聯。如需範例,請參閱 IWebEditable 介面。

PersonalizableAttribute

當您在 WebPart 控制項中建立自訂屬性時,通常會希望使用者可以編輯和個人化這些屬性,如同使用標準 WebPart 控制項屬性一樣,以便可讓使用者儲存其設定。請將 Personalizable 中繼資料 (Metadata) 屬性 (Attribute),加入至使用者應可個人化的任何屬性 (Property)。

資料繫結 WebPart 控制項範例

如需示範如何建立繫結至 Northwind 資料庫的 GridView 控制項,以及將該控制項實作為 WebPart 控制項的完整程式碼範例,請參閱資料繫結 Web 組件控制項範例

請參閱

工作

逐步解說:建立 Web 組件頁面

概念

ASP.NET Web 組件概觀

參考

WebPart

其他資源

ASP.NET Web 組件控制項